Sélectionner des données à représenter sous forme de graphique

Cette page explique comment spécifier les données à afficher dans un graphique. Pour en savoir plus sur la configuration du style d'un graphique, consultez la page Définir les options d'affichage.

Sélectionner les données à afficher

Pour renseigner le graphique, vous devez spécifier au moins une paire de valeurs :

  • Le champ metric identifie les mesures à collecter à partir d'une ressource surveillée. Il inclut une description de ce qui est mesuré et de la manière dont ces mesures sont interprétées. Métrique est une forme abrégée de type de métrique. Pour obtenir des informations conceptuelles à ce sujet, consultez la section Types de métriques.

  • Le champ Resource type (Type de ressource) spécifie la ressource à partir de laquelle les données de métriques sont capturées. Le type de ressource est parfois appelé type de ressource surveillée ou ressource. Pour obtenir des informations conceptuelles, consultez la page Ressources surveillées.

Monitoring propose un grand nombre de types de métriques prédéfinis et de ressources surveillées. Vous pouvez également créer des métriques personnalisées :

Champ de spécification des métriques

Lorsque vous faites glisser un widget de la bibliothèque de widgets vers la zone du graphique, un graphique s'affiche avec un type de ressource et une métrique présélectionnés :

Exemple de graphique en courbes nouvellement créé.

Vous pouvez spécifier les données à représenter sous forme de graphique de différentes manières :

  • Pour configurer rapidement un graphique, utilisez le mode Basique. Ce mode dispose d'options de configuration minimales. Une configuration de base peut toujours être représentée dans les autres modes. Pour en savoir plus, consultez Utiliser le mode de base ou avancé.

  • Pour accéder à tous les champs de configuration du graphique, utilisez le mode Avancé. Ce mode permet d'accéder à la plupart des champs d'agrégation. Pour en savoir plus, consultez Utiliser le mode de base ou avancé.

    .
  • Pour saisir un filtre Monitoring, consultez la section Mode de filtrage direct.

  • Pour configurer un graphique à l'aide d'un langage de requête, utilisez le mode MQL. Ce mode vous permet d'accéder à l'éditeur de requête. Si vous utilisez MQL, cette configuration ne peut pas être représentée par les autres modes. Pour en savoir plus sur le langage MQL, consultez la présentation du langage MQL.

Utiliser le mode de base ou avancé

Le menu Resource type (Type de ressource) répertorie toutes les ressources surveillées pour lesquelles des données de métriques sont disponibles. Le menu Métrique est déterminé par la sélection du type de ressource.

  • Pour rechercher une entrée spécifique dans un menu, utilisez la barre de défilement ou saisissez du texte dans la zone Filtre  du menu. Lorsque vous saisissez du texte, les entrées du menu sont limitées à celles incluant le texte saisi.

    La capture d'écran suivante présente le menu développé du champ Metric (Métrique). La barre de filtre contient le texte lat. Par conséquent, ce menu ne répertorie que les entrées incluant cette chaîne :

    Affichage de la barre de filtre des métriques.

    Notez que dans la capture d'écran précédente, la métrique Late Boot Validation est mise en surbrillance. Lorsque vous placez votre pointeur sur une entrée, un volet s'ouvre et affiche des informations détaillées sur cette métrique. Comme illustré, ce volet répertorie, entre autres, le genre de la métrique, le type de valeur et le champ de description.

Si vous souhaitez accéder à un type de ressource ou à une métrique qui ne contient pas encore de données, vous devez modifier le comportement par défaut :

  • Pour pouvoir sélectionner n'importe quel type de ressource, développez le menu Type de ressource, puis désélectionnez Afficher uniquement les ressources actives.

  • Pour afficher toutes les métriques du type de ressource sélectionné, même celles qui ne comportent pas de données, développez le menu Métrique, puis désélectionnez Afficher uniquement les métriques actives.

  • Pour pouvoir sélectionner n'importe quelle métrique, cliquez sur Fermer dans le menu Type de ressource, puis recherchez l'entrée qui vous intéresse. (Installation de Python groupée). En cliquant sur "Fermer" sur le type de ressource, le menu Métrique inclut toutes les métriques.

  • Pour afficher ou modifier les paramètres de type de ressource, de métrique et de filtre utilisés par l'API Cloud Monitoring, dans la sectionResource type (Type de ressource) cliquez sur Mode de filtrage direct (Installation de Python groupée).

