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 consulter l'utilisation du processeur d'une machine virtuelle (VM), vous pouvez utiliser l'Explorateur de métriques afin de créer un graphique affichant les données les plus récentes.

Vous pouvez créer des graphiques simples, comme ceux qui représentent un seul type de métrique, et des graphiques complexes, comme 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 le partager.

La capture d'écran ci-dessous présente un seul type de métrique, l'utilisation du processeur d'une instance de VM, représentée sur la page Explorateur de métriques:

Métrique représentée dans le graphique avec l'explorateur de métriques.

La capture d'écran précédente montre trois lignes, chaque ligne montre les données de séries temporelles pour une VM spécifique.

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

Pour configurer un graphique afin d'afficher une seule métrique à l'aide de l'explorateur de métriques, procédez comme suit:

  1. Dans Cloud Console, sélectionnez Monitoring ou cliquez sur le bouton suivant :
    Accéder à Monitoring

  2. Dans le volet de navigation, sélectionnez  Explorateur de métriques.

  3. Dans la barre d'outils, sélectionnez l'onglet Explorateur.

  4. Spécifiez les données que vous souhaitez faire apparaître dans le graphique. Pour utiliser une interface basée sur un menu ou définir un filtre Monitoring, sélectionnez l'onglet Configuration. Pour utiliser le langage MQL (Monitoring Query Language), sélectionnez l'onglet MQL.

    Onglet "Configuration"

    Pour configurer un graphique, procédez comme suit:

    1. Sélectionnez les données de séries temporelles que vous souhaitez afficher.
    2. (Facultatif) Regrouper et aligner les séries temporelles

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

    Pour sélectionner une ressource et une métrique, procédez de l'une des façons suivantes:

    • Pour graphiquer un type de métrique, tel que l'utilisation du processeur d'une VM, procédez comme suit:

      1. Développez le menu Sélectionner une métrique.
      2. (Facultatif) Pour limiter le nombre de choix, saisissez le nom de la métrique ou de la ressource dans la barre de filtre. Par exemple, pour représenter la latence d'une requête sur une instance de VM, vous pouvez saisir "Latency&quot.
      3. Utilisez les menus pour sélectionner une ressource et une métrique spécifiques. Par exemple, vous pouvez définir 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 de requête.
        4. Cliquez sur Appliquer.
      4. (Facultatif) Pour spécifier un sous-ensemble de données à afficher, 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 représenter un objectif de niveau de service ou le nombre de processus exécutés sur des VM, saisissez un filtre Monitoring:

      1. Cliquez sur Aide dans le menu Sélectionner une métrique.
      2. Sélectionnez Mode de filtrage direct.
      3. Saisissez un filtre Monitoring dans la zone de texte.

    Pour plus d'informations, consultez Sélectionner des métriques lors de l'utilisation de l'explorateur de métriques.

    (Facultatif) Regrouper et aligner les séries temporelles

    • Pour afficher chaque série temporelle, laissez les champs Group By (Grouper par) et Aggregator (Agrégateur) vides.
    • Pour regrouper des séries temporelles par libellé, utilisez le champ Grouper par. La sélection d'une valeur pour ce champ sélectionne automatiquement une valeur dans le champ Agrégateur.
    • Pour indiquer comment combiner les séries temporelles, définissez le champ Agrégateur. Par exemple, si le champ Grouper par est vide et que le champ Agrégateur est défini sur mean, le graphique affiche la moyenne de la série temporelle.
    • Pour configurer le traitement d'une série temporelle individuelle, sélectionnez Options avancées.

    Pour en savoir plus, consultez Afficher le graphique.

    Onglet "MQL"

    Saisissez votre requête dans l'éditeur de requête. Par exemple, pour représenter l'utilisation du processeur par les instances de VM dans 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
    

    Vous trouverez ci-dessous des informations sur le format MQL:

  5. Si vous avez graphiquement un type de métrique de quota ou un type de métrique de type Distribution, modifiez le style du graphique et le paramètre de contrôle du temps. Pour les autres types de métriques, la modification des valeurs par défaut est facultative.

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

    • Définissez le contrôle du temps sur au moins une semaine, car ces métriques génèrent généralement un échantillon par jour.
    • Dans la barre d'outils de l'explorateur de métriques, sélectionnez Graphique en courbes, puis Graphique en aires empilées dans le menu.

    Pour les types de métriques à valeur de distribution, utilisez les paramètres suivants:

    • Dans la barre d'outils de l'explorateur de métriques, sélectionnez Graphique en courbes, puis Graphique de carte de densité. Pour en savoir plus, consultez Métriques de distribution.
  6. (Facultatif) Pour ajouter un seuil au graphique, n'afficher que les anomalies, comparer les données actuelles aux données antérieures ou modifier le paramètre de couleur, sélectionnez Paramètres. Pour en savoir plus sur les options disponibles, consultez Définir les options de vue.

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

