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 un graphique de carte de densité. Si vous n'êtes intéressé que par les mesures les plus récentes, ajoutez un tableau, un graphique à secteurs, une jauge ou un tableau de données. Les jauges et les tableaux de données changent de couleur en fonction de la valeur la plus récente par rapport aux 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 section Présentation des tableaux de bord.

Les graphiques, tableaux, jauges et 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 les métriques définies par l'utilisateur et les 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 à un tableau de bord personnalisé qui affiche des données de séries temporelles. Pour en savoir plus sur l'ajout d'autres types de widgets à vos tableaux de bord, consultez les documents suivants:

• Règles d'alerte et incidents
• Journaux et erreurs
• Texte descriptif
• Objectifs de niveau de service (SLO) pour un ensemble de services
• Graphiques affichant les résultats d'une requête d'Analyse de journaux

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 attribuer le rôle IAM Éditeur Monitoring (roles/monitoring.editor) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

  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 page 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 soit sélectionner la visualisation, puis configurer le widget, soit sélectionner d'abord le type de données, puis configurer la visualisation.

  Par exemple, pour ajouter à un tableau de bord une table qui affiche l'utilisation du processeur par vos instances de VM, 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.

  Les instructions de cette page supposent que vous devez d'abord sélectionner le type de données, puis configurer le mode d'affichage de ces données.

Ajouter des graphiques et des tableaux à un tableau de bord

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

• Les graphiques affichent les données au fil du temps. Quatre styles sont disponibles : Courbes, Zones empilées, Barres empilées et Carte de densité. Une fois qu'un graphique est configuré, vous pouvez modifier son type de widget. Pour savoir pourquoi vous pouvez sélectionner un style spécifique, consultez la section 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 la section Tableau de bord avec un widget XyChart.

• Les tables contiennent une ligne pour chaque série temporelle surveillée et n'affichent que la valeur la plus récente. Il existe deux styles de tableaux. Le widget Table affiche une valeur numérique telle que "25%". Le widget Top List affiche à la fois la valeur et un indicateur visuel par rapport à la plage de valeurs possibles. Vous pouvez passer d'un type de widget à l'autre. Pour en savoir plus et obtenir un exemple, consultez la section Afficher les 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 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 le panneau de navigation de la console Google Cloud, sélectionnez Monitoring, puis  Tableaux de bord :

   Accédez à Tableaux de bord.

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 Add widget (Ajouter un widget), sélectionnez  Métrique.

5. Spécifiez les données à afficher dans le graphique. Vous pouvez utiliser une interface pilotée par menu, le langage MQL (Monitoring Query Language), PromQL, ou saisir un filtre Monitoring:

   Interface basée sur des menus

   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 filtres . Par exemple, si vous saisissez util, vous restreignez le menu pour afficher les entrées qui incluent 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 celles sans données, cliquez sur Active. Par défaut, les menus n'affichent que les types de métriques avec des données.

         Par exemple, vous pouvez 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 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 Filtrer les données représentées graphiquement.

      Pour en savoir plus, consultez Sélectionner les données à représenter dans le graphique.

   2. Combinez et alignez les séries temporelles:

      • Pour afficher chaque série temporelle, dans l'élément Aggregation (Agrégation), définissez le premier menu sur Unaggregated (Non agrégé) et le second menu sur None (Aucun).

      • Pour combiner des séries temporelles, dans l'élément Aggregation (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 Mean (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 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 None (Aucun), le graphique affiche une 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 votre requête dans l'éditeur de requête. Par exemple, pour représenter l'utilisation du processeur par les 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:

      • Présentation de MQL
      • Utiliser l'éditeur de code pour MQL

   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 votre requête dans l'éditeur de requête. Par exemple, pour représenter l'utilisation moyenne du processeur par les 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 section PromQL dans Cloud Monitoring.

   Filtre de surveillance

   1. Dans l'élément Metric (Métrique), cliquez sur Help (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), ces paramètres sont affichés dans le champ de l'élément Filters (Filtres).

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

   3. Combinez et alignez les séries temporelles:

      • Pour afficher chaque série temporelle, dans l'élément Aggregation (Agrégation), définissez le premier menu sur Unaggregated (Non agrégé) et le second menu sur None (Aucun).

      • Pour combiner des séries temporelles, dans l'élément Aggregation (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 Mean (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 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 None (Aucun), le graphique affiche une 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 pour afficher plusieurs types de métriques.

   Interface basée sur des menus

   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 le graphique:

   

   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.

   Interface basée sur des menus

   1. Configurez le graphique pour afficher deux types de métriques ayant le même type de métrique. Par exemple, les deux sont des 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 Intervalle minimal.

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

      Nous vous recommandons de faire en sorte que les libellés du type de métrique de dénominateur correspondent aux valeurs définies pour le type de métrique de 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 du numérateur.
      • B identifie la requête du dénominateur.

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

      

   5. Facultatif: Pour modifier les métriques de numérateur et de 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 votre requête dans l'éditeur de requête. MQL vous permet de calculer un ratio entre deux métriques différentes, de filtrer une seule métrique par étiquette, puis de calculer 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:

      • Présentation de MQL
      • Utiliser l'éditeur de code
      • Ratios de calcul

   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 votre requête dans l'éditeur de requête. Par exemple, pour représenter 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 section PromQL dans Cloud Monitoring.

   Filtre de surveillance

   Non compatible.

