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

Ce document explique comment configurer un graphique temporaire qui affiche les données de séries temporelles collectées par votre projet. L'explorateur de métriques ne peut afficher que des données de séries temporelles numériques.

Sélectionner les données à afficher

Vous pouvez spécifier la série temporelle à l'aide de l'explorateur de métriques de différentes manières:

  • Interface basée sur un menu dans laquelle vous spécifiez des séries temporelles en sélectionnant un type de ressource, un type de métrique et des filtres. L'interface basée sur un menu vous propose des choix valides, vous évite de connaître une syntaxe spécifique et vous permet de représenter plusieurs types de métriques sous forme graphique:

    • Un type de métrique identifie les mesures à collecter à partir d'une ressource. Il inclut une description de ce qui est mesuré et de la manière dont ces mesures sont interprétées. Un type de métrique est parfois appelé métrique. Exemple d'utilisation de la métrique "Utilisation du processeur". Pour obtenir des informations sur le concept, consultez Types de statistiques.

    • Un type de ressource spécifie la ressource à partir de laquelle les données de métrique sont capturées. Le type de ressource est parfois appelé type de ressource surveillée ou ressource. Voici un exemple de ressource : une instance de machine virtuelle (VM) Compute Engine. Pour obtenir des informations sur le concept, consultez Ressources surveillées.

  • Une interface MQL (Monitoring Query Language) permettant de spécifier des séries temporelles en saisissant des instructions MQL L'interface MQL est compatible avec un éditeur de requête avec vérification de la syntaxe.

    Ce document ne décrit pas comment utiliser MQL. Pour en savoir plus sur la syntaxe MQL, consultez la page Présentation du langage MQL (Monitoring Query Language).

    MQL étant plus expressif que les autres interfaces, une requête MQL que vous saisissez est supprimée lorsque vous passez à une autre interface.

  • Interface textuelle dans laquelle vous spécifiez des séries temporelles en saisissant un filtre Monitoring. Les filtres de surveillance doivent être utilisés lorsque la série temporelle que vous souhaitez représenter dans le graphique ne peut pas être représentée avec le modèle de ressource et de métrique. Par exemple, pour compter le nombre de processus exécutés sur une VM, vous devez saisir un filtre Monitoring. Pour en savoir plus, consultez la section Mode Filtre direct.

    Étant donné que les filtres Monitoring peuvent décrire des séries temporelles qui ne peuvent pas être représentées avec le modèle de ressource et de métrique, votre configuration peut être supprimée lorsque vous passez à une autre interface.

Interfaces pilotées par menus

Pour spécifier les séries temporelles à afficher à l'aide de menus, 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. Sélectionnez l'onglet Configuration:

    1. Développez le menu Sélectionner une métrique.

    2. (Facultatif) Pour réduire le nombre d'options affichées dans le menu, saisissez le nom de la métrique ou de la ressource dans la barre de filtre . Par exemple, en saisissant util, vous restreignez le menu pour afficher les entrées qui incluent util. Les entrées sont affichées lorsqu'elles réussissent le test contenant des données non sensibles à la casse.

      Pour afficher la liste de toutes les métriques, même celles sans données récentes, désactivez l'option Afficher uniquement les ressources actives et les métriques. Par défaut, ce bouton est activé. Seules les métriques et les ressources contenant des données sont affichées dans les menus.

    3. Dans le menu Resource (Ressource), sélectionnez la ressource à partir de laquelle les données de métriques sont capturées.

      Lorsqu'une métrique n'est pas écrite sur une ressource, sélectionnez Non spécifié.

    4. Dans le menu Catégorie de métrique, sélectionnez la catégorie de la métrique.

      La catégorie correspond généralement au premier terme qui suit le préfixe des métriques. Par exemple, pour la métrique compute.googleapis.com/instance/utilization, la catégorie est instance.

    5. Dans le menu Metric (Métrique), sélectionnez la métrique à afficher au graphique.

    6. Cliquez sur Appliquer.

    Par exemple, pour représenter l'utilisation du processeur d'une machine virtuelle par les processeurs, vous pouvez procéder comme suit:

    1. Saisissez util dans la barre de filtre .
    2. Dans le menu Resources (Ressources), sélectionnez VM instance (Instance de VM).
    3. Dans le menu Catégories de métrique, sélectionnez Instance.
    4. Dans le menu Métriques, sélectionnez Utilisation du processeur, puis cliquez sur Appliquer.

    Une fois le type de ressource et la métrique sélectionnés, le graphique affiche toutes les séries temporelles disponibles pour cette paire. La capture d'écran suivante montre un graphique une fois le type de ressource et la métrique sélectionnés :

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

    Le graphique précédent contient davantage de données pouvant être affichées. Les graphiques sont limités à 300 lignes affichables. Le graphique indique qu'il y a trop de données à afficher et suggère d'utiliser le mode "Anomalies", ce qui permet de réduire considérablement la quantité de données à afficher. Pour accéder aux commandes du mode "Anomalies", cliquez sur Paramètres. Pour en savoir plus, consultez Définir les options de vue.

    Vous pouvez également utiliser les options de filtrage et d'agrégation pour réduire la quantité de données représentées graphiquement. 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.

  4. (Facultatif) Ajoutez des filtres pour limiter les séries temporelles affichées. Pour en savoir plus, consultez Filtrer les données représentées graphiquement.

