Ajouter des graphiques et des tableaux à un tableau de bord personnalisé

Ce document explique comment ajouter des graphiques, des tableaux, des jauges et des tableaux de données à un tableau de bord personnalisé à l'aide de la console Google Cloud. Vous pouvez afficher des données métriques sur un intervalle de temps en ajoutant un graphique en courbes, un graphique en aires empilées, un graphique à barres ou un graphique de carte de densité. Si vous ne vous intéressez qu'aux mesures les plus récentes, ajoutez un tableau, un graphique en secteurs, une jauge ou un tableau de données. Les jauges et les tableaux de données changent de couleur en fonction de la comparaison de la valeur la plus récente avec les seuils d'avertissement et de danger.

Les visualisations que vous pouvez ajouter aux tableaux de bord sont collectivement appelées widgets. Pour obtenir des informations générales sur les différents types de widgets, consultez la page Présentation des tableaux de bord.

Les graphiques, les tableaux, les jauges et les tableaux de données des tableaux de bord personnalisés peuvent afficher n'importe quel type de métrique ayant une valeur numérique ou de distribution, y compris des métriques définies par l'utilisateur et des métriques basées sur les journaux. Les graphiques ne peuvent pas représenter les données de type chaîne sous forme de graphique.

Ce document explique comment ajouter des graphiques, des tableaux, des jauges et des tableaux de données à un tableau de bord personnalisé qui affiche des données de séries temporelles. Pour savoir comment ajouter d'autres types de widgets à vos tableaux de bord, consultez les documents suivants:

Pour plus d'informations sur l'API Cloud Monitoring, consultez la page Gérer des tableaux de bord à l'aide d'API.

Avant de commencer

  • Pour obtenir les autorisations nécessaires pour créer et modifier des tableaux de bord personnalisés à l'aide de la console Google Cloud, demandez à votre administrateur de vous accorder le rôle IAM Éditeur Monitoring (roles/monitoring.editor) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

    Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

    Pour en savoir plus sur les rôles, consultez la section Contrôler les accès avec Identity and Access Management.

  • Un tableau de bord peut contenir jusqu'à 40 widgets simultanément.

  • Pour ajouter un widget à un tableau de bord, vous pouvez sélectionner la visualisation, puis configurer le widget, ou sélectionner d'abord le type de données, puis configurer la visualisation.

    Par exemple, pour ajouter un tableau qui affiche l'utilisation du processeur de vos instances de VM à un tableau de bord, vous pouvez effectuer l'une des opérations suivantes:

    • Sélectionnez le widget Table, puis configurez-le pour afficher l'utilisation du processeur de vos instances de VM.
    • Sélectionnez le type de données Métrique, configurez le widget pour afficher l'utilisation du processeur de vos instances de VM, puis définissez le type de widget sur Table (Tableau).

    Les instructions de cette page supposent que vous sélectionnez d'abord le type de données, puis configurez la manière dont elles sont affichées.

Ajouter des graphiques et des tableaux à un tableau de bord

Cette section explique comment configurer des graphiques et des tableaux à l'aide de la console Google Cloud:

  • Les graphiques affichent les données sur une période donnée. Quatre styles sont disponibles : En courbes, En aires empilées, En barres empilées et Carte de densité. Un même graphique peut afficher plusieurs types de métriques. Par exemple, vous pouvez configurer un graphique pour afficher les octets de disque lus à partir de vos instances et les octets de disque écrits sur vos instances.

    Une fois un graphique configuré, vous pouvez modifier son type de widget. Pour savoir pourquoi vous pouvez sélectionner un style spécifique, consultez la section Graphiques qui affichent les données au fil du temps.

    Pour en savoir plus sur l'utilisation de l'API Cloud Monitoring pour configurer un graphique, consultez la section Tableau de bord avec un widget XyChart.

  • Les tableaux contiennent une ligne pour chaque combinaison de valeurs de libellé. Lorsque les tableaux affichent des données de plusieurs types de métriques, chaque ligne contient un résultat de toutes les requêtes, lorsque cette fusion est possible.

    Il existe deux styles de tableaux. Le widget Table affiche une valeur numérique telle que "25%". Le widget Top List (Meilleurs résultats) affiche à la fois la valeur et un indicateur visuel de la valeur par rapport à la plage de valeurs possibles.

    Vous pouvez modifier le style entre les tableaux et les graphiques, configurer les noms des colonnes du tableau et ajouter des seuils qui changent la couleur des cellules du tableau. Pour en savoir plus et obtenir un exemple, consultez la section Afficher des données sous forme de tableau dans un tableau de bord.

    Pour en savoir plus sur l'utilisation de l'API Cloud Monitoring pour configurer un tableau, consultez la section Tableau de bord avec un widget TimeSeriesTable.