Utiliser le mode de filtrage direct

Utilisez le mode de filtrage direct lorsque vous souhaitez afficher un graphique de l'un des éléments suivants:

  • Un objectif de niveau de service (SLO, Service Level Objective).
  • Nombre de processus s'exécutant sur des machines virtuelles (VM).
  • Métrique personnalisée pour laquelle vous ne disposez pas encore de données.

Lorsque vous utilisez le mode de filtrage direct, vous saisissez un filtre Monitoring qui spécifie la série temporelle à représenter graphiquement. Le filtre Monitoring suivant montre le graphique affichant les entrées de journal de toutes les instances de machine virtuelle Google Cloud de la zone us-east1-b:

metric.type="logging.googleapis.com/log_entry_count"
resource.type="gce_instance" resource.label."zone"="us-east1-b"

Pour saisir un filtre Monitoring, procédez comme suit:

  1. Sélectionnez le mode Basique ou Avancé.
  2. Dans le menu Type de ressource, cliquez sur Mode de filtrage direct.

Filtrer les données représentées graphiquement

Vous pouvez réduire la quantité de données à représenter sous forme de graphique en spécifiant des critères de filtrage, en appliquant une agrégation ou en utilisant le mode "Anomalies". Les filtres permettent de s'assurer que seules les séries temporelles répondant à un ensemble de critères sont utilisées. Si vous appliquez des filtres, le graphique comporte moins de lignes, ce qui peut améliorer ses performances.

Si vous indiquez plusieurs critères de filtrage, le graphique correspondant n'affiche que les séries temporelles qui répondent à tous les critères, à savoir une valeur logique AND. En règle générale, vous pouvez filtrer par groupe de ressources, par nom, par libellé de ressource, par zone et par libellé de métrique.

Si vous sélectionnez le mode MQL, utilisez l'éditeur de requête pour spécifier le filtre.

Pour ajouter un filtre lorsque vous sélectionnez le mode Basique ou Avancé, cliquez sur Ajouter un filtre, puis spécifiez le libellé de filtre. La comparaison, ainsi que la valeur ou la plage de valeurs:

  1. Cliquez sur Libellé, puis sélectionnez une entrée dans le menu.

    Pour rechercher un libellé spécifique, vous pouvez utiliser la barre de défilement ou saisir du texte dans la zone de texte Filtre . Lorsque vous saisissez du texte, le menu ne répertorie que les entrées qui contiennent le texte saisi.

    La capture d'écran suivante montre les libellés de filtrage connus d'une métrique spécifique :

    Exemple de liste de libellés de filtrage.

  2. Cliquez sur Comparison (Comparaison), puis sélectionnez une entrée dans le menu. Vous avez le choix entre quatre opérateurs : est égal à =, différent de, !=, correspondance d'expression régulière, =~ et expression régulière ne correspond pas, !=~:

    Liste des comparateurs de filtres.

  3. Cliquez sur Valeur, puis effectuez l'une des opérations suivantes :

    • Si vous avez sélectionné une comparaison directe, = ou !=, sélectionnez-la dans le menu ou saisissez une valeur, puis cliquez sur OK. Les valeurs saisies peuvent être simples, telles que us-central1-a, ou vous pouvez créer une chaîne de filtre commençant par starts_with ou ends_with. Par exemple, pour afficher les données d'une zone us-central1, vous pouvez saisir la chaîne de filtre starts_with("us-central1"). Pour plus d'informations sur les chaînes de filtre, consultez la section Filtres de surveillance.

      Comme les entrées de menu sont dérivées de la série temporelle reçue, si une ressource surveillée ne génère pas de données pour la métrique sélectionnée, vous devez saisir une valeur pour le libellé.

      La capture d'écran suivante montre le menu de valeurs affiché pour un projet particulier lorsque le libellé de ressource zone est sélectionné :

      Exemple de liste de libellés de filtrage.

    • Si vous avez sélectionné une comparaison d'expressions régulières, =~ ou !=~, saisissez une expression régulière RE2 dans le champ Valeur, puis cliquez sur OK. Par exemple, l'expression régulière us-central1-.* correspond à toutes les zones us-central1.

      Pour trouver une zone se terminant par "a", vous pouvez utiliser l'expression régulière ^us.*.a$.

      Vous ne pouvez pas utiliser d'expressions régulières pour filtrer le libellé de ressource project_id.

      Par exemple, si vous souhaitez afficher uniquement la série temporelle de l'une des zones us-central1, appliquez un filtre zone="starts_with("us-central1")" ou zone=~"us-central1.*" :

      Affichage d'une série temporelle filtrée.