Vous pouvez avoir besoin d'afficher des séries temporelles associées à différents types de métriques sur un même graphique. Par exemple, pour comparer les charges de lecture et d'écriture sur une VM, configurez un graphique pour afficher le nombre d'octets lus et écrits.

Pour représenter plusieurs métriques sous forme graphique, vous devez utiliser l'onglet Configuration. L'interface MQL de l'explorateur de métriques ne permet pas de représenter plusieurs métriques sous forme graphique.

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

  1. Dans Cloud Console, sélectionnez Monitoring ou cliquez sur le bouton suivant :
    Accéder à Monitoring
  2. Dans le volet de navigation, sélectionnez  Explorateur de métriques.
  3. Dans la barre d'outils, sélectionnez l'onglet Explorateur.
  4. Accédez à l'onglet Configuration.
  5. Pour sélectionner une ressource et une métrique, procédez de l'une des façons suivantes:

    • Pour graphiquer un type de métrique, tel que l'utilisation du processeur d'une VM, procédez comme suit:

      1. Développez le menu Sélectionner une métrique.
      2. (Facultatif) Pour limiter le nombre de choix, saisissez le nom de la métrique ou de la ressource dans la barre de filtre. Par exemple, pour représenter la latence d'une requête sur une instance de VM, vous pouvez saisir "Latency&quot.
      3. Utilisez les menus pour sélectionner une ressource et une métrique spécifiques. Par exemple, vous pouvez définir 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 de requête.
        4. Cliquez sur Appliquer.
      4. (Facultatif) Pour spécifier un sous-ensemble de données à afficher, 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 représenter un objectif de niveau de service ou le nombre de processus exécutés sur des VM, saisissez un filtre Monitoring:

      1. Cliquez sur Aide dans le menu Sélectionner une métrique.
      2. Sélectionnez Mode de filtrage direct.
      3. Saisissez un filtre Monitoring dans la zone de texte.

    Pour plus d'informations, consultez Sélectionner des métriques lors de l'utilisation de l'explorateur de métriques.

  6. (Facultatif) Regroupez et alignez les séries temporelles:

    • Pour afficher chaque série temporelle, laissez les champs Group By (Grouper par) et Aggregator (Agrégateur) vides.
    • Pour regrouper des séries temporelles par libellé, utilisez le champ Grouper par. La sélection d'une valeur pour ce champ sélectionne automatiquement une valeur dans le champ Agrégateur.
    • Pour indiquer comment combiner les séries temporelles, définissez le champ Agrégateur. Par exemple, si le champ Grouper par est vide et que le champ Agrégateur est défini sur mean, le graphique affiche la moyenne de la série temporelle.
    • Pour configurer le traitement d'une série temporelle individuelle, sélectionnez Options avancées.

    Pour en savoir plus, consultez Afficher le graphique.

  7. Pour chaque type de métrique supplémentaire:

    1. Sélectionnez Ajouter une métrique.

      La première fois que vous cliquez sur Ajouter une autre métrique, les sélections que vous avez effectuées précédemment s'affichent dans le volet extensible Série temporelle A. En outre, le volet Série temporelle B s'ouvre. Ce volet contient les champs de configuration que vous devez remplir pour représenter sous forme graphique la deuxième métrique.

      La capture d'écran suivante illustre ce comportement:

      Exemple de configuration de l'explorateur de métriques avec deux métriques

    2. Pour spécifier la métrique à ajouter au graphique, utilisez les options de configuration dans le nouveau volet. Par exemple, pour la deuxième métrique, utilisez les champs du volet Série temporelle B.

Représenter un ratio sous forme de métriques