Pour ajouter un graphique ou un tableau à un tableau de bord, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page Tableaux de bord .

    Accéder à la page Tableaux de bord

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  2. Effectuez l'une des opérations suivantes :

    • Pour créer un nouveau tableau de bord, sélectionnez Créer un tableau de bord.
    • Pour mettre à jour un tableau de bord existant, recherchez le tableau de bord dans la liste de tous les tableaux de bord, puis sélectionnez son nom.

  3. Dans la barre d'outils, cliquez sur  Ajouter un widget.

  4. Dans la boîte de dialogue Ajouter un widget, sélectionnez  Métrique.

  5. Spécifiez les données à afficher dans le graphique. Vous pouvez utiliser une interface basée sur des menus, le langage MQL (Monitoring Query Language), PromQL ou saisir un filtre de surveillance:

    1. Sélectionnez les données de séries temporelles que vous souhaitez afficher :

      1. Dans l'élément Métrique, développez le menu Sélectionner une métrique.

        Le menu Sélectionner une métrique contient des fonctionnalités qui vous aident à trouver les types de métriques disponibles:

        • Pour rechercher un type de métrique spécifique, utilisez la barre de filtre . Par exemple, si vous saisissez util, le menu ne répertorie que les entrées incluant util. Les entrées s'affichent lorsqu'elles réussissent un test "contient" non sensible à la casse.

        • Pour afficher tous les types de métriques, même ceux sans données, cliquez sur Active (Actif). Par défaut, les menus n'affichent que les types de métriques associés à des données.

        Par exemple, vous pouvez faire les choix suivants:

        1. Dans le menu Ressources actives, sélectionnez Instance de VM.
        2. Dans le menu Catégories de métriques actives, sélectionnez uptime_check.
        3. Dans le menu Métriques actives, sélectionnez Latence des requêtes.
        4. Cliquez sur Appliquer.

      2. Facultatif: Pour spécifier un sous-ensemble de données à afficher, dans l'élément Filtre, sélectionnez Ajouter un filtre, puis renseignez la boîte de dialogue. Par exemple, vous pouvez afficher les données d'une zone en appliquant un filtre. Vous pouvez ajouter plusieurs filtres. Pour en savoir plus, consultez la page Filtrer les données représentées graphiquement.

      Pour en savoir plus, consultez la section Sélectionner les données à représenter sous forme de graphique.

    2. Combiner et aligner des séries temporelles:

      • Pour afficher toutes les séries temporelles, dans l'élément Agrégation, définissez le premier menu sur Non agrégé et le second menu sur Aucun.

      • Pour combiner des séries temporelles, dans l'élément Agrégation, procédez comme suit:

        1. Développez le premier menu et sélectionnez une fonction.

          Le graphique est actualisé et affiche une seule série temporelle. Par exemple, si vous sélectionnez Moyenne, la série temporelle affichée correspond à la moyenne de toutes les séries temporelles.

        2. Pour combiner des séries temporelles ayant les mêmes valeurs de libellé, développez le deuxième menu, puis sélectionnez un ou plusieurs libellés.

          Le graphique est actualisé et affiche une série temporelle pour chaque combinaison unique de valeurs de libellé. Par exemple, pour afficher les séries temporelles par zone, définissez le deuxième menu sur zone.

          Lorsque le deuxième menu est défini sur Aucune, le graphique affiche une seule série temporelle.

      • Facultatif: Pour configurer l'espacement entre les points de données, cliquez sur Ajouter un élément de requête, sélectionnez Intervalle minimal, puis saisissez une valeur.

      Pour en savoir plus sur le regroupement et l'alignement, consultez la section Choisir le mode d'affichage des données représentées graphiquement.

    3. Facultatif: Pour n'afficher que les séries temporelles ayant les valeurs les plus élevées ou les plus basses, utilisez l'élément Trier et limiter.

    MQL

    1. Dans la barre d'outils du volet de création de requêtes, sélectionnez le bouton nommé  MQL ou  PromQL.
    2. Vérifiez que MQL est sélectionné dans le bouton d'activation Langage. Le bouton de langage se trouve dans la barre d'outils qui vous permet de mettre en forme votre requête.

    3. Saisissez une requête dans l'éditeur de requête. Par exemple, pour représenter graphiquement l'utilisation du processeur des instances de VM de votre projet Google Cloud, utilisez la requête suivante:

      fetch gce_instance