Mode de filtrage direct

Utilisez le mode de filtrage direct lorsque vous souhaitez représenter graphiquement l'un des éléments suivants:

  • Un objectif de niveau de service (SLO)
  • Le nombre de processus s'exécutant sur des machines virtuelles (VM).
  • Une métrique personnalisée pour laquelle vous ne disposez pas encore de données.

Le mode de filtrage direct vous permet de saisir une expression permettant à Monitoring d'identifier les séries temporelles à surveiller. Les expressions que vous saisissez en mode de filtrage direct sont parfois appelées filtres de métriques ou filtres de surveillance. Par exemple, l'expression suivante génère un graphique affichant le nombre de processus dont le nom inclut nginx:

 select_process_count("monitoring.regex.full_match(\".*nginx.*\")")
 resource.type="gce_instance"

Vous pouvez également utiliser les filtres Monitoring pour identifier des séries temporelles en fonction de leur ressource et de leur type de métrique. L'expression suivante génère un graphique affichant le nombre d'entrées de journal pour toutes les instances de machine virtuelle Google Cloud dans 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. 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. Accédez à l'onglet Configuration.
  4. Cliquez sur Aide dans le menu Sélectionner une métrique, puis sélectionnez Mode de filtrage direct.

    Une zone de texte s'affiche sur la page. Si vous avez sélectionné un type de ressource, une métrique ou des filtres avant de passer au mode Mode Filtre direct, ces paramètres s'affichent dans la zone de texte.

  5. Saisissez une expression de filtre Monitoring dans la zone de texte. Pour en savoir plus sur la syntaxe, consultez les documents suivants:

    Lorsque vous utilisez le mode de filtrage direct et qu'aucune donnée correspondant au filtre n'est disponible, une erreur s'affiche. Les messages d'erreur fréquents incluent Chart definition invalid et No data is available for the selected timeframe..

Pour revenir à l'interface pilotée par un menu, cliquez sur Mode standard.

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. Lorsque vous appliquez des filtres, vous pouvez réduire le nombre de lignes du graphique, ce qui peut améliorer ses performances.

Le reste de cette section s'applique à la configuration d'un graphique lors de l'utilisation d'une interface basée sur un menu. Cette section ne s'applique pas aux configurations MQL et Monitoring, qui incluent des instructions de filtrage.

Lorsque vous indiquez plusieurs critères de filtrage, le graphique correspondant n'affiche que la série temporelle correspondant à tous les critères logiques : 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.

Pour ajouter un filtre lorsque vous utilisez l'onglet Configuration, cliquez sur Ajouter un filtre, puis spécifiez le libellé du filtre, la comparaison et la valeur ou la plage de valeurs :

  1. Cliquez sur Libellé, puis sélectionnez une entrée du 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 contenant 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 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 correspondant pas, !=~:

    Liste des comparateurs de filtres.

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

    • Pour une comparaison directe, = ou !=, sélectionnez la valeur dans le menu ou saisissez une valeur, puis cliquez sur OK. Les valeurs saisies peuvent être des valeurs 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"). Consultez la section Filtres Monitoring pour en savoir plus sur les chaînes de filtres.

      Les entrées du menu étant dérivées de la série temporelle reçue, lorsqu'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 l'étiquette.

      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.

    • Pour comparer une expression régulière au format =~ 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 à n'importe quelle zone us-central1 :

      Vous pouvez mettre en correspondance n'importe quelle zone des États-Unis se terminant par "a" à l'aide de 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, pour n'afficher que 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 filtrage doivent être satisfaits. Ils constituent un AND logique. 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

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 dans une série temporelle et à combiner 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.

Groupe de 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 combine toutes les données de séries temporelles d'un groupe en une nouvelle série temporelle.