Vous pouvez spécifier plusieurs critères de filtre et utiliser le même libellé plusieurs fois. Ces fonctionnalités vous permettent de spécifier un filtre pour une plage de valeurs. Tous les critères de filtre doivent être remplis. elles constituent une valeur logique AND. Par exemple, la configuration suivante vous permet d'utiliser les chaînes de filtre starts_with et ends_with pour n'afficher que les zones "a" aux États-Unis :

Exemple utilisant plusieurs filtres.

Choisir le mode d'affichage des données représentées graphiquement

Une fois les séries temporelles sélectionnées, l'étape suivante consiste à déterminer comment ces données sont affichées. Par exemple, voulez-vous afficher chaque série temporelle ou souhaitez-vous combiner des séries temporelles ?

Vous spécifiez comment sont affichées les données en configurant les options d'agrégation. L'agrégation consiste à aligner les données de séries temporelles, puis à combiner différentes séries temporelles. La combinaison des séries temporelles est facultative.

Pour obtenir une explication détaillée de l'agrégation, consultez la page Filtrage et agrégation : manipuler des séries temporelles.

Aligner les données

L'alignement est le processus de conversion des données de séries temporelles reçues par Monitoring en une nouvelle série temporelle comportant des points de données à intervalles fixes. Le processus d'alignement consiste à collecter tous les points de données reçus dans un délai fixe, appliquer une fonction pour combiner ces points de données et attribuer un horodatage au résultat. Cette fonction de combinaison peut calculer la moyenne de tous les échantillons ou peut extraire le maximum de tous les échantillons.

La durée d'alignement spécifie l'intervalle de temps minimal à utiliser lors de l'alignement des données de séries temporelles. Lorsque de trop nombreux points de données doivent être représentés sur le graphique pendant la période d'affichage sélectionnée, la période d'alignement est automatiquement augmentée pour que chaque point de données soit représenté. Le paramètre par défaut de ce champ est 1 minute.

Prenons l'exemple d'une métrique dont la période d'échantillonnage est d'une minute. Si un graphique est configuré pour afficher une heure de données, il peut afficher les 60 points de données. Si la période d'alignement est définie sur 10 minutes, le graphique affiche six points de données. Toutefois, si vous configurez le graphique pour qu'il affiche une semaine de données, le nombre de points à afficher est trop élevé. Par conséquent, la période est automatiquement modifiée. Dans cet exemple, la période d'alignement modifiée est d'une heure.

Le champ Alignement spécifie la fonction utilisée pour combiner tous les points de données sur une période d'alignement. La plupart des aligneurs effectuent des opérations mathématiques courantes. Par exemple, si vous sélectionnez min, le point de données aligné correspond au minimum de tous les points de données pendant la période d'alignement. Certains aligneurs réalisent des opérations plus complexes :

  • Suivant le plus ancien: pour ne conserver que l'échantillon le plus récent au cours d'une période d'alignement, utilisez l'aligneur plus ancien. Cet aligneur est couramment utilisé avec les tests de disponibilité et représente un bon choix lorsque vous vous intéressez uniquement à la valeur la plus récente.

    Cet aligneur n'est valide que pour les métriques de jauge.

  • percentile : pour afficher une métrique de distribution sur un graphique en courbes, en aires empilées ou à barres empilées, vous devez sélectionner le centile de la distribution à afficher. Pour spécifier ce centile, vous pouvez sélectionner un aligneur de type "percentile". Vous pouvez choisir parmi les 5e, 50e, 95e et 99e centiles. Le point de données aligné est déterminé en calculant le centile spécifié en utilisant tous les points de données de la période d'alignement.

    Cet aligneur n'est valide que pour les métriques de jauge et les métriques delta lorsqu'elles possèdent un type de données de distribution.

  • delta : utilisez cet aligneur pour convertir une métrique cumulative ou une métrique delta en métrique delta avec un échantillon par période d'alignement. Cet aligneur peut entraîner l'interpolation des données. Pour obtenir un exemple, consultez la section Genres, types et conversions.

    Cet aligneur n'est valide que pour les métriques cumulatives et les métriques delta.

  • rate : utilisez cet aligneur pour convertir une métrique cumulative ou delta en métrique de jauge. Si vous choisissez cet aligneur, vous pouvez considérer que la série temporelle est transformée de la même manière qu'avec un aligneur delta, puis divisée par la période d'alignement. Par exemple, si l'unité de la série temporelle d'origine est Mio et que l'unité de la période d'alignement est la seconde, le graphique présente une unité de Mio/seconde. Pour en savoir plus, consultez la section Genres, types et conversions.

    Cet aligneur n'est valide que pour les métriques cumulatives et les métriques delta.

