Sélectionner des métriques lors de l'utilisation de l'explorateur de métriques

Cette page explique comment choisir les données à afficher et leur mode d'affichage lorsque vous utilisez l'explorateur de métriques. 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 spécifier les métriques à afficher lorsque vous utilisez l'explorateur de métriques, cliquez sur l'onglet Métrique de la page de définition du graphique. La capture d'écran suivante illustre l'onglet du sélecteur de métriques :

Affichage de l'onglet de sélection de métriques.

Pour renseigner le champ Find resource type and metric (Rechercher un type de ressource et de métrique), vous devez spécifier au moins une paire de valeurs :

  • Un type de métrique qui identifie les mesures pouvant être collectées à partir d'une ressource surveillée. Il comprend une description de ce qui est mesuré et de la manière dont ces mesures sont interprétées. Le type de métrique est parfois appelé métrique. Pour obtenir des informations conceptuelles à ce sujet, consultez la section Types de métriques.

  • Une ressource surveillée spécifie la ressource en provenance de laquelle les données de métrique sont capturées. La ressource surveillée est parfois appelée type de ressource surveillée ou ressource. Pour obtenir des informations conceptuelles à ce sujet, consultez la section 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

Pour sélectionner une métrique, utilisez le champ Find resource type and metric (Trouver le type de ressource et la métrique) afin de choisir un type de ressource et un type de métrique. Vous pouvez les spécifier dans n'importe quel ordre. Pour commencer, cliquez dans le champ. Une ou deux listes s'affichent, selon les éléments précédemment sélectionnés. Ces listes sont identifiées par les en-têtes Resource types (Types de ressources) et Metrics (Métriques), comme dans cette capture d'écran :

Listes de recherche pour la sélection de métriques et de ressources.

Vous pouvez sélectionner une entrée de deux manières :

  • Sélectionnez cette entrée dans l'une des listes.

  • Saisissez un filtre de métrique. Pour saisir un filtre de métrique, procédez comme suit :

    1. À côté de Find resource type and metric (Rechercher un type de ressource et une métrique), cliquez sur Aide .
    2. Cliquez sur Direct filter mode (Mode de filtrage direct) dans le panneau d'aide.

      Lorsque Direct filter mode (Mode de filtrage direct) est activé, l'option Find resource type and metric (Rechercher un type de ressource et une métrique) est remplacée par une zone de texte modifiable intitulée Resource type, metric, and filter (Type de ressource, métrique et filtre) :

      Le mode de filtrage direct s'affiche.

      Si vous aviez sélectionné un type de ressource, une métrique ou un filtre avant d'activer le Mode de filtrage direct, ces paramètres sont utilisés pour préremplir la zone de texte Resource type, metric, and filter (Type de ressource, métrique et filtre).

    3. Saisissez un filtre de métrique dans la zone de texte Resource type, metric, and filter (Type de ressource, métrique et filtre). Votre filtre doit inclure un type de métrique et un type de ressource. Vous pouvez également inclure des filtres de libellés. Pour en savoir plus sur la syntaxe de filtrage, consultez la page Filtres de surveillance.

      Par exemple, pour afficher les entrées de journal correspondant à l'ensemble des instances de VM Google Cloud dans la zone us-east1-b, saisissez ce qui suit :

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

      Si vous avez utilisé le mode de filtrage direct pour configurer des graphiques ou des règles d'alerte et qu'aucune donnée n'est disponible, le graphique affiche un message d'erreur. Le message d'erreur exact dépend du filtre que vous avez saisi. Par exemple, Chart definition invalid (Définition de graphique non valide) est un message courant. Le message No data is available for the selected time frame. (Aucune donnée disponible pour la fenêtre temporelle sélectionnée) peut également s'afficher.

En passant la souris sur l'une ou l'autre liste, vous obtenez une info-bulle affichant les informations contenues dans le descripteur de l'élément désigné. Pour en savoir plus sur les descripteurs des types de métriques ou des ressources surveillées, consultez la liste des métriques ou la liste des ressources surveillées.

Dès que vous avez sélectionné au moins une paire composée d'un type de ressource et d'une métrique, le graphique affiche toutes les séries temporelles disponibles, et des éléments supplémentaires apparaissent sous la métrique spécifiée dans l'onglet Metric (Métrique). La capture d'écran suivante montre l'onglet Metric (Métrique) après qu'une métrique a été spécifiée :

Affichage d'options de sélection supplémentaires.

La capture d'écran ci-dessous montre le graphique obtenu en fonction de la ressource et de la métrique sélectionnées, sans aucune autre configuration.

Affichage d'un graphique avec une métrique sélectionnée.

Ce graphique contient plus de données qu'il ne peut en afficher. La limite d'affichage est de 300 lignes. Le graphique indique qu'il y a trop de données à afficher et suggère d'utiliser le mode "Anomalies". Cette option de l'onglet View options (Options d'affichage) permet de réduire considérablement la quantité de données à afficher.