8. Facultatif: Pour modifier la visualisation, dans le volet Display (Écran), cliquez sur Widget type (Type de widget), puis faites votre sélection.

   Le menu Type de widget répertorie tous les types de widgets pouvant afficher le même type de données. Toutefois, il est possible que certains widgets ne soient pas activés. Prenons l'exemple d'un graphique sur 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 indiqués comme étant Compatibles. Vous pouvez sélectionner l'un de ces types.

     Remarque :Pour afficher les données sous forme de tableau, définissez le type de widget sur Table. Si vous sélectionnez Table dans le bouton d'activation intitulé Chart Table Again (Représenter les deux tables dans un graphique), l'affichage est modifié, mais ce paramètre n'est pas enregistré.

   • Les widgets Scorecard et Jauge sont listés comme étant 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 il ne peut afficher que des données à valeur de distribution.

   • Le panneau des journaux ne figure pas dans la liste, car il ne peut pas afficher les données de séries temporelles.

9. Facultatif: Pour modifier la façon dont le graphique affiche les données sélectionnées, utilisez les options du volet Display (Affichage) :

   • Pour configurer le graphique afin qu'il s'affiche en mode "Rayon X" ou pour afficher les statistiques, cliquez sur Mode d'analyse.
   • Pour comparer les données actuelles aux données passées, cliquez sur Comparer à une période antérieure.
   • Pour ajouter un seuil de référence, cliquez sur Ligne de seuil.
   • Pour configurer le nom d'une colonne de légende, cliquez sur Alias de légende.
   • Pour configurer l'attribution de l'axe Y, les étiquettes ou l'échelle, utilisez les menus Attribution de l'axe Y, Étiquettes de l'axe Y et Échelle de l'axe Y.

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

11. Pour enregistrer votre 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 façons de ne visualiser que 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, où chaque valeur est affichée sous la forme d'une 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 une table. Vous pouvez limiter le nombre de lignes d'une table et configurer les lignes d'une table pour qu'elles affichent 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 la forme d'une fraction du total, ajoutez un graphique à secteurs. Comme les tables, un graphique à secteurs peut afficher n'importe quel type de métrique ayant une valeur numérique, ainsi que les centiles des 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 machines virtuelles à l'aide de deux configurations différentes d'un widget Graphique à secteurs:

Pour plus d'informations sur l'ajout de 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 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 tables peuvent afficher n'importe quel type de métrique ayant une valeur numérique, ainsi que les centiles des métriques à valeur de distribution. Les tableaux n'affichent que la valeur la plus récente, semblable au comportement des jauges et des tableaux de données. Toutefois, contrairement aux jauges et aux tableaux de données, les tables contiennent une ligne pour chaque série temporelle surveillée.