Le contrôle du nombre d'erreurs signalées peut être utile. Cependant, il est plus probable que vous deviez surveiller le taux d'erreurs. C'est-à-dire que vous souhaitez connaître le nombre d'erreurs mesurées par rapport au nombre total de réponses. Pour respecter cette exigence, vous pouvez configurer un graphique afin d'afficher le ratio de deux métriques. Pour obtenir des références et des informations sur les anomalies pouvant survenir lorsque vous graphiquez les ratios des métriques, consultez la section Ratios des métriques.

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

  1. Dans Cloud Console, sélectionnez Monitoring ou cliquez sur le bouton suivant :
    Accéder à Monitoring

  2. Dans le volet de navigation, sélectionnez  Explorateur de métriques.

  3. Dans la barre d'outils, sélectionnez l'onglet Explorateur.

  4. Spécifiez les données que vous souhaitez faire apparaître dans le graphique. Pour utiliser une interface basée sur un menu ou définir un filtre Monitoring, sélectionnez l'onglet Configuration. Pour utiliser le format MQL, sélectionnez l'onglet MQL:

    Onglet "Configuration"

    1. Configurez le numérateur:

      1. Pour sélectionner une ressource et une métrique, utilisez les menus.
      2. (Facultatif) Pour restreindre les séries temporelles affichées, ajoutez des filtres.
      3. (Facultatif) Mettez à jour les champs et les paramètres d'alignement.
    2. Sélectionnez Ajouter une métrique.

      Lorsque vous cliquez sur Ajouter une métrique, les sélections que vous avez effectuées précédemment s'affichent dans le volet Série temporelle A. En outre, le volet Série temporelle B s'ouvre. Ce volet contient les champs de configuration que vous devez remplir pour représenter sous forme graphique la deuxième métrique.

      La capture d'écran suivante illustre ce comportement:

      Exemple de configuration de l'explorateur de métriques avec deux métriques

    3. Configurez le dénominateur:

      1. Pour sélectionner une ressource et une métrique pour le dénominateur, utilisez les menus du volet Série temporelle B.

        Vous devez utiliser le même type de métrique pour les deux. Par exemple, si la métrique Série A-B est une métrique GAUGE, la métrique que vous sélectionnez pour la série temporelle B doit être une métrique GAUGE.

      2. (Facultatif) Pour restreindre les séries temporelles affichées, ajoutez des filtres.

      3. Assurez-vous que la valeur du champ Période d'alignement minimale est identique pour les deux métriques.

      4. Définissez les paramètres de regroupement pour la deuxième statistique.

        Nous vous recommandons de faire en sorte que les champs de regroupement de la deuxième métrique correspondent aux valeurs de la colonne Time Series-A (Série A). Par exemple, vous pouvez regrouper les deux métriques selon le libellé zone.

        Il n'est pas nécessaire d'utiliser le même regroupement pour les deux métriques. Toutefois, vous ne pouvez regrouper que les libellés communs aux deux métriques.

    4. Activez Afficher les métriques en tant que ratio.

      Lorsque vous sélectionnez cette option, le libellé Série A-A est renommé Numérateur et le libellé Série B-B est renommé Dénominateur.

    5. (Facultatif) Pour modifier la statistique utilisée pour le numérateur, cliquez sur Remplacer le numérateur.

    6. (Facultatif) Développez Afficher les options de ratio afin de configurer les options d'agrégation secondaire.

    Onglet "MQL"

    Saisissez votre requête dans l'éditeur de requête. Par exemple, pour représenter l'utilisation du processeur par les instances de VM dans 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
    

    Vous trouverez ci-dessous des informations sur le format MQL:

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 de l'explorateur de métriques, le graphique est supprimé.

Pour enregistrer un graphique que vous avez configuré avec l'explorateur de métriques pour référence ultérieure, ajoutez le graphique à un tableau de bord personnalisé ou enregistrez l'URL du graphique:

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

    • Si vous utilisez Google Cloud Console pour gérer vos tableaux de bord personnalisés, sélectionnez Enregistrer le graphique dans la barre d'outils de l'explorateur de métriques, puis remplissez la boîte de dialogue. Vous pouvez enregistrer le graphique dans un tableau de bord personnalisé existant ou créer un tableau de bord.

    • Si vous utilisez l'API Cloud Monitoring pour gérer vos tableaux de bord personnalisés, mettez à jour le fichier JSON qui définit le tableau de bord et son contenu. Vous pouvez accéder à la représentation JSON depuis le menu Plus d'options situé dans la barre d'outils de l'explorateur de métriques.

      Pour en savoir plus sur l'utilisation de l'API pour gérer vos tableaux de bord personnalisés, consultez Gérer les tableaux de bord à l'aide de l'API.

  • Pour conserver une référence à la configuration du graphique, enregistrez son URL. L'URL du graphique encode la configuration du graphique. Lorsque vous collez cette URL dans un navigateur, le graphique que vous avez configuré s'affiche.

    Pour obtenir l'URL du graphique, sélectionnez Plus d'options dans la barre d'outils de l'explorateur de métriques, puis sélectionnez Partager par URL.

Enregistrer la configuration d'un graphique

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

  • Pour générer la représentation JSON d'un graphique que vous prévoyez d'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é avec l'API Cloud Monitoring, configurez le graphique à l'aide de l'interface de l'explorateur de métriques, basée sur un menu. Après avoir sélectionné la métrique et les filtres, passez en mode de filtrage direct pour afficher le filtre Monitoring équivalent.

Étapes suivantes