Vous pouvez également utiliser les options de configuration de métriques supplémentaires pour simplifier la gestion de l'ensemble de données. Ces techniques augmentent l'utilité des graphiques lors de diagnostics et d'analyses, ainsi que les performances et la réactivité de l'interface utilisateur en elle-même.

Filtrer les données

Vous pouvez réduire la quantité de données renvoyées en spécifiant des critères de filtre, de sorte que seules les séries temporelles répondant à certains critères soient utilisées. Si vous appliquez des filtres, le graphique comporte moins de lignes, ce qui peut améliorer ses performances.

Vous pouvez fournir plusieurs critères de filtrage. Le graphique correspondant ne montre que les séries temporelles qui correspondent à tous les critères (opérateur logique AND).

Dans Google Cloud Console, cliquez sur le champ Filtre pour ajouter un filtre. Un panneau contenant des listes de critères de filtrage s'affiche. Par exemple, vous pouvez filtrer par groupe de ressources, par nom, par libellé de ressource, par zone et par libellé de métrique.

La capture d'écran suivante montre les libellés de filtrage connus pour un projet déterminé :

Listes de libellés de filtre préremplies

Vous pouvez choisir parmi les listes ou saisir une chaîne pour trouver des correspondances. En outre, vous pouvez créer des filtres correspondant à des données qui ne sont pas encore apparues. De tels critères de filtrage n'apparaîtront pas dans la liste de sélection, mais vous pouvez spécifier manuellement des filtres dont vous savez qu'ils seront valides à l'avenir.

Après avoir choisi le libellé sur lequel filtrer, vous devez spécifier les autres composantes du filtre : une valeur ou une plage de valeurs, et un opérateur de comparaison.

Par exemple, la capture d'écran suivante présente un filtre configuré sur le libellé de ressource zone. Le champ Filter (Filtre) accepte une paire d'opérateurs de comparaison pour l'égalité, = et =~, ainsi qu'une paire pour l'inégalité, != et !=~. Le deuxième élément de chaque paire prend une expression régulière en tant que valeur. L'égalité simple = est la valeur par défaut.

Comparateurs de filtres

En dessous de la liste des opérateurs de comparaison se trouve une liste des valeurs disponibles. La capture d'écran suivante montre les noms des zones du projet :

Quelques valeurs de filtre prérenseignées

Pour le champ Value (Valeur), vous pouvez sélectionner l'un des éléments de la liste déroulante ou saisir une expression qui correspond à plusieurs éléments :

  • Si vous utilisez une comparaison directe = ou !=, vous pouvez créer une chaîne de filtre telle que starts_with (commence par). Par exemple, la chaîne de filtre starts_with("us-central") correspond à n'importe quelle zone us-central :

    Utiliser une chaîne de filtre

    Consultez la section Surveiller les filtres pour en savoir plus sur les chaînes de filtres.

  • Si vous sélectionnez =~ ou !=~, vous pouvez utiliser une expression régulière RE2 dans la valeur. Par exemple, l'expression régulière us-central1-.* correspond à n'importe quelle zone us-central1 :

    Filtrer avec les expressions régulières

    L'expression régulière ^us.*.a$ correspond à n'importe quelle zone des États-Unis se terminant par "a" :

    Filtrer avec plus d'expressions régulières

Vous pouvez spécifier plusieurs critères de filtre et utiliser le même libellé plusieurs fois. Cela vous permet de spécifier un filtre pour une plage de valeurs. Pour ajouter des filtres, cliquez sur Add a filter (Ajouter un filtre) au bas du champ de filtre. Actuellement, tous les critères de filtrage doivent être satisfaits (opérateur logique AND). Par exemple, vous pouvez utiliser les chaînes de filtre starts_with et ends_with pour afficher seulement les zones se terminant par "a" aux États-Unis :

Utiliser plusieurs filtres

Avec un filtre zone="starts_with("asia-east1")" ou zone=~"asia-east1.*", le graphique n'affiche que la série temporelle comportant les données de l'une des zones asia-east1 :

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

Choisir le mode d'affichage des données

Cette section explique comment afficher les données sélectionnées en définissant des champs d'agrégation. L'agrégation consiste à aligner les points de données et à combiner ensemble différentes séries temporelles. Pour obtenir une explication détaillée de l'agrégation, consultez la page Filtrage et agrégation : manipuler des séries temporelles.

Regroupement

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 libellés. La fonction, appelée agrégateur dans Google Cloud Console, permet de combiner les séries temporelles du groupe en une seule série temporelle. Les agrégateurs standards incluent la moyenne, la valeur maximale, la valeur minimale, l'écart type et les différentes valeurs de centiles.