Pour en savoir plus sur les aligneurs disponibles, consultez la section Aligner dans la documentation de référence de l'API.

Pour accéder aux champs d'alignement, procédez comme suit :

  • Mode Basique : tous les champs d'alignement sont préconfigurés.

  • Mode Avancé : toutes les options d'alignement sont accessibles une fois que vous avez sélectionné le type de ressource et la métrique. Les valeurs par défaut de ces champs sont fournies. Vous pouvez cependant modifier les sélections.

  • Mode MQL : toutes les options d'alignement sont disponibles.

La capture d'écran suivante illustre l'utilisation du processeur par les instances de VM Compute Engine dans un projet Google Cloud particulier. Dans cette image, les champs d'alignement possèdent des valeurs par défaut : la fonction d'alignement est définie sur mean et la période d'alignement sur 1 minute :

Utilisation du processeur par les instances de VM en utilisant les paramètres d'alignement par défaut.

À des fins de comparaison, la capture d'écran suivante montre les effets du passage de la période 1 minute à 5 minutes :

Utilisation du processeur par les instances de VM en utilisant les paramètres par défaut avec une période d'alignement de cinq minutes

En augmentant la période, le graphique obtenu comporte moins de points, passant de 60 à 10 points par série temporelle. Chaque point du graphique est calculé en faisant la moyenne des points de la série temporelle au cours d'une période d'alignement. À mesure que la période d'alignement augmente, la moyenne des points supplémentaires est calculée, ce qui a un effet lissé sur les données tracées.

Combiner les séries temporelles

Vous pouvez réduire le volume de données renvoyées pour une métrique en combinant différentes séries temporelles. Pour combiner plusieurs séries temporelles, vous devez généralement spécifier un groupe et une fonction. Le regroupement est effectué en fonction des valeurs de libellés. La fonction définit la façon dont toutes les données de séries temporelles d'un groupe sont combinées dans une nouvelle série temporelle.