Il existe deux styles de tableaux. Le widget Top List est préconfiguré pour comporter deux colonnes et limiter le nombre de lignes. Une colonne du widget Top List affiche un libellé tel que instance_id, et l'autre affiche à la fois la valeur et un indicateur visuel de la valeur par rapport à la plage de valeurs possibles. Le widget Table est préconfiguré pour afficher une colonne pour chaque libellé avec plusieurs valeurs uniques, une ligne pour chaque série temporelle et une valeur numérique telle que "25%".

Les deux widgets sont représentés par la même structure de données. Par conséquent, après avoir ajouté l'un de ces widgets à votre tableau de bord, vous pouvez limiter le nombre de lignes affichées, modifier les colonnes affichées par le tableau et modifier la représentation de la valeur.

La capture d'écran suivante illustre un tableau de bord qui affiche l'utilisation du processeur par les instances de machine virtuelle à l'aide des widgets Top List et Table:

Pour savoir comment ajouter des tables à 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 graphique, dans le volet Affichage, définissez le champ Type de widget sur Table ou Top List.

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

Trier et filtrer des tableaux

Vous pouvez modifier l'ordre des lignes dans le tableau et filtrer le contenu de la table pour n'afficher que des lignes spécifiques. Ces paramètres ne sont pas persistants. Lorsque vous quittez la page du tableau de bord ou lorsque vous l'actualisez, 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 ne lister que certaines lignes, 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 la propriété Name et que vous saisissez la valeur demo, le tableau ne répertorie que les lignes dans lesquelles le champ Name inclut la valeur demo.

Afficher les données les plus récentes avec un avertissement ou un indicateur 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 codée par couleur. Lorsque la valeur la plus récente se situe dans les plages attendues, le widget est de couleur blanche. Lorsque la valeur se trouve dans une plage d'avertissement, le widget devient orange. De même, lorsque la valeur se trouve dans une plage de dangers, 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:

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 Scorecard de base.

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

1. Dans le panneau de navigation de la console Google Cloud, sélectionnez Monitoring, puis  Tableaux de bord :

   Accédez à Tableaux de bord.

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 Add widget (Ajouter un widget), sélectionnez  Métrique.

5. Spécifiez les données à afficher dans le graphique. Vous pouvez utiliser une interface pilotée par menu, le langage MQL (Monitoring Query Language), PromQL, ou saisir un filtre Monitoring:

   Interface basée sur des menus

   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 filtres . Par exemple, si vous saisissez util, vous restreignez le menu pour afficher les entrées qui incluent 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 celles sans données, cliquez sur Active. Par défaut, les menus n'affichent que les types de métriques avec des données.

         Par exemple, vous pouvez 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 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 Filtrer les données représentées graphiquement.

      Pour en savoir plus, consultez Sélectionner les données à représenter dans le 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 votre requête dans l'éditeur de requête. Vous devez vous assurer que les champs d'agrégation sont configurés de manière à combiner toutes les séries temporelles. Par exemple, pour représenter l'utilisation du processeur par les 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:

      • Présentation de MQL
      • Utiliser l'éditeur de code

   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 votre requête dans l'éditeur de requête. Par exemple, pour représenter l'utilisation moyenne du processeur par les 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 section PromQL dans Cloud Monitoring.

   Filtre de surveillance

   1. Dans l'élément Metric (Métrique), cliquez sur Help (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), ces paramètres sont affichés 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 Display (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 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 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 qui ne sont 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, développez le menu des options, puis sélectionnez le style d'affichage.

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

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

Étapes suivantes

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

• Graphiques d'alerte et incidents
• Entrées de journal
• Texte descriptif
• Objectifs de niveau de service (SLO) pour un ensemble de services

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

• Explorer les données représentées graphiquement
• Filtrer un tableau de bord personnalisé