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

Pour configurer les séries temporelles à afficher sur un graphique, vous pouvez créer une requête en effectuant des sélections dans les menus ou vous pouvez écrire une requête. Lorsque vous rédigez une requête, vous sélectionnez votre langage de requête, puis vous utilisez un éditeur de requête ou une interface textuelle:

Les requêtes Monitoring Query Language (MQL) spécifient la série temporelle et la manière dont elle est regroupée et alignée. L'interface MQL prend en charge un éditeur de code proposant des suggestions et une vérification de la syntaxe.

Il n'est généralement pas possible de convertir les requêtes MQL en formulaires utilisables par les autres interfaces. Vos requêtes non enregistrées sont supprimées lorsque vous basculez vers ou depuis l'onglet MQL.
Les requêtes Prometheus Query Language (PromQL) spécifient les séries temporelles et la manière dont elles sont regroupées et alignées. L'interface PromQL propose un éditeur proposant des suggestions.

Il n'est généralement pas possible de convertir les requêtes PromQL en formulaires utilisables par les autres interfaces. Vos requêtes non enregistrées sont supprimées lorsque vous basculez vers ou depuis l'onglet PromQL.
Les requêtes de filtre Monitoring spécifient la série temporelle, mais n'incluent pas d'instructions de regroupement ni d'alignement.

Vous pouvez spécifier toutes les séries temporelles que Monitoring peut représenter à l'aide d'un filtre Monitoring. Par exemple, pour représenter graphiquement le nombre de processus exécutés sur une VM, vous devez utiliser un filtre Monitoring qui spécifie une fonction.

Il n'est pas toujours possible de convertir un filtre Monitoring au format requis par d'autres interfaces. Par conséquent, votre requête risque d'être supprimée si vous passez à une autre interface.

Les requêtes spécifient généralement un type de métrique, un type de ressource et des filtres:

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. "Utilisation du processeur" est un exemple de métrique. Pour obtenir des informations conceptuelles, consultez la section Types de métriques.
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. Une "instance de machine virtuelle (VM) Compute Engine" est un exemple de ressource. Pour obtenir des informations conceptuelles, consultez la page Ressources surveillées.

Les requêtes MQL et PromQL incluent des instructions de regroupement et d'alignement. Toutefois, lorsque vous écrivez un filtre Monitoring ou utilisez des menus pour sélectionner la série temporelle à représenter dans un graphique, vous configurez les paramètres de regroupement et d'alignement à l'aide de menus.

Créer des requêtes à l'aide de menus

Pour créer votre requête à l'aide de menus, procédez comme suit:

Dans la console Google Cloud, sélectionnez Monitoring, puis Explorateur de métriques, ou cliquez sur le bouton suivant :
Accéder à l'explorateur de métriques
Dans la barre d'outils du volet de requête, procédez comme suit:
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 limitez le menu aux entrées qui incluent util. Les entrées s'affichent lorsqu'elles passent un test "contient" non sensible à la casse.
  
  Pour afficher la liste de toutes les métriques, même celles sans données récentes, activez l'option Afficher uniquement les ressources et métriques actives. Par défaut, seules les métriques et les ressources contenant des données sont affichées dans les menus.
3. Dans le menu Ressources, sélectionnez la ressource à partir de laquelle les données de métrique sont collectées.
  
  Lorsqu'une métrique n'est pas écrite sur une ressource, sélectionnez Non spécifié.
4. Dans le menu Catégories de métriques, sélectionnez la catégorie de la métrique.
  
  La catégorie correspond généralement au premier terme qui suit le domaine du service. En utilisant le type de métrique Compute Engine compute.googleapis.com/instance/utilization comme exemple, le domaine du service est compute.googleapis.com et la catégorie est instance.
5. Dans le menu Métriques, sélectionnez la métrique à représenter dans le graphique.
6. Cliquez sur Appliquer.
Par exemple, pour représenter l'utilisation du processeur d'une machine virtuelle Compute Engine, procédez comme suit:
1. Saisissez util dans la barre de filtres de .
2. Dans le menu Ressources, sélectionnez Instance de VM.
3. Dans le menu Catégories de métriques, 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:

Le graphique précédent contient plus de données que celles qui peuvent être affichées. Les graphiques sont limités à 300 lignes affichables. Le graphique indique qu'il y a trop de données à afficher. Pour réduire la quantité de données, cliquez sur Ajouter un tri et une limite, puis remplissez la boîte de dialogue. Pour en savoir plus, consultez Définir les options d'affichage.

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.
Facultatif: Ajoutez des filtres pour limiter les séries temporelles affichées. La section suivante décrit les options de filtrage.
(Facultatif) Configurez la manière dont les séries temporelles sont regroupées et alignées. Pour en savoir plus, consultez Choisir le mode d'affichage des données représentées graphiquement.

Vous pouvez réduire la quantité de données à représenter en spécifiant des critères de filtre, en appliquant une agrégation ou en triant les séries temporelles correspondant à une requête, puis en limitant le nombre de séries temporelles représentées dans le graphique. Pour en savoir plus, consultez Afficher les 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 concerne la configuration d'un graphique lorsque vous utilisez une interface basée sur un menu. Cette section ne s'applique pas aux configurations MQL, PromQL ou Monitoring.

Lorsque vous fournissez plusieurs critères de filtrage, le graphique correspondant n'affiche que les séries temporelles qui répondent à tous les critères (opérateur 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.

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

Cliquez sur Labels (Libellés), 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 :
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, !=~:
Cliquez sur Valeur, puis effectuez l'une des opérations suivantes :
- Pour effectuer 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.
  
  Étant donné que les entrées de menu sont 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 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é :