Pour ajouter un regroupement, cliquez sur Add a label (Ajouter un libellé) dans la zone de texte Group By (Grouper par), puis effectuez la sélection dans le menu. Le menu est créé de manière dynamique et affiche les libellés disponibles. Il s'agit des mêmes libellés que vous pouvez utiliser pour le filtrage. Lorsque vous ajoutez la première option de regroupement, voici ce qui se produit :

  • Un agrégateur est sélectionné. La fonction sélectionnée est déterminée par le type de données affichées. Toutefois, vous pouvez modifier cette fonction.
  • L'agrégateur combine toutes les séries temporelles qui possèdent la même valeur de libellé en une seule série temporelle.
  • Le graphique affiche une série temporelle pour chaque valeur du libellé de regroupement.

La capture d'écran suivante montre un regroupement par user_labels.version avec l'agrégateur défini sur la valeur par défaut sum :

Exemple de paramètre de regroupement.

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 libellés. Lorsque vous disposez de plusieurs options de regroupement, les séries temporelles sont regroupées par combinaison de valeurs de libellés et l'agrégateur est appliqué à chaque groupe. 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 ne spécifiez pas d'option de regroupement mais que vous spécifiez un agrégateur, celui-ci est appliqué à toutes les séries temporelles sélectionnées et génère une seule série temporelle. Ce comportement est illustré dans la capture d'écran suivante :

Affichage de série temporelle agrégée par somme, mais sans regroupement

Lorsque vous spécifiez un regroupement ou si vous sélectionnez un agrégateur, la série temporelle obtenue ne contient que les libellés obligatoires, tels que l'identifiant du projet et les libellés spécifiés par le regroupement.

Supprimer des conditions de regroupement

Pour supprimer une condition de regroupement, procédez comme suit :

  1. Supprimez les libellés de regroupement.
  2. Définissez l'agrégateur sur none.

Alignement

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.

Lors de la création d'un graphique à l'aide de Google Cloud Console, une fois que vous avez sélectionné le type de ressource et la métrique, plusieurs champs supplémentaires et un bouton Afficher les options avancées s'affichent.

Affichage du champ de la période

Période : la valeur de ce champ correspond à l'intervalle de temps minimum à utiliser lors de l'alignement des données de séries temporelles. Par exemple, si le graphique est configuré pour afficher une heure de données et que le paramètre Période est défini sur 10 minutes, le graphique contient six points de données. Toutefois, si vous configurez le graphique pour qu'il affiche une semaine de données, la période est automatiquement configurée sur une heure. Le paramètre par défaut de ce champ est 1 minute.

Pour afficher les autres options d'agrégation, cliquez sur Afficher les options avancées :

Affichage des options avancées

Aligner (Aligneur) : ce champ spécifie la fonction utilisée pour combiner tous les points de données d'une période d'alignement. Pour en savoir plus sur les aligneurs disponibles, consultez la section Aligner dans la documentation de référence de l'API. La plupart des aligneurs effectuent des fonctions mathématiques courantes. Par exemple, si vous sélectionnez min, le point de données aligné correspond au minimum de l'ensemble des points de données appartenant à la période d'alignement. Certains aligneurs réalisent des opérations plus complexes :

  • next older : pour conserver uniquement l'échantillon le plus récent au sein d'une période d'alignement, utilisez l'aligneur next older. Cet aligneur est couramment utilisé avec les tests de disponibilité et constitue 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é à partir de l'ensemble des 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 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 les unités de la série temporelle d'origine sont en Mio et que les unités de la période d'alignement sont en secondes, le choix de cet aligneur génère un graphique dont les unités sont en 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.

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 disposent des valeurs par défaut : l'Aligneur est défini sur mean et la Période est définie 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 présente moins de points de données, et le nombre et la hauteur des pics ont été réduits.

Agrégation secondaire

Si vous utilisez plusieurs séries temporelles qui représentent déjà des agrégations, comme dans les exemples illustrant l'option Group By (Grouper par), vous pouvez ensuite les agréger en choisissant l'option Secondary Aggregator (Agrégateur secondaire).

Champ correspondant à l'agrégation secondaire

L'agrégation secondaire permet de réduire toutes les séries temporelles du graphique à une série unique.

La capture d'écran ci-dessous montre plusieurs séries temporelles résultant du regroupement d'un ensemble filtré de données. L'utilisation du regroupement requiert une agrégation. Chaque groupe de lignes est agrégé en une seule ligne. Dans la capture d'écran, les séries temporelles sont regroupées par zone.

Affichage d'une série temporelle filtrée et regroupée par zone.

La capture d'écran ci-dessous montre le résultat de l'utilisation de l'agrégation secondaire pour la recherche de la valeur moyenne de séries temporelles regroupées.

Affichage d'une agrégation secondaire appliquée à l'exemple précédent.

Étape suivante