| metric 'compute.googleapis.com/instance/cpu/utilization'
| group_by 1m, [value_utilization_mean: mean(value.utilization)]
| every 1m

      Pour en savoir plus sur MQL, consultez les documents suivants:

    PromQL

    1. Dans la barre d'outils du volet de création de requêtes, sélectionnez le bouton nommé  MQL ou  PromQL.
    2. Vérifiez que PromQL est sélectionné dans le bouton d'activation Langage. Le bouton de langage se trouve dans la barre d'outils qui vous permet de mettre en forme votre requête.

    3. Saisissez une requête dans l'éditeur de requête. Par exemple, pour représenter graphiquement l'utilisation moyenne du processeur des instances de VM de votre projet Google Cloud, utilisez la requête suivante:

      avg(compute_googleapis_com:instance_cpu_utilization)

      Pour en savoir plus sur l'utilisation de PromQL, consultez la page PromQL dans Cloud Monitoring.

    Filtre de surveillance

    1. Dans l'élément Métrique, cliquez sur  Aide, puis sélectionnez Mode de filtrage direct.

      Les éléments Métrique et Filtre sont supprimés, et un élément Filtres qui vous permet de saisir du texte est créé.

      Si vous avez sélectionné un type de ressource, une métrique ou des filtres avant de passer en mode Direct Filter Mode (Mode de filtrage direct), ces paramètres s'affichent dans le champ de l'élément Filters (Filtres).

    2. Saisissez un filtre Monitoring dans le champ de l'élément Filtres.

    3. Combiner et aligner des séries temporelles:

      • Pour afficher toutes les séries temporelles, dans l'élément Agrégation, définissez le premier menu sur Non agrégé et le second menu sur Aucun.

      • Pour combiner des séries temporelles, dans l'élément Agrégation, procédez comme suit:

        1. Développez le premier menu et sélectionnez une fonction.

          Le graphique est actualisé et affiche une seule série temporelle. Par exemple, si vous sélectionnez Moyenne, la série temporelle affichée correspond à la moyenne de toutes les séries temporelles.

        2. Pour combiner des séries temporelles ayant les mêmes valeurs de libellé, développez le deuxième menu, puis sélectionnez un ou plusieurs libellés.

          Le graphique est actualisé et affiche une série temporelle pour chaque combinaison unique de valeurs de libellé. Par exemple, pour afficher les séries temporelles par zone, définissez le deuxième menu sur zone.

          Lorsque le deuxième menu est défini sur Aucune, le graphique affiche une seule série temporelle.

      • Facultatif: Pour configurer l'espacement entre les points de données, cliquez sur Ajouter un élément de requête, sélectionnez Intervalle minimal, puis saisissez une valeur.

      Pour en savoir plus sur le regroupement et l'alignement, consultez la section Choisir le mode d'affichage des données représentées graphiquement.

  6. Facultatif: configurez le graphique ou le tableau pour afficher plusieurs types de métriques.

    1. Sélectionnez Ajouter une requête. Une nouvelle requête est ajoutée. Par exemple, une requête avec le libellé B peut être ajoutée.

    2. Pour la nouvelle requête, dans l'élément Metric (Métrique), sélectionnez un type de ressource et un type de métrique. Vous pouvez également ajouter des filtres, combiner des séries temporelles, et trier et limiter le nombre de séries temporelles affichées.

    La capture d'écran suivante illustre l'affichage de l'explorateur de métriques lorsque deux types de métriques sont représentés dans un graphique:

    Exemple d'explorateur de métriques avec deux types de métriques.

    MQL

    Non compatible

    PromQL

    Non compatible

    Filtre de surveillance

    Non compatible

  7. Facultatif: configurez le graphique pour qu'il affiche un ratio de types de métriques.

    1. Configurez le graphique pour qu'il affiche deux types de métriques ayant le même type de métrique. Par exemple, il s'agit de métriques GAUGE.
    2. Assurez-vous que la valeur du champ Intervalle minimal est identique pour les deux types de métriques. Pour accéder à ce champ, cliquez sur Ajouter un élément de requête, puis sélectionnez Min Interval (Intervalle minimal).

    3. Mettez à jour les champs d'agrégation.

      Nous vous recommandons que les libellés du type de métrique du dénominateur correspondent aux valeurs définies pour le type de métrique du numérateur. Par exemple, vous pouvez sélectionner l'étiquette zone pour le numérateur et le dénominateur.

      Vous n'êtes pas obligé d'utiliser le même ensemble de libellés pour les deux types de métriques. Toutefois, vous ne pouvez sélectionner que des libellés communs aux deux types de métriques.

    4. Dans la barre d'outils du volet de requête, sélectionnez Créer un ratio, puis remplissez la boîte de dialogue.

      Une fois le ratio créé, trois requêtes s'affichent:

      • Ratio A/B identifie la requête de ratio.
      • A identifie la requête pour le dénominateur.
      • B identifie la requête pour le dénominateur.

      L'exemple suivant illustre un ratio qui compare la somme des octets écrits sur le disque par zone au nombre total d'octets écrits sur le disque:

      Exemple de ratio de métriques.

    5. Facultatif: Pour changer les métriques du numérateur et du dénominateur, dans l'élément Ratio, développez le menu, puis effectuez une sélection.

    MQL

    1. Dans la barre d'outils du volet de création de requêtes, sélectionnez le bouton nommé  MQL ou  PromQL.
    2. Vérifiez que MQL est sélectionné dans le bouton d'activation Langage. Le bouton de langage se trouve dans la barre d'outils qui vous permet de mettre en forme votre requête.

    3. Saisissez une requête dans l'éditeur de requête. MQL vous permet de calculer un ratio entre deux métriques différentes, de filtrer une métrique unique par étiquette, puis de calculer le ratio. La requête suivante calcule le ratio entre le nombre de réponses avec une valeur de 500 et le nombre total de réponses:

      fetch https_lb_rule::loadbalancing.googleapis.com/https/request_count
