Configurer des légendes

Ce document explique comment utiliser les légendes des graphiques. La légende ressemble à un tableau positionné à côté du graphique. Par défaut, la légende d'un tableau de bord est configurée pour n'afficher que les points de couleur correspondant 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 des 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é dans le graphique indique l'heure pour laquelle les valeurs sont affichées.

Pour accéder aux tableaux de bord spécifiques aux ressources ou pour appliquer des filtres temporaires à un tableau de bord, utilisez le menu more_vert Actions pour cette série temporelle dans une légende développée.

Afficher et masquer les légendes

Les légendes des graphiques qui affichent plusieurs types de métriques peuvent être difficiles à interpréter. Par défaut, les colonnes de la légende sont sélectionnées parmi les libellés de métrique et de ressource du type de métrique représenté dans le graphique. Lorsqu'un graphique comporte plusieurs types de métriques, il est possible qu'une colonne de légende spécifique n'ait pas de sens pour une série temporelle spécifique.

• Exemple: Un graphique affiche le nombre d'octets écrits et le nombre d'octets lus à partir d'instances de machine virtuelle (VM). Supposons que les données d'octets lus soient filtrées dans la zone us-central1-a. La légende inclut une colonne zone, et les valeurs de cette colonne peuvent être différentes de us-central1-a. En effet, le type de métrique "octets écrits" contient un libellé zone et les données de métrique n'ont pas été filtrées par zone.

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

Sélectionner des colonnes de légendes

Pour modifier les colonnes qui apparaissent dans la légende, développez-la, puis cliquez sur view_column Colonnes de la légende. Cliquez dessus 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 comporte de nombreuses colonnes à afficher et la met en page lorsqu'elle comporte de nombreuses lignes à afficher. La capture d'écran suivante illustre une légende avec une barre de défilement et des flèches pour parcourir 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 de façon à inclure une deuxième colonne "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 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 expand_more Alias de légende.
2. Cliquez sur add Afficher les suggestions de variables de modèle et 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