Pour regrouper et combiner des séries temporelles, effectuez l'une des opérations suivantes :

  • Mode de base :

    1. Déterminez comment regrouper les séries temporelles :

      • Pour afficher toutes les séries temporelles, laissez l'option Groupé vide.
      • Pour regrouper les séries temporelles par valeurs de libellé, sélectionnez Groupé, puis utilisez le menu Grouper par pour sélectionner les libellés à regrouper. Une fois les sélections effectuées, cliquez sur OK.
    2. Déterminez comment combiner les points de données :

      • Si les cases d'option ne répertorient que les centiles, vous avez sélectionné une métrique ayant une valeur de distribution. Utilisez les cases d'option pour sélectionner le centile de la distribution à afficher.

      • Si les cases d'option répertorient mean, min et max, vous avez sélectionné une métrique avec une valeur numérique. Utilisez ces cases d'option pour spécifier la façon dont les points de données sont combinés dans le cadre du processus de création d'un graphique. Pour comprendre le fonctionnement de ces options de combinaison, supposons qu'un graphique peut afficher 60 points de données et que le taux de données est d'un point par minute. Si vous affichez une heure de données, le graphique peut afficher chaque point. Toutefois, si vous souhaitez afficher trois heures de données, vous devez diminuer le nombre de points de données de 180 à 60, ce qui correspond au nombre de points que le graphique peut afficher. Vous pouvez limiter les données en calculant la moyenne de trois échantillons adjacents ou en prenant leur valeur minimale.

  • Mode avancé :

    • Pour combiner toutes les données de séries temporelles en une seule série temporelle, assurez-vous que Grouper par est vide et sélectionnez la manière dont les séries temporelles sont combinées à l'aide de la fonction Grouper par fonction.

    • Pour afficher toutes les données de séries temporelles, effectuez l'une des opérations suivantes:

      • Assurez-vous que le champ Grouper par est vide et sélectionnez none pour le paramètre Grouper par fonction.
      • Cliquez sur le menu Grouper par, sélectionnez Tout ajouter, puis sélectionnez Grouper par fonction. La fonction de regroupement des métriques stockant une valeur numérique peut ne pas générer un graphique nettement différent.
    • Pour regrouper des séries temporelles par valeur de libellé spécifique, cliquez sur Grouper par, puis sélectionnez les libellés à regrouper. Pour spécifier la façon dont les séries temporelles sont combinées, sélectionnez une fonction à l'aide du menu Grouper par fonction.

  • Mode MQL :

    Pour en savoir plus sur le langage MQL, consultez la page Utiliser l'éditeur de requête.

La capture d'écran suivante montre un regroupement par user_labels.version, avec la fonction de regroupement définie sur la valeur par défaut de sum. Cette sélection génère une série temporelle pour chaque valeur de user_labels.version. Les points de données de chaque série temporelle sont calculés à partir de la somme de toutes les valeurs de chaque série temporelle pour une version spécifique :

Affichage des séries temporelles regroupées par user_labels.version

Vous pouvez effectuer un regroupement d'après plusieurs étiquettes. Lorsque vous disposez de plusieurs options de regroupement, la fonction de regroupement est appliquée à l'ensemble de séries temporelles ayant les mêmes valeurs pour les libellés sélectionnés.

Le graphique obtenu affiche une série temporelle pour chaque combinaison de valeurs de libellé. L'ordre dans lequel vous spécifiez les libellés n'a pas d'importance.

Par exemple, la capture d'écran suivante montre un regroupement par user_labels.version et system_labels.machine_image :

Affichage des séries temporelles regroupées par version et image de machine.

Comme illustré, si vous regroupez par libellé, vous obtenez une série temporelle pour chaque paire de valeurs. Le fait d'obtenir une série temporelle pour chaque combinaison de libellés implique que cette technique a facilement tendance à créer plus de données qu'il n'est utile d'en afficher sur un seul graphique.

Si vous spécifiez un regroupement ou si vous sélectionnez une fonction de regroupement, la série temporelle représentée sur le graphique ne contient que les libellés requis, tels que l'identifiant du projet, et les libellés spécifiés par le regroupement.

Supprimer des conditions de regroupement

Pour supprimer toutes les conditions de regroupement, effectuez l'une des opérations suivantes :

  • Mode de base: effacez les données groupées.

  • Mode Avancé : procédez comme suit :

    1. Dans le menu Grouper par, cliquez sur Tout supprimer, puis sur OK.
    2. Dans le menu Group by function (Fonction de regroupement), sélectionnez none.
  • Mode MQL : supprimez les commandes de regroupement.

    Pour en savoir plus sur le langage MQL, consultez la page Utiliser l'éditeur de requête.

Agrégation secondaire

L'onglet que vous sélectionnez détermine les options d'agrégation:

  • Modes de base et avancé : l'éditeur de tableau de bord détermine comment mapper les sélections d'agrégation aux champs d'agrégation principal et secondaire spécifiés par Cloud Monitoring. API en utilisant les informations suivantes:

    • Type de widget
    • Genre de métrique
    • Type de valeur de la métrique
    • Mode permettant de configurer le widget

    Pour définir ce mappage de graphiques dans des tableaux de bord personnalisés, vous pouvez récupérer la configuration du tableau de bord à l'aide de l'outil de ligne de commande gcloud. Pour en savoir plus, consultez la section Répertorier les tableaux de bord.

  • Mode MQL : ces champs sont accessibles.

Étape suivante