| {
    filter response_code_class = 500
  ;
    ident
  }
| group_by [matched_url_path_rule]
| outer_join 0
| div

      Pour en savoir plus sur MQL, consultez les documents suivants:

    PromQL

    1. Dans la barre d'outils du volet de création de requêtes, sélectionnez le bouton nommé  MQL ou  PromQL.
    2. Vérifiez que PromQL est sélectionné dans le bouton d'activation Langage. Le bouton de langage se trouve dans la barre d'outils qui vous permet de mettre en forme votre requête.

    3. Saisissez une requête dans l'éditeur de requête. Par exemple, pour représenter graphiquement le ratio de latence moyenne de votre métrique my_summary_latency_seconds, utilisez la requête suivante:

      sum without (instance)(rate(my_summary_latency_seconds_sum[5m])) /
sum without (instance)(rate(my_summary_latency_seconds_count[5m]))

      Pour en savoir plus sur l'utilisation de PromQL, consultez la page PromQL dans Cloud Monitoring.

    Filtre de surveillance

    Non compatible

  8. Facultatif: Pour modifier la visualisation, dans le volet Affichage, cliquez sur Type de widget, puis effectuez une sélection.

    Le menu Type de widget répertorie tous les types de widgets pouvant afficher le même type de données. Toutefois, certains widgets peuvent ne pas être activés. Prenons l'exemple d'un graphique dans un tableau de bord configuré pour afficher un type de métrique. Le graphique en courbes affiche plusieurs séries temporelles, et chaque valeur mesurée est un double:

    • Les widgets Tableau, Graphique à secteurs, Graphique en courbes, Graphique à barres empilées et Graphique en aires empilées sont répertoriés comme Compatibles. Vous pouvez sélectionner l'un de ces types.

    • Les widgets Scorecard (Tableau de données) et Gauge (Jauge) sont répertoriés comme Compatibles avec les ajustements, car ils ne peuvent afficher qu'une seule série temporelle. Pour activer ces types de widgets, modifiez la configuration de regroupement.

    • Le widget Carte de densité est désactivé, car ces widgets ne peuvent afficher que des données de distribution.

    • Le panneau des journaux n'est pas listé, car il ne peut pas afficher les données de séries temporelles.

  9. Facultatif: Pour modifier la façon dont un graphique ou un tableau affiche les données sélectionnées, utilisez les options du volet Afficher:

  10. Pour appliquer vos modifications au tableau de bord, cliquez sur Appliquer dans la barre d'outils. Pour supprimer vos modifications, cliquez sur Annuler.

  11. Pour enregistrer le tableau de bord modifié, cliquez sur Enregistrer dans la barre d'outils.

Afficher uniquement les données les plus récentes

Monitoring vous permet de visualiser uniquement les mesures les plus récentes au lieu de l'historique des mesures de plusieurs manières:

  • Pour afficher graphiquement la valeur la plus récente de chaque série temporelle, où chaque valeur est affichée sous forme de fraction de la somme de toutes les valeurs, ajoutez un graphique à secteurs. Vous pouvez configurer ces graphiques pour afficher la valeur totale.

  • Pour afficher la valeur la plus récente de chaque série temporelle sous forme de tableau, ajoutez un tableau. Vous pouvez limiter le nombre de lignes d'un tableau et configurer les lignes d'un tableau pour afficher une valeur par rapport à une plage de valeurs.

  • Pour obtenir une indication verte, orange ou rouge de la valeur la plus récente par rapport à un ensemble de seuils, ajoutez une jauge ou un tableau de données au tableau de bord.

Représenter les données les plus récentes sous forme de graphique à secteurs