- Pour comparer des 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 à 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.*":

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.

Écrire des requêtes MQL et PromQL

Ce document ne décrit pas comment utiliser MQL ou PromQL. Pour en savoir plus sur ces langages, consultez les documents suivants:

Pour saisir une requête MQL ou PromQL, procédez comme suit:

Dans la console Google Cloud, sélectionnez Monitoring, puis Explorateur de métriques, ou cliquez sur le bouton suivant :
Accéder à l'explorateur de métriques
Dans la barre d'outils du volet Sélectionner une métrique, sélectionnez le bouton dont le nom commence par Code.
Sélectionnez la langue de votre requête à l'aide du bouton Langue. Ce bouton d'activation se trouve dans la même barre d'outils qui vous permet de mettre en forme votre requête.
Facultatif: Désactivez le bouton Exécution automatique.
Saisissez votre requête, puis cliquez sur Exécuter la requête.

Lorsque l'option Exécution automatique est activée, le bouton Exécuter la requête ne s'affiche pas.

Écrire des requêtes avec filtre Monitoring

Lorsque vous souhaitez effectuer l'une des opérations suivantes, vous devez utiliser le mode de filtrage direct, qui vous permet de définir un filtre Monitoring:

Affichez un objectif de niveau de service (SLO).
Affichez le nombre de processus en cours d'exécution sur des machines virtuelles (VM).
Affichez une métrique personnalisée pour laquelle vous ne disposez pas encore de données.
Filtrez une série temporelle en fonction d'un libellé pour lequel vous ne disposez pas encore de données.

Un filtre Monitoring, ou de manière équivalente un filtre de métrique, est une expression utilisée par Monitoring pour identifier la série temporelle à représenter dans le graphique. 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 les séries temporelles en fonction de leur type de ressource et de métrique. L'expression suivante génère un graphique affichant le nombre d'entrées de journal pour toutes les instances de machines virtuelles 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 :

Dans la console Google Cloud, sélectionnez Monitoring, puis Explorateur de métriques, ou cliquez sur le bouton suivant :
Accéder à l'explorateur de métriques
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 Filtrage direct, ces paramètres s'affichent dans la zone de texte.
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 aux critères de filtrage n'est disponible, une erreur s'affiche. Chart definition invalid et No data is available for the selected timeframe. sont des messages d'erreur courants.
(Facultatif) Configurez la manière dont les séries temporelles sont regroupées et alignées. Pour en savoir plus, consultez Choisir le mode d'affichage des données représentées graphiquement.

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

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.

Pour en savoir plus sur les options d'affichage, consultez Définir les options d'affichage des graphiques.
Pour en savoir plus sur l'interaction avec le graphique lui-même, consultez Explorer les données représentées graphiquement.

Le contenu de cette section ne s'applique pas lorsque vous avez sélectionné les données à représenter graphiquement à l'aide d'un MQL ou d'un PromQL.

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 définit la façon dont toutes les séries temporelles d'un groupe sont combinées en une nouvelle série temporelle.

Par défaut, un regroupement est ajouté une fois que vous avez sélectionné votre type de ressource et votre type de métrique. Ce regroupement est configuré pour calculer la moyenne de toutes les séries temporelles. Par conséquent, le graphique affiche une seule ligne:

Pour regrouper par libellés spécifiques, cliquez sur Libellés dans la section Regrouper par, puis effectuez vos sélections. Vous pouvez effectuer un regroupement d'après plusieurs étiquettes.

Lorsque le champ Libellés est vide, toutes les séries temporelles sont combinées et le graphique affiche une ligne.
Pour afficher toutes les séries temporelles, sur l'entrée Grouper par, cliquez sur Supprimer le regroupement.

Par exemple, si vous définissez le champ Libellés sur user_labels.version et le champ Fonction de regroupement sur sum, il existe une série temporelle pour chaque valeur du 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.

Lorsque vous regroupez des séries temporelles à l'aide de plusieurs libellés, la fonction de regroupement est appliquée à l'ensemble de séries temporelles qui partagent 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.

Lorsque vous spécifiez un regroupement ou que vous sélectionnez une fonction de regroupement, la série temporelle représentée sous forme de graphique ne contient que les étiquettes requises, telles que l'identifiant du projet et les étiquettes spécifiées par le regroupement.

Supprimer des conditions de regroupement

Pour supprimer le regroupement, cliquez sur Supprimer le regroupement.

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.

Le champ Durée d'alignement minimale spécifie l'intervalle de temps minimal à utiliser pour aligner les 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 Fonction d'alignement spécifie la fonction utilisée pour combiner tous les points de données au cours 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 inclus dans 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 Fonction d'alignement a la valeur mean, chaque point du graphique correspond à la moyenne de tous les points de la période d'alignement. Toutefois, si vous configurez maintenant le graphique pour afficher les données d'une semaine, 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.

Bien que la plupart des aligneurs effectuent des fonctions mathématiques courantes, certains 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 accéder aux champs d'alignement, cliquez sur More Options (Autres options) dans le volet de requête, puis accédez à la section Alignement du point de donné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 pour les instances de VM utilisant la valeur 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.

Regroupement et alignement 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.

Lorsque vous définissez le champ Transform sur une valeur autre que None, tous les autres champs correspondent aux paramètres d'agrégation secondaires.

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.

Configurer le nom d'une colonne de légende

Le champ Legend Alias (Alias 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.

Vous pouvez saisir du texte brut et des modèles dans le champ Alias 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 de légende à un graphique, procédez comme suit:

Dans le volet Affichage, développez Alias de légende .
Cliquez sur Plus, puis sélectionnez une entrée dans le menu. Par exemple, si vous sélectionnez zone, 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é.