Créer des graphiques avec l'Explorateur de métriques

Ce document explique comment explorer les données de métriques en créant un graphique temporaire avec l'Explorateur de métriques. Par exemple, pour afficher le CPU d'une machine virtuelle (VM), vous pouvez utiliser l'Explorateur de métriques créer un graphique qui affiche les données les plus récentes. Si vous souhaitez conserver graphiques, vous pouvez créer un graphique à l'aide de l'Explorateur de métriques l'enregistrer dans un tableau de bord personnalisé. Une autre solution consiste à créer un tableau de bord personnalisé, qui peut afficher des graphiques, des journaux, des incidents et d'autres contenus, puis utiliser pour ajouter des graphiques à ce tableau de bord. Pour en savoir plus sur les tableaux de bord personnalisés, consultez Créer et gérer des tableaux de bord personnalisés

Vous pouvez créer des graphiques pour un seul type de métrique, et des graphiques complexes, tels que ceux qui représentent plusieurs types de métriques. Après avoir créé un graphique avec l'Explorateur de métriques, vous pouvez le supprimer, l'enregistrer dans un tableau de bord personnalisé, enregistrer sa configuration ou la partager.

La capture d'écran suivante montre un seul type de métrique (Utilisation du processeur d'une instance de VM) représentée Page Metrics Explorer (Explorateur de métriques) :

La capture d'écran précédente montre plusieurs lignes, chacune indiquant la moyenne Utilisation du processeur pour toutes les VM d'une zone spécifique.

Représenter un seul type de métrique sous forme graphique

Pour configurer un graphique afin d'afficher une seule métrique, procédez comme suit:

1. Dans la console Google Cloud, accédez à la page leaderboardExplorateur de métriques :

   Accéder à l'explorateur de métriques

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

2. Spécifiez les données à afficher sur le graphique. Vous pouvez utiliser un via un menu, le langage MQL (Monitoring Query Language), PromQL, ou vous pouvez saisir Filtre de surveillance:

   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 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 filter_list 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 celles sans données, cliquez sur done 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 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 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 add 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é code MQL ou code 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 le graphique "Utilisation du processeur" des instances de VM de 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
      

      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é code MQL ou code 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 help_outline Aide, puis sélectionnez Direct Filter Mode (Mode de filtrage direct).

      Les éléments Metric et Filter sont supprimés, ainsi qu'un élément Filters. 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 du 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 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 add 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. Mettez à jour les paramètres du graphique en fonction du type de métrique sélectionné:

   • Pour les types de métriques de quota, utilisez les paramètres suivants:

     • Dans la barre d'outils, définissez la commande temporelle sur au moins une semaine. Quota les métriques enregistrent généralement un échantillon par jour.
     • Dans le volet Affichage, développez la section Type de widget. puis sélectionnez Graphique à barres empilées.

   • Pour les types de métriques associés à un Distribution assurez-vous que le menu Type de widget est défini sur Carte de densité. Pour en savoir plus, consultez À propos des métriques basées sur la distribution

   • Pour les autres types de métriques, utilisez le menu Type de widget afin d'afficher la manière les données s'affichent. Le menu Type de widget répertorie tous les types de widgets Types de widgets Toutefois, certains widgets peuvent ne pas être activés. Prenons l'exemple d'un graphique qui affiche plusieurs séries temporelles et partez du principe que chaque valeur mesurée est un double:

     • Graphique en courbes, Graphique à barres empilées et Graphique en aires empilées widgets sont listés comme Compatibles. Vous pouvez sélectionner l'un de ces types.
     • Le widget Carte de densité est désactivé, car ces widgets ne peuvent s'afficher de données à distribution unique.

4. 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 le mode "Rayon X" ou les statistiques, cliquez sur arrow_drop_down Mode d'analyse.
   • Pour comparer les données actuelles aux anciennes : cliquez sur arrow_drop_down Comparer à une période antérieure.
   • Pour ajouter un seuil de référence, cliquez sur arrow_drop_down Ligne de seuil.
   • Pour configurer le nom d'une colonne de légende, procédez comme suit : cliquez sur arrow_drop_down Alias de légende.
   • Pour configurer l'affectation de l'axe Y, les étiquettes ou échelle, utilisez la méthode Menus Affectation de l'axe Y, Libellés de l'axe Y et Échelle de l'axe Y

Représenter plusieurs types de métriques sous forme graphique

Dans certains cas, il se peut que vous souhaitiez afficher des séries temporelles types de métriques sur le même graphique. Par exemple, pour comparer les opérations de lecture et d'écriture sur une VM, configurez un graphique pour afficher le nombre d'octets et le nombre d'octets écrits.

Pour représenter plusieurs métriques sous forme de graphique, vous devez utiliser l'interface basée sur un menu. L'autre ne permettent pas de représenter plusieurs métriques sous forme graphique.

Pour afficher plusieurs métriques dans un graphique, procédez comme suit:

1. Dans la console Google Cloud, accédez à la page leaderboardExplorateur de métriques :

   Accéder à l'explorateur de métriques

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

2. Spécifiez les données à afficher sur le graphique.

   Interface basée sur des menus

   1. Dans l'élément Métrique, puis sélectionnez premier type de métrique dont vous souhaitez afficher les données. Pour en savoir plus sur ces étapes, consultez Présentez un seul type de métrique sous forme de graphique.

      La requête associée à cette sélection possède l'identifiant A.

   2. Pour chaque type de métrique supplémentaire, procédez comme suit:

      1. Sélectionnez Ajouter une requête. Une nouvelle requête est ajoutée. Par exemple, une requête avec le paramètre l'étiquette B pourrait ê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:

      

   3. Facultatif: Dans le volet Display (Affichage), développer le menu Axe Y et configurer l'axe Y à utiliser pour chaque type de métrique.

   MQL

   Non compatible

   PromQL

   Non compatible

   Filtre de surveillance

   Non compatible