Pour afficher les données les plus récentes sous forme de fraction du total, ajoutez un graphique à secteurs. Comme les tableaux, un graphique à secteurs peut afficher n'importe quel type de métrique ayant une valeur numérique, et peut afficher des centiles pour les métriques à valeur de distribution. Chaque série temporelle contribue à une tranche du graphique.

La capture d'écran suivante illustre un tableau de bord qui affiche l'utilisation du processeur des instances de machine virtuelle à l'aide de deux configurations différentes d'un widget Graphique circulaire:

Exemple de widgets **PieChart**.

Pour savoir comment ajouter des graphiques circulaires à un tableau de bord, consultez les documents suivants:

  • Console Google Cloud: consultez la section Ajouter des graphiques et des tableaux de ce document.

    • Après avoir sélectionné les données à représenter dans un graphique, dans le volet Affichage, définissez le champ Type de widget sur Graphique à secteurs.
    • Pour afficher la valeur totale, définissez le champ Type de graphique sur Donut.

  • API Cloud Monitoring: consultez la section Tableau de bord avec un widget PieChart.

Afficher les données les plus récentes sous forme de tableau

Pour afficher les données les plus récentes sous forme de tableau, ajoutez un tableau. Les tableaux peuvent afficher des données numériques. Par exemple, ils peuvent afficher un ou plusieurs types de métrique ou des centiles pour les métriques à valeur de distribution.

Lorsqu'un tableau affiche un type de métrique, chaque ligne du tableau correspond à une série temporelle. Une colonne de tableau affichant une valeur numérique, qui correspond à la dernière valeur ou à une valeur agrégée. Les autres colonnes affichent les libellés de la série temporelle. Lorsqu'un tableau affiche plusieurs types de métriques, les données des deux types de métriques sont affichées sur la même ligne, si possible. Pour en savoir plus, consultez la section Comment les tables fusionnent-elles plusieurs types de métriques ?.

Il existe deux widgets qui affichent les données sous forme de tableau: le widget Top List (Meilleures listes) et le widget Table (Tableau). La principale différence entre ces deux widgets est que le widget Top List trie l'ordre des lignes et affiche la valeur ainsi qu'un indicateur visuel de la valeur par rapport à la plage de valeurs possibles. Étant donné que le widget Top List fournit une représentation visuelle de la valeur, vous ne pouvez pas appliquer de code couleur à la cellule en fonction de la comparaison de la valeur avec un seuil.

Pour en savoir plus sur la configuration des tables, consultez les sections suivantes:

La capture d'écran suivante illustre deux tableaux. Le premier tableau affiche deux types de métriques : le nombre d'octets lus à partir des instances et le nombre d'octets écrits dans les instances. Une valeur agrégée est affichée avec une barre de référence. Le deuxième tableau affiche la dernière valeur d'un type de métrique, et la colonne de valeur a été configurée pour appliquer un code couleur à la cellule en fonction de la comparaison de la valeur avec un seuil:

Exemple de tableau affichant deux types de métriques.

Afficher la dernière valeur ou la valeur agrégée

Par défaut, les tableaux affichent la valeur la plus récente. Toutefois, un tableau peut afficher une valeur calculée sur la période sélectionnée pour votre tableau de bord.

Pour choisir entre la valeur la plus récente et la valeur agrégée, utilisez le champ Value option (Option de valeur).

Si vous affichez la valeur agrégée, pour chaque série temporelle, les données de la période sélectionnée par votre tableau de bord sont combinées par la fonction d'alignement. La fonction d'alignement fait partie des options d'agrégation et n'est pas affichée par défaut. Pour afficher la fonction d'alignement, développez l'élément Agrégation, puis sélectionnez Configurer l'aligneur dans le premier élément. Une fois cette sélection effectuée, l'élément Agrégation est remplacé par un élément Regroupement et un menu intitulé Fonction d'alignement.

Sélectionner les colonnes à afficher

Par défaut, une colonne du tableau affiche une valeur numérique. Toutes les autres colonnes correspondent à un libellé de la série temporelle. Pour les colonnes basées sur un libellé, le nom de la colonne est dérivé du libellé.

Pour configurer les colonnes affichées dans le tableau, développez le menu Colonnes visibles et effectuez vos sélections.

Configurer le format des colonnes

  • Pour configurer une colonne individuelle, dans l'élément Columns (Colonnes), développez le menu Override column (Remplacer la colonne), sélectionnez la colonne à modifier, puis effectuez l'une des opérations suivantes:

    • Pour définir le nom de la colonne, utilisez le champ Nom à afficher.
    • Pour définir l'alignement des données dans la colonne, utilisez les boutons Alignement à gauche, Alignement au centre et Alignement à droite.
    • Pour appliquer un code couleur à la cellule en fonction de la comparaison de la valeur numérique à un seuil, définissez les seuils d'avertissement et de danger.
    • Si vous écrivez des requêtes PromQL, utilisez le menu Unit (Unité) pour définir les unités affichées avec les données. Les unités sont automatiquement configurées lorsque vous configurez votre requête à l'aide de sélections de menu.

