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 les données de métriques sur un intervalle de temps en ajoutant un graphique en courbes, un graphique en aires empilées, un graphique à barres ou une carte thermique. Si vous n'êtes intéressé par les mesures les plus récentes, puis ajoutez un tableau, un diagramme circulaire, 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.

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

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

Ce document explique comment ajouter des graphiques, des tableaux, des jauges et des tableaux de données dans 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 É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 Contrôlez 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électionnez la visualisation, puis configurez le widget, ou vous pouvez sélectionner le type de données, puis configurer la visualisation.

    Par exemple, pour ajouter une table qui affiche l'utilisation du processeur des 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 qu'il affiche les de l'utilisation du processeur de vos instances de VM.
    • Sélectionnez le type de données Métrique et configurez le widget pour qu'il affiche les de l'utilisation du processeur de vos instances de VM, puis définissez le type de widget sur Tableau :

    Les instructions de cette page supposent que vous sélectionnez d'abord le type de données, puis configurer l'affichage de ces donné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 au fil du temps et quatre styles sont disponibles: Ligne, Zone empilée, 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 sur vos instances les octets de disque écrits dans vos instances.

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

    Pour en savoir plus sur l'utilisation de l'API Cloud Monitoring pour configurer un graphique, consultez 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 plusieurs types de métriques, chaque ligne contient le résultat de l'ensemble des requêtes, lorsque une telle fusion est possible.

    Il existe deux styles de tableaux. Le widget Table affiche une valeur numérique telle que "25 %". Le widget Top List (Liste des titres les plus populaires) affiche la valeur et un indicateur visuel de la valeur par rapport à la plage de valeurs possibles.

    Vous pouvez modifier le style des tableaux et des graphiques, configurer les noms des colonnes du tableau et ajouter des seuils qui changent la couleur les 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 une table, consultez les sections 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 un à l'aide d'un menu, du langage MQL (Monitoring Query Language), de PromQL, ou vous pouvez saisir 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 propose des fonctionnalités qui vous aident à identifier les types de métriques disponibles:

        • Pour rechercher un type de métrique spécifique, utilisez le Barre de filtres. Par exemple, si vous saisissez util, vous limitez le menu aux afficher les entrées contenant util. Les entrées s'affichent lorsqu'elles réussissent un mot clé "contient" non sensible à la casse test.

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

        Vous pouvez, par exemple, choisir les options suivantes:

        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 Filtrer, sélectionnez Ajouter un filtre, puis pour terminer 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 Sélectionnez les données à représenter dans le graphique.

    2. Combiner et aligner des séries temporelles :

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

      • Pour combiner des séries temporelles, dans l'élément Aggregation (Agrégation) : effectuer les opérations suivantes:

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

          Le graphique est actualisé et n'affiche qu'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 d'étiquette, 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 valeur combinaison de valeurs d'étiquette. Par exemple, pour les afficher sur des séries temporelles par zone, définissez le deuxième menu sur zone.

          Lorsque le deuxième menu est défini sur Aucun, le graphique en affiche une de séries temporelles.

      • 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 la série temporelle ayant la valeur la plus élevée ou la plus basse utilisez la fonction Trier et Limit.

    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 Direct Filter Mode (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), puis ces paramètres s'affichent dans le champ de l'élément Filtres.

    2. Saisissez un filtre Monitoring dans le champ de la Filters.
    3. Combiner et aligner des séries temporelles:

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

      • Pour combiner des séries temporelles, dans l'élément Aggregation (Agrégation) : effectuer les opérations suivantes:

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

          Le graphique est actualisé et n'affiche qu'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 d'étiquette, 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 valeur combinaison de valeurs d'étiquette. Par exemple, pour les afficher sur des séries temporelles par zone, définissez le deuxième menu sur zone.

          Lorsque le deuxième menu est défini sur Aucun, le graphique en affiche une de séries temporelles.

      • 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, sélectionnez une le type de ressource et le type de métrique. Vous pouvez aussi 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 le 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 afficher un ratio de types de métriques.

    1. Configurez le graphique pour afficher deux types de métriques ayant le même "metricKind". Par exemple, les deux métriques sont GAUGE.
    2. Assurez-vous que la valeur du champ Intervalle minimal est pour les deux types de métriques. Pour accéder à ce champ, cliquez sur Ajouter un élément de requête, puis sélectionnez Intervalle minimal.
    3. Mettez à jour les champs d'agrégation.

      Nous recommandons que les étiquettes du type de métrique de dénominateur correspondre aux valeurs définies pour le type de métrique "numérateur". Par exemple, vous pouvez sélectionner le libellé 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 pour terminer 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 numérateur.
      • 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 une le ratio de deux métriques différentes, et filtrer une seule métrique par étiquette, puis calculez le ratio. La requête suivante calcule le ratio des réponses avec une valeur de 500 par rapport au 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 le ratio la latence moyenne de votre métrique my_summary_latency_seconds, utilisez la 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 Display (Affichage), cliquez sur Type de widget, puis effectuez votre sélection.

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

    • Tableau, Graphique à secteurs, Graphique en courbes, Graphique à barres empilées et Les widgets de type Graphique en aires empilées sont listés comme Compatibles. Vous pouvez sélectionner n'importe lequel de ces types.

    • Les widgets Scorecard (Tableau de données) et Gauge (Graphique 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, modifier la configuration du regroupement.

    • Le widget Carte de densité est désactivé, car ces widgets ne peuvent s'afficher de données à distribution unique.

    • 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 l'affichage des données sélectionnées dans un graphique ou un tableau, utilisez les Options du volet Display (Affichage) :

  10. Pour appliquer vos modifications au tableau de bord, dans la barre d'outils, cliquez sur Appliquer. 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 offre plusieurs moyens de visualiser uniquement les mesures les plus récentes, au lieu d'afficher l'historique des mesures:

  • Pour afficher sous forme graphique la valeur la plus récente de chaque série temporelle, procédez comme suit : où chaque valeur est affichée sous la forme d'une fraction de la somme de toutes les valeurs, ajouter 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, procédez comme suit : ajouter un tableau. Vous pouvez limiter le nombre de lignes d'une table et configurer 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 graphiquement les données les plus récentes à l'aide d'un diagramme circulaire

Pour afficher les données les plus récentes sous forme de fraction du total, ajoutez un graphique à secteurs. Comme les tableaux, un graphique circulaire peut afficher n'importe quelle Type de métrique ayant une valeur numérique, et peuvent afficher des centiles pour avec des métriques basées sur la distribution. Chaque série temporelle contribue un segment au camembert.

La capture d'écran suivante montre un tableau de bord qui affiche l'utilisation du processeur par les instances de VM Configurations d'un widget de graphique à secteurs:

Exemple de widget **PieChart**.

Pour savoir comment ajouter des graphiques à secteurs à 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 le volet Display (Affichage), définissez la Type de widget sur Graphique à secteurs.
    • Pour afficher la valeur totale, définissez le champ Type de graphique sur Anneau.
  • API Cloud Monitoring: consultez les ressources 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 metric type, ou centiles pour les métriques basées sur la distribution.

Lorsqu'un tableau affiche un type de métrique, chaque ligne du tableau correspond en série temporelle unique. Une colonne de tableau qui affiche une valeur numérique, qui est soit la dernière valeur, soit une valeur agrégée. Les autres colonnes pour afficher les étiquettes 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 Fusionner plusieurs types de métriques dans les tableaux

Deux widgets présentent des données sous forme de tableau: Top List. et Table. 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. Comme le widget Top List offre un aperçu visuel, représentation de la valeur, vous ne pouvez pas appliquer un code couleur à la cellule en fonction la comparaison entre la valeur et 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 les types de métriques, le nombre d'octets lus 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. Cependant, un tableau peut afficher une valeur calculée sur la période sélectionnée pour votre tableau de bord.

Pour choisir entre la dernière valeur et la valeur agrégée, utilisez les Option de valeur.

Si vous affichez la valeur agrégée, les données de chaque série temporelle au cours de la période sélectionnée par votre tableau de bord est combiné par d'alignement. La fonction d'alignement est l'une des options d'agrégation et n'est pas affichée par défaut. Pour afficher la fonction d'alignement, développez la Agrégation et, dans le premier élément, sélectionnez Configurer l'aligneur. 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 les colonnes correspondent à une étiquette 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 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 Aligner à gauche, Aligner au centre Boutons Aligner à droite.
    • Pour coder la cellule en couleur en fonction de la comparaison de la valeur numérique avec une définir les seuils d'avertissement et de danger.
    • Si vous écrivez des requêtes PromQL, utilisez le menu Unit (Unité) pour définir la d'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 peuvent afficher uniquement une valeur ou une valeur relative à la plage de valeurs. Lorsque l'option de plage est sélectionnée, la valeur s'affiche ainsi qu'une barre bleue, la longueur de la barre est proportionnelle à la affichée.

Pour configurer l'affichage d'une valeur référentielle, utilisez la 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 lorsque lorsque vous actualisez le tableau de bord, les options de tri et de filtrage que vous avez appliquées supprimés.

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 répertorier uniquement des lignes spécifiques, ajoutez un ou plusieurs filtres. Vous pouvez ajouter plusieurs des filtres. Si vous ne spécifiez pas l'opérateur OU entre deux filtres, une l'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, la table n'affiche alors que les lignes pour lesquelles le champ Name est sélectionné. inclut la valeur demo.

Afficher les données les plus récentes avec un avertissement ou une erreur

Pour afficher la mesure la plus récente par rapport à un ensemble de codes couleur des seuils, ajoutez une jauge ou un tableau de données. Les jauges n'affichent que les données les plus récentes mesure, tandis que les tableaux de données affichent également l'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. Quand ? si la valeur se situe dans une plage d'avertissement, le widget devient orange. De même, lorsque le se trouve 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 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 un à l'aide d'un menu, du langage MQL (Monitoring Query Language), de PromQL, ou vous pouvez saisir 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 propose des fonctionnalités qui vous aident à identifier les types de métriques disponibles:

        • Pour rechercher un type de métrique spécifique, utilisez le Barre de filtres. Par exemple, si vous saisissez util, vous limitez le menu aux afficher les entrées contenant util. Les entrées s'affichent lorsqu'elles réussissent un mot clé "contient" non sensible à la casse test.

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

        Vous pouvez, par exemple, choisir les options suivantes:

        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 Filtrer, sélectionnez Ajouter un filtre, puis pour terminer 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 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 l'agrégation sont configurés pour combiner toutes les séries temporelles. Par exemple, pour représenter le graphique de l'utilisation du processeur des instances de VM dans votre projet Google Cloud, utilisez le 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 la moyenne de l'utilisation du processeur des instances de VM dans votre projet Google Cloud, utilisez le 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 Direct Filter Mode (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), puis ces paramètres s'affichent dans le champ de l'élément 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. et sélectionnez Jauge ou Tableau de données.

    2. Pour les widgets de jauge, cliquez sur Plage de la jauge : puis définir 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. Valeurs supérieures à 0,9 sont 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 étiquettes associées aux 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, il y a une ligne pour chaque série temporelle.

Par exemple, supposons qu'une table interroge deux types de métriques différents. Appelons-le ces requêtes A et B. Ce qui suit décrit comment les résultats de la requête sont fusionnées:

  • Si le résultat des deux requêtes comporte le même ensemble de libellés, la fusion est effectuée toujours réussi. Chaque ligne contient la dernière valeur pour chaque requête. Si une requête ne renvoie pas de valeur pour une combinaison d'étiquettes particulière, la cellule du tableau est vide.

    Par exemple, supposons que les deux requêtes contiennent un libellé zone. La table 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 comportant cette valeur, la dernière valeur de la requête B s'affiche sous la forme d'une cellule vide.

  • Si les étiquettes des résultats d'une requête sont un sous-ensemble des étiquettes pour les 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 étiquettes.

    Sur n'importe quelle ligne, la valeur affichée pour la requête B correspond à la valeur de la série temporelle qui correspond aux deux étiquettes communes, location et cluster_name, et la troisième étiquette est ignorée.

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

    Par exemple, supposons que les étiquettes de la requête A soient location et memory_type, et que les étiquettes de la requête B sont location et cluster_name Même si l'étiquette location est courante, elle n'est pas pour créer un identifiant de ligne unique.

    Comme décrit dans la section suivante, vous pourrez peut-être résoudre une fusion l'échec.

Résoudre l'échec de la fusion

Lorsque vous représentez plusieurs métriques sous forme graphique, un échec de fusion peut se produire. car les métriques utilisent des noms de libellés différents pour un même champ. Pour résoudre ce problème, vous pouvez convertir une requête en requête PromQL. Ensuite, utilisez la fonction label_replace() pour convertir les noms des étiquettes utilisés par un type de métrique pour qu'ils correspondent à ceux un 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 kubernetes.io/container/memory/request_bytes type de métrique. Les options d'agrégation sont définies pour additionner les séries temporelles après regroupant les données selon le libellé cluster_name.

La table ne peut pas fusionner les résultats, car ceux de la requête A et B ont des étiquettes différentes.

Pour résoudre l'échec, convertissez la requête A en PromQL et remplacez cluster. avec 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", "(.*)"
    )
)

Une fois les modifications apportées, les deux requêtes produisent le même ensemble d'étiquettes. Chaque ligne de la table indique donc 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: