Configurer des légendes

Ce document explique comment utiliser les légendes de graphiques. La légende ressemble à un tableau placé à côté du graphique. Par défaut, la légende d'un tableau de bord est configurée pour n'afficher que les points colorés qui correspondent aux lignes du graphique. La capture d'écran suivante montre un graphique sur un tableau de bord avec la légende par défaut:

Pour les graphiques de tableaux de bord, vous pouvez également développer la légende pour afficher plus de détails, tels que des colonnes de données configurables et une colonne Valeur. La colonne Valeur affiche les valeurs de la métrique représentée dans le graphique, et les autres colonnes affichent les valeurs des libellés de métrique ou de ressource choisis. La barre en pointillés sur le graphique indique l'heure pour laquelle les valeurs sont affichées.

Pour accéder à des tableaux de bord spécifiques à une ressource ou pour appliquer des filtres temporaires à un tableau de bord, utilisez le menu Actions for this timeseries (Actions pour cette série temporelle) dans une légende développée.

Afficher et masquer les légendes

Graphiques sur les tableaux de bord

Vous pouvez afficher ou masquer les légendes de tous les graphiques d'un tableau de bord ou de chaque graphique individuellement:

• Pour afficher ou masquer les légendes de chaque graphique d'un tableau de bord, cliquez sur Paramètres dans la barre d'outils du tableau de bord, puis sélectionnez Condensé ou Tableau.
• Pour afficher ou masquer la légende d'un graphique particulier, cliquez sur Développer la légende ou sélectionnez Développer la légende du graphique dans le menu Autres options de graphique.

Explorateur de métriques

• Pour afficher la légende complète d'un graphique, sélectionnez Les deux dans le bouton d'activation Chart Table Les deux.
• Pour masquer la légende complète d'un graphique, sélectionnez Graphique dans le bouton d'activation Graphique des deux tables.

Les légendes des graphiques qui affichent plusieurs types de métriques peuvent être difficiles à interpréter. Par défaut, les colonnes de légende sont sélectionnées à partir des libellés de métrique et de ressource pour le type de métrique représentée dans un graphique. Lorsqu'un graphique comporte plusieurs types de métriques, il se peut qu'une colonne de légende spécifique ne soit pas utile pour une série temporelle donnée.

• Exemple: Un graphique affiche le nombre d'octets écrits et le nombre d'octets lus sur des instances de machines virtuelles (VM). Supposons que les données de lecture des octets sont filtrées sur la zone us-central1-a. La légende inclut une colonne zone, et les valeurs de cette colonne peuvent être différentes de celles de us-central1-a. La raison est que le type de métrique écrit en octets contient un libellé zone et que les données de métriques n'ont pas été filtrées par zone.

• Exemple: Un graphique affiche le nombre d'octets écrits dans des instances de VM et l'utilisation du processeur par ces instances. La légende contient des colonnes pour le type de disque et le type de stockage. Cependant, les valeurs de ces libellés sont vides pour les champs de légendes temporelles. Le type de métrique d'utilisation du processeur n'est pas compatible avec ces étiquettes.

Sélectionner des colonnes de légendes

Pour modifier les colonnes qui apparaissent dans la légende, développez la légende, puis cliquez sur Colonnes de la légende. Cliquez sur ce bouton pour afficher un panneau de configuration. qui répertorie les libellés de métrique et de ressource pouvant être affichés sous forme de colonnes. Les cases des colonnes obligatoires sont désactivées. La capture d'écran suivante montre le bouton Colonnes et le panneau de configuration d'une légende particulière :

Lors de la création initiale du graphique, le système choisit de manière heuristique un ensemble de libellés à afficher par défaut. Vous pouvez sélectionner ou désélectionner les colonnes avec libellé. Les entrées des colonnes obligatoires, le plus souvent Valeur, sont désactivées et ne peuvent pas être décochées. Lorsque vous modifiez la configuration, au moins un libellé de métrique ou de ressource doit être sélectionné.

La légende affiche une barre de défilement lorsqu'elle a de nombreuses colonnes à afficher et la pagine lorsqu'il y a beaucoup de lignes à afficher. La capture d'écran suivante illustre une légende avec une barre de défilement et des flèches permettant de naviguer dans les pages:

Trier les lignes de la légende

Vous pouvez trier les lignes de la légende en fonction de n'importe quelle colonne. Le tri peut être effectué par ordre croissant ou décroissant. Pour trier une ligne, cliquez sur l'en-tête. La dernière colonne employée pour le tri affiche une flèche indiquant l'ordre de tri. La capture d'écran suivante montre une légende triée par ordre décroissant de zone :

Comprendre les légendes en mode "Comparer à une période antérieure"

Lorsque vous utilisez le mode Comparer à une période antérieure dans un graphique, la légende est modifiée pour inclure une deuxième colonne de valeurs. La colonne Value (Valeur) actuelle devient Today (Aujourd'hui), et la colonne des valeurs antérieures est nommée de manière appropriée, par exemple Semaine dernière. La capture d'écran suivante présente la légende d'une table comparant les données actuelles à celles de la dernière heure :

Configurer le nom d'une colonne de légende

Le champ 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 saisir 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 :

1. Dans le volet Affichage, développez Alias de légende.
2. Cliquez sur Afficher les suggestions de variables de modèle, 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} :

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 :

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é.

Accéder aux tableaux de bord spécifiques aux ressources

Graphiques sur les tableaux de bord

Lorsque vous consultez une série temporelle, vous pouvez afficher plus d'informations sur la ressource pour laquelle cette série temporelle est écrite. Pour certaines ressources, vous pouvez accéder à leur page de gestion en utilisant les options de la légende du graphique.

Pour accéder à la page de gestion d'une ressource, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page Tableaux de bord .

   Accéder à Tableaux de bord

   Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Surveillance.

2. Cliquez sur le nom du tableau de bord que vous souhaitez afficher.
3. Identifiez le graphique et développez la légende pour afficher plus de détails en cliquant sur  Développer la légende.

4. Ouvrez la page de gestion de la ressource :

   1. Recherchez la série temporelle qui vous intéresse, puis cliquez sur Actions for this timeseries (Actions pour cette série temporelle).
   2. Sélectionnez l'option commençant par Gérer.

Vous trouverez ci-dessous une liste partielle des ressources pour lesquelles vous pouvez accéder à la page de gestion à partir des options de la légence :

• Ensembles de données BigQuery
• Buckets Cloud Storage
• Disques et instances Compute Engine
• Clusters, conteneurs, nœuds et pods Google Kubernetes Engine
• Équilibreurs de charge d'application externes
• Abonnements et sujets Pub/Sub
• Instances Spanner

Explorateur de métriques

Non compatible.