Pour ajouter un regroupement, cliquez sur le texte 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 en fonction des données de séries temporelles de la ressource et de la métrique sélectionnées. Le regroupement et le filtrage utilisent le même ensemble de libellés.

Lorsque vous ajoutez le premier libellé, voici ce qui se produit :

  • Un agrégateur est sélectionné. Le type de données affichées détermine l'agrégateur par défaut. Vous pouvez toutefois modifier cette fonction.
  • L'agrégateur combine 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é répertorié dans la zone de texte Group by (Grouper par).

Si vous effectuez un regroupement d'après plusieurs libellés, l'agrégateur combine les séries temporelles qui possèdent la même valeur pour les libellés spécifiés.

Si vous ne définissez pas d'option de regroupement mais que vous spécifiez un agrégateur, la fonction s'applique à toutes les séries temporelles sélectionnées et génère une seule série temporelle.

Par exemple, si le champ Grouper par est défini sur user_labels.version et que l'agrégateur est défini sur sum, il existe une série temporelle pour chaque valeur de libellé 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, l'agrégateur est appliqué à 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 un agrégateur, 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 une condition de regroupement, procédez comme suit :

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

Aligner les séries temporelles

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 période d'alignement spécifie l'intervalle de temps minimum à 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.

Le champ Aligner (Aligneur) spécifie la fonction utilisée pour combiner tous les points de données d'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 au cours de la période d'alignement.

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. Lorsque le champ Aligner comporte une valeur mean, chaque point du graphique correspond à la moyenne de tous les points d'une période d'alignement. Toutefois, si vous configurez maintenant le graphique pour qu'il affiche une semaine de données, cela signifie qu'il y a trop de points à afficher dans le graphique. La période est donc automatiquement modifiée. Dans cet exemple, la période d'alignement modifiée est d'une heure.

Alors que la plupart des aligneurs effectuent des fonctions mathématiques courantes, d'autres effectuent des actions 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 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é à 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 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 en Mio et que l'unité de la période d'alignement est en seconde, le graphique a une unité 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.

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

Pour afficher ou modifier la fonction d'alignement, cliquez sur Afficher les options avancées.

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. En augmentant la période d'alignement, la moyenne est calculée sur plus de points. Cette action a un effet de lissage sur les données représentées.

Agrégation secondaire

Si vous utilisez plusieurs séries temporelles qui représentent déjà des agrégations, vous pouvez réduire toutes les séries temporelles du graphique à une série unique en choisissant un agrégateur secondaire. Par exemple, si vous regroupez des données par zone, votre graphique affiche une série temporelle pour chaque zone. Pour créer un graphique avec une seule série temporelle, utilisez les champs d'agrégation secondaires.

Pour afficher ou modifier les paramètres d'agrégation secondaires, cliquez sur Afficher les options avancées.

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.

Modèle de légende

Le champ Legend Template (Modèle de légende) vous permet de personnaliser une description de série temporelle sur votre graphique. Cette description apparaît dans l'info-bulle du graphique et dans la légende figurant dans la colonne Nom. Par défaut, les descriptions dans la légende sont créées automatiquement à partir des valeurs des différents libellés de votre série temporelle. Étant donné que le système sélectionne les libellés, les résultats peuvent ne pas vous être utiles. Utilisez ce champ afin de créer un modèle pour les descriptions.

Pour accéder au modèle de légende d'un graphique, sélectionnez l'onglet Options avancées dans Cloud Console, dans le volet de configuration du graphique. Le modèle de la légende est répertorié dans la section Options supplémentaires.

Vous pouvez saisir du texte brut et des modèles dans le champ Modèle de légende. Lorsque vous ajoutez un modèle, vous ajoutez une expression qui est évaluée lorsque la légende s'affiche.

Pour ajouter un modèle, procédez comme suit :

  • Cliquez sur Insert a template (Insérer un modèle).
  • Sélectionnez une entrée dans le menu. Une fois que vous avez sélectionné une entrée, un modèle est automatiquement ajouté. Par exemple, si vous sélectionnez response_code, le modèle ${resource.labels.zone} est ajouté.

Par exemple, la capture d'écran suivante montre un modèle de légende contenant du texte brut et l'expression ${resource.labels.zone} :

Modèle correspondant à une description simple.

Dans la légende du graphique, les valeurs générées à partir du modèle apparaissent dans une colonne avec l'en-tête Nom et dans l'info-bulle :

Descriptions générées à partir d'un modèle.

Vous pouvez configurer le modèle de légende pour inclure plusieurs chaînes de texte et modèles. Toutefois, l'espace disponible pour l'affichage sur l'info-bulle est limité.

Étapes suivantes