Afficher la valeur de référence

Les tableaux ne peuvent afficher qu'une seule valeur ou une valeur par rapport à la plage de valeurs. Lorsque l'option de plage est sélectionnée, la valeur est affichée avec une barre de couleur bleue, dont la longueur est proportionnelle à la valeur affichée.

Pour configurer l'affichage d'une valeur de référence, utilisez l'élément Vue des métriques.

Trier et filtrer les tableaux

Vous pouvez modifier l'ordre des lignes dans l'affichage du tableau et filtrer le contenu du tableau afin que seules des lignes spécifiques soient affichées. Ces paramètres ne sont pas persistants. Lorsque vous quittez la page du tableau de bord ou que vous le rechargez, les options de tri et de filtrage que vous avez appliquées sont supprimées.

Vous disposez des options de tri et de filtrage suivantes:

  • Pour trier le tableau en fonction d'une colonne, cliquez sur l'en-tête de la colonne.

  • Pour modifier les colonnes de la table, cliquez sur Afficher les colonnes, apportez vos modifications, puis cliquez sur OK.

  • Pour n'afficher que des lignes spécifiques, ajoutez un ou plusieurs filtres. Vous pouvez ajouter plusieurs filtres. Lorsque vous ne spécifiez pas l'opérateur OR entre deux filtres, un opérateur logique AND joint ces filtres.

    Pour ajouter un filtre, cliquez sur Enter property name or value, sélectionnez une propriété dans le menu, puis saisissez une valeur ou sélectionnez-en une dans le menu des valeurs. Par exemple, si vous filtrez sur la propriété Name et saisissez la valeur demo, le tableau ne répertorie que les lignes pour lesquelles le champ Name inclut la valeur demo.

Afficher les données les plus récentes avec une indication d'avertissement ou d'erreur

Pour afficher la mesure la plus récente par rapport à un ensemble de seuils codés par couleur, ajoutez une jauge ou un tableau de données. Les jauges n'affichent que la mesure la plus récente, tandis que les tableaux de données affichent également un historique des mesures récentes. La couleur d'arrière-plan de ces widgets est également associée à un code couleur. Lorsque la valeur la plus récente se trouve dans les plages attendues, la couleur du widget est blanche. Lorsque la valeur se trouve dans une plage d'avertissement, le widget devient ambre. De même, lorsque la valeur se situe dans une plage de danger, le widget devient rouge.

Les deux widgets affichent une seule série temporelle. La capture d'écran suivante montre un exemple de jauge lorsque la mesure la plus récente est inférieure aux seuils d'avertissement et de danger:

Exemple de jauge.

Le reste des informations de cette section concerne la console Google Cloud. Pour en savoir plus sur l'utilisation de l'API Cloud Monitoring, consultez la section Tableau de bord avec un widget Scorecard de base.