Représenter graphiquement un ratio de métriques

Il peut être utile de surveiller le nombre d'erreurs signalées : mais il est plus de chances de devoir surveiller le taux d'erreurs. Autrement dit, veulent savoir combien d'erreurs se sont produites par rapport au total le nombre de réponses. Pour répondre à cette exigence, vous pouvez configurer un graphique pour afficher le ratio de deux métriques. Pour les références à des exemples et pour des informations sur les anomalies qui peuvent se produire lorsque vous tracez des ratios de métriques, Voir Ratios de métriques.

Pour afficher un ratio de métriques sur un graphique, procédez comme suit:

1. Dans la console Google Cloud, accédez à la page leaderboardExplorateur de métriques :

   Accéder à l'explorateur de métriques

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

2. Spécifiez les données à afficher :

   Interface basée sur des menus

   1. Configurez le numérateur:

      1. Dans l'élément Métrique, utilisez les menus pour sélectionner une le type de ressource et le type de métrique. Pour en savoir plus sur ces étapes, consultez Présentez un seul type de métrique sous forme de graphique.
      2. Mettez à jour les champs d'agrégation. Par défaut, fait la moyenne de toutes les séries temporelles.
      3. Facultatif: Mettre à jour la durée fixe des points d'une série temporelle à combiner. Pour modifier ce champ, cliquez sur add Ajouter un élément de requête, Sélectionnez Intervalle minimal, puis remplissez les champs de la boîte de dialogue.

   2. Sélectionnez Ajouter une requête, puis configurez le dénominateur:

      1. Pour la nouvelle requête, dans l'élément Métrique, sélectionnez une le type de ressource et le type de métrique.

         Sélectionnez un type de métrique dont le genre est identique au numérateur. Par exemple, si la métrique du numérateur est une métrique GAUGE, alors sélectionnez une métrique GAUGE comme dénominateur.

      2. 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.

      3. Cliquez sur add Ajouter un élément de requête. sélectionnez Intervalle minimal, puis assurez-vous ce champ est défini sur la valeur utilisée par le numérateur.

   3. 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, par rapport au nombre total d'octets écrites sur le disque:

      

   4. Facultatif: Pour inverser 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é code MQL ou code 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:

      • Présentation de MQL
      • Utiliser l'éditeur de code
      • Calculer des ratios

   PromQL

   1. Dans la barre d'outils du volet de création de requêtes, sélectionnez le bouton nommé code MQL ou code 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

Enregistrer un graphique pour référence ultérieure

L'explorateur de métriques vous permet de créer un graphique que vous pouvez utiliser pour explorer une métrique. Toutefois, les graphiques créés par cet outil ne sont pas persistants. Lorsque vous quittez la page "Explorateur de métriques", le graphique est supprimé.

Pour enregistrer un graphique que vous avez configuré avec l'Explorateur de métriques afin de l'enregistrer ultérieurement ajoutez le graphique à un tableau de bord personnalisé ou enregistrez son URL:

• Pour ajouter le graphique à un tableau de bord personnalisé, effectuez l'une des opérations suivantes:

  • Si vous utilisez la console Google Cloud pour gérer vos tableaux de bord personnalisés, Sélectionnez Save Chart (Enregistrer le graphique) dans la barre d'outils de l'Explorateur de métriques. et terminez la boîte de dialogue. Vous pouvez enregistrer le graphique ou créer un tableau de bord personnalisé.

  • Si vous utilisez l'API Cloud Monitoring pour gérer vos tableaux de bord personnalisés, puis mettez à jour le fichier JSON qui définit le tableau de bord et ses contenus. Pour accéder à la représentation JSON, Cliquez sur code Éditeur JSON dans la barre d'outils du graphique.

    Pour plus d'informations sur l'utilisation de l'API pour gérer vos tableaux de bord personnalisés, consultez Créer et gérer des tableaux de bord à l'aide d'API

• Pour conserver une référence à la configuration du graphique, enregistrez l'URL du graphique. Étant donné que l'URL du graphique encode la configuration du graphique, lorsque vous collez URL dans un navigateur où le graphique que vous avez configuré s'affiche.

  Pour obtenir l'URL du graphique, cliquez sur Lien link dans le graphique. barre d'outils.

Enregistrer la configuration d'un graphique

Lorsque vous gérez des tableaux de bord personnalisés à l'aide de l'API Cloud Monitoring, vous peut utiliser l'Explorateur de métriques pour vous aider à créer les données que vous fournissez à l'API:

• À générer la représentation JSON d'un graphique que vous prévoyez pour l'ajouter à un tableau de bord, configurez le graphique avec l'Explorateur de métriques. Vous pouvez ensuite utiliser les options de l'Explorateur de métriques pour afficher et copier la représentation JSON du graphique.

• Pour identifier la syntaxe d'un filtre Monitoring, utilisée avec l'API Cloud Monitoring, utilisez l'interface basée sur un menu de l'Explorateur de métriques pour configurer le graphique. Après avoir sélectionné une métrique et des filtres, passez en mode de filtrage direct ; pour afficher le filtre Monitoring équivalent.

Enregistrer les données affichées par le graphique

Pour enregistrer les données affichées par le graphique sur votre système local, cliquez sur get_app Télécharger au format CSV

Étape suivante

• Explorer les données représentées graphiquement
• Sélectionner des métriques à l'aide de l'Explorateur de métriques
• Affichez et gérez l'utilisation des métriques
• Définir les options d'affichage des graphiques