Pour ajouter une jauge ou un tableau de données à un tableau de bord, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page Tableaux de bord .

    Accéder à la page Tableaux de bord

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  2. Effectuez l'une des opérations suivantes :

    • Pour créer un nouveau tableau de bord, sélectionnez Créer un tableau de bord.
    • Pour mettre à jour un tableau de bord existant, recherchez le tableau de bord dans la liste de tous les tableaux de bord, puis sélectionnez son nom.

  3. Dans la barre d'outils, cliquez sur  Ajouter un widget.

  4. Dans la boîte de dialogue Ajouter un widget, sélectionnez  Métrique.

  5. Spécifiez les données à afficher dans le graphique. Vous pouvez utiliser une interface basée sur des menus, le langage MQL (Monitoring Query Language), PromQL ou saisir un filtre de surveillance:

    1. Sélectionnez les données de séries temporelles que vous souhaitez afficher :

      1. Dans l'élément Métrique, développez le menu Sélectionner une métrique.

        Le menu Sélectionner une métrique contient des fonctionnalités qui vous aident à trouver les types de métriques disponibles:

        • Pour rechercher un type de métrique spécifique, utilisez la barre de filtre . Par exemple, si vous saisissez util, le menu ne répertorie que les entrées incluant util. Les entrées s'affichent lorsqu'elles réussissent un test "contient" non sensible à la casse.

        • Pour afficher tous les types de métriques, même ceux sans données, cliquez sur Active (Actif). Par défaut, les menus n'affichent que les types de métriques associés à des données.

        Par exemple, vous pouvez faire les choix suivants:

        1. Dans le menu Ressources actives, sélectionnez Instance de VM.
        2. Dans le menu Catégories de métriques actives, sélectionnez uptime_check.
        3. Dans le menu Métriques actives, sélectionnez Latence des requêtes.
        4. Cliquez sur Appliquer.

      2. Facultatif: Pour spécifier un sous-ensemble de données à afficher, dans l'élément Filtre, sélectionnez Ajouter un filtre, puis remplissez la boîte de dialogue. Par exemple, vous pouvez afficher les données d'une zone en appliquant un filtre. Vous pouvez ajouter plusieurs filtres. Pour en savoir plus, consultez la page Filtrer les données représentées graphiquement.

      Pour en savoir plus, consultez la section Sélectionner les données à représenter sous forme de graphique.

    2. Combinez les séries temporelles à l'aide des champs Aggregation (Agrégation) :

      • Développez le premier menu et sélectionnez la fonction qui combine les séries temporelles.
      • Développez le deuxième menu et assurez-vous qu'aucun libellé n'est sélectionné.

    MQL

    1. Dans la barre d'outils du volet de création de requêtes, sélectionnez le bouton nommé  MQL ou  PromQL.
    2. Vérifiez que MQL est sélectionné dans le bouton d'activation Langage. Le bouton de langage se trouve dans la barre d'outils qui vous permet de mettre en forme votre requête.

    3. Saisissez une requête dans l'éditeur de requête. Vous devez vous assurer que les champs d'agrégation sont définis pour combiner toutes les séries temporelles. Par exemple, pour représenter graphiquement l'utilisation du processeur des instances de VM de votre projet Google Cloud, utilisez la requête suivante:

      fetch gce_instance
| metric 'compute.googleapis.com/instance/cpu/utilization'
| group_by 1m, [value_utilization_mean: mean(value.utilization)]
| every 1m
| group_by [], [value_utilization_mean_mean: mean(value_utilization_mean)]

      Pour en savoir plus sur MQL, consultez les documents suivants:

    PromQL

    1. Dans la barre d'outils du volet de création de requêtes, sélectionnez le bouton nommé  MQL ou  PromQL.
    2. Vérifiez que PromQL est sélectionné dans le bouton d'activation Langage. Le bouton de langage se trouve dans la barre d'outils qui vous permet de mettre en forme votre requête.

    3. Saisissez une requête dans l'éditeur de requête. Par exemple, pour représenter graphiquement l'utilisation moyenne du processeur des instances de VM de votre projet Google Cloud, utilisez la requête suivante:

      avg(compute_googleapis_com:instance_cpu_utilization)

      Pour en savoir plus sur l'utilisation de PromQL, consultez la page PromQL dans Cloud Monitoring.

    Filtre de surveillance

    1. Dans l'élément Métrique, cliquez sur  Aide, puis sélectionnez Mode de filtrage direct.

      Les éléments Métrique et Filtre sont supprimés, et un élément Filtres qui vous permet de saisir du texte est créé.

      Si vous avez sélectionné un type de ressource, une métrique ou des filtres avant de passer en mode Direct Filter Mode (Mode de filtrage direct), ces paramètres s'affichent dans le champ de l'élément Filters (Filtres).

    2. Saisissez un filtre Monitoring.

    3. Combinez les séries temporelles à l'aide des champs Aggregation (Agrégation) :

      • Développez le premier menu et sélectionnez la fonction qui combine les séries temporelles.
      • Développez le deuxième menu et assurez-vous qu'aucun libellé n'est sélectionné.

  6. Dans le volet Affichage, configurez la jauge ou le tableau de données:

    1. Cliquez sur Type de widget, puis sélectionnez Jauge ou Tableau de données.

    2. Pour les widgets de jauge, cliquez sur Plage de la jauge, puis définissez les valeurs minimale et maximale. Lorsqu'une jauge affiche un pourcentage, définissez ces valeurs sur 0 et 1 respectivement.

    3. Cliquez sur Seuil de la jauge, puis définissez les seuils d'avertissement et de danger. Les champs de seuil vides ne sont pas utilisés.

      Pour la jauge affichée précédemment, deux seuils sont définis. Les valeurs supérieures à 0,9 se situent dans la plage de danger. Les valeurs supérieures à 0,7, mais ne se situant pas dans la plage de danger, se situent dans la plage d'avertissement.

    4. Pour les tableaux de données, cliquez sur Vue graphique Spark, puis développez le menu d'options, puis sélectionnez le style d'affichage.

  7. Pour appliquer vos modifications au tableau de bord, cliquez sur Appliquer dans la barre d'outils. Pour supprimer vos modifications, cliquez sur Annuler.

  8. Pour enregistrer le tableau de bord modifié, cliquez sur Enregistrer dans la barre d'outils.

Comment les tables fusionnent les données de plusieurs types de métriques

Si une table interroge plusieurs types de métriques, la console Google Cloud effectue une opération de fusion en examinant les libellés associés aux données agrégées pour les deux types de métriques. Lorsque les libellés communs aux deux requêtes permettent à la surveillance de déterminer un identifiant de ligne unique, une seule ligne du tableau affiche la valeur la plus récente pour chaque requête. Sinon, une ligne est attribuée à chaque série temporelle.

Par exemple, supposons qu'une table interroge deux types de métriques différents. Appelons ces requêtes A et B. La section suivante décrit comment les résultats de la requête sont fusionnés:

  • Si le résultat des deux requêtes comporte le même ensemble de libellés, la fusion aboutit toujours. Chaque ligne contient la dernière valeur pour chaque requête. Si une requête ne renvoie pas de valeur pour une combinaison de libellés spécifique, la cellule de la table est vide.

    Par exemple, supposons que les deux requêtes contiennent un libellé zone. Le tableau contient une ligne pour chaque zone signalée par les requêtes A et B. Toutefois, si la requête A renvoie une série temporelle dont la zone est us-central1-a, mais que la requête B ne renvoie pas de série temporelle avec cette valeur, la dernière valeur de la requête B s'affiche sous forme de cellule vide.

  • Si les libellés des résultats d'une requête sont un sous-ensemble des libellés des résultats de l'autre requête, les résultats sont fusionnés.

    Par exemple, supposons que les résultats des deux requêtes incluent des libellés pour location et cluster_name, mais que les résultats de la requête A incluent également un libellé pour memory_type. Dans ce cas, chaque ligne correspond à une série temporelle avec des valeurs uniques pour les trois libellés.

    Sur n'importe quelle ligne, la valeur affichée pour la requête B correspond à celle de la série temporelle correspondant aux deux libellés courants, location et cluster_name, et le troisième libellé est ignoré.

  • Si les résultats des deux requêtes ne partagent aucun libellé ou s'ils en partagent certains, mais pas assez pour former un identifiant de ligne unique, les résultats ne peuvent pas être fusionnés. Le tableau liste une ligne pour chaque série temporelle renvoyée par la requête A ou par la requête B, et certaines cellules du tableau sont vides.

    Par exemple, supposons que les libellés de la requête A soient location et memory_type, et que les libellés de la requête B soient location et cluster_name. Même si le libellé location est courant, il n'est pas suffisant pour créer un identifiant de ligne unique.

    Comme décrit dans la section suivante, vous pouvez peut-être résoudre un échec de fusion.

Résoudre un échec de fusion

Lorsque vous créez un graphique avec plusieurs métriques, une erreur de fusion peut se produire, car les métriques utilisent des noms de libellés différents pour le même champ. Pour résoudre ce problème, vous pouvez convertir une requête en PromQL, puis utiliser la fonction label_replace() pour convertir les noms de libellé utilisés par un type de métrique en fonction de ceux de l'autre type de métrique.

Prenons l'exemple d'une table configurée avec deux requêtes:

  • A: interroge le type de métrique Prometheus/kube_pod_container_status_ready/gauge. Les options d'agrégation sont définies pour additionner les séries temporelles après avoir regroupé les données par libellé cluster.

  • B: interroge le type de métrique kubernetes.io/container/memory/request_bytes. Les options d'agrégation sont définies pour additionner les séries temporelles après avoir regroupé les données par libellé cluster_name.

Le tableau ne peut pas fusionner les résultats, car les résultats de la requête A et de la requête B ont des libellés différents.

Pour résoudre l'échec, convertissez la requête A en PromQL et remplacez cluster par cluster_name. L'exemple suivant illustre la requête modifiée:

sum by (cluster_name)(
    label_replace(
        avg_over_time(kube_pod_container_status_ready[${__interval}]),
        "cluster_name", "$1", "cluster", "(.*)"
    )
)

Avec les modifications apportées, les deux requêtes génèrent le même ensemble d'étiquettes. Par conséquent, chaque ligne du tableau indique un nom de cluster, la valeur de la requête A et la valeur de la requête B.

Pour en savoir plus sur l'utilisation de PromQL, consultez la page PromQL dans Cloud Monitoring.

Étape suivante

Vous pouvez également ajouter les widgets suivants à vos tableaux de bord personnalisés:

Pour en savoir plus sur l'exploration des données représentées graphiquement et le filtrage de vos tableaux de bord, consultez les documents suivants: