Sélectionner des métriques lorsque vous utilisez 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 numériques de séries temporelles.

Sélectionner les données à afficher

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

  • Les requêtes Monitoring Query Language (MQL) spécifient les séries temporelles et la manière dont elles sont regroupées et alignées. L'interface MQL est compatible avec un éditeur de code avec des suggestions et la vérification de la syntaxe.

    Il n'est généralement pas possible de convertir les requêtes MQL en formulaires qui peuvent être utilisés par les autres interfaces. Vos requêtes non enregistrées sont supprimées lorsque vous passez de l'onglet MQL ou que vous en sortez.

  • 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 avec des suggestions.

    Il n'est généralement pas possible de convertir les requêtes PromQL en formulaires qui peuvent être utilisés par les autres interfaces. Vos requêtes non enregistrées sont supprimées lorsque vous passez de l'onglet PromQL ou que vous en sortez.

  • Requêtes de filtre Monitoring spécifiez la série temporelle, mais n'incluez pas d'instructions de regroupement ou d'alignement.

    Vous pouvez spécifier n'importe quelle série temporelle que Monitoring peut représenter à l'aide d'un filtre Monitoring. Par exemple, pour représenter le nombre s'exécutant sur une VM, vous devez utiliser Filtre Monitoring spécifiant 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 peut seront supprimés 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'un 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ée métrique. "Utilisation du processeur" est un exemple de métrique. Pour obtenir des informations conceptuelles, consultez Types de métriques.

  • Un type de ressource spécifie la ressource à partir de laquelle proviennent les données de métrique. 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 à ce sujet, consultez la section consacrée aux ressources surveillées.

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

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

La configuration par défaut est la création de requêtes à l'aide de menus. En règle générale, si vous sélectionnez une métrique et un filtre, puis que vous passez à une autre interface, vos sélections sont conservées et reformatées pour cette interface. Autrement dit, une requête créée par des menus peut être convertie en requête MQL.

Vous pouvez revenir à l'interface pilotée par un menu à partir des autres interfaces en sélectionnant Builder. Toutefois, votre requête est ignorée. Autrement dit, une requête MQL ne peut pas être convertie en formulaire équivalent basé sur un menu.

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

  1. Dans la console Google Cloud, accédez à la page Explorateur de métriques :

    Accéder à l'explorateur de métriques

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

  2. Dans la barre d'outils du volet de requête, procédez comme suit :

    1. Dans l'élément Métrique, développez le menu Sélectionner une métrique.

      Le menu Sélectionner une métrique propose des fonctionnalités qui vous aident à identifier les types de métriques disponibles:

      • Pour rechercher un type de métrique spécifique, utilisez le Barre de filtres. Par exemple, si vous saisissez util, le menu ne répertorie que les entrées incluant util. Les entrées s'affichent lorsqu'elles réussissent un test "contient" non sensible à la casse.

      • Pour afficher tous les types de métriques, même ceux sans données, cliquez sur Active (Actif). Par défaut, les menus n'affichent que les types de métriques avec des données.

    2. Effectuez une sélection dans les menus Ressources, Catégories de métriques et Métriques, puis cliquez sur Appliquer.

      Par exemple, pour représenter l'utilisation du processeur d'une Compute Engine machine virtuelle, vous pouvez sélectionner Instance de VM, Instance, Utilisation du processeur, puis cliquez sur Appliquer.

      Le menu Ressources répertorie la ressource à partir de laquelle les données sont collectées. Lorsqu'une métrique n'est pas écrite pour une ressource, sélectionnez Non spécifié.

    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 :

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

    Le graphique précédent contient plus de données qu'il ne peut en afficher. La limite d'affichage est de 50 lignes. Le graphique indique qu'il y a trop de données à afficher. À réduire la quantité de données, dans la barre d'outils de la requête, Trier et limit. Pour en savoir plus, consultez Affichez les anomalies.

    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 rendent les graphiques plus utiles pour de diagnostic et d'analyse, et d'améliorer les performances la réactivité de l'interface utilisateur elle-même.

  3. (Facultatif) Ajoutez des filtres pour limiter les séries temporelles affichées. La section suivante décrit les options de filtrage.

  4. Facultatif: configurez le regroupement et l'alignement des séries temporelles. Pour plus pour plus d'informations, consultez Choisir le mode d'affichage des données représentées graphiquement.

Filtrer les données représentées graphiquement

Les filtres permettent de s'assurer que seules les séries temporelles correspondant à un ensemble de critères sont représentées dans le graphique. Lorsque vous appliquez des filtres, vous pouvez réduire le nombre de lignes sur le graphique, ce qui peut améliorer ses performances. Vous pouvez également améliorer la réactivité d'un graphique en configurant des options d'agrégation, et en triant et en limitant le nombre de séries temporelles affichées. Pour en savoir plus, consultez la section Afficher les anomalies.

Un filtre est composé d'une étiquette, d'un comparateur et d'une valeur. Par exemple : pour faire correspondre toutes les séries temporelles dont le libellé zone commence par "us-central1", vous peut utiliser le filtre zone=~"us-central1.*", qui utilise une expression régulière ; pour effectuer la comparaison. Il existe quatre opérateurs de comparaison:

  • est égal à =
  • est différent(e) de !=
  • correspondance d'expression régulière, =~
  • l'expression régulière ne correspond pas, !=~

Lorsque vous filtrez par ID de projet ou conteneur de ressources, vous devez utiliser l'opérateur d'égalité, (=). Lorsque vous filtrez par d'autres libellés, vous pouvez utiliser n'importe quel comparateur compatible. En règle générale, vous pouvez filtrer les étiquettes de métrique et de ressource, et groupe de ressources.

Lorsque vous fournissez 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).

Pour ajouter un filtre lorsque vous utilisez l'interface basée sur un menu de la console Google Cloud, procédez comme suit :

  1. Dans l'élément Filtre, cliquez sur Ajouter un filtre, puis effectuez une sélection dans le menu.

  2. Pour modifier la comparaison, sélectionnez une valeur dans le menu Comparateur.

  3. Dans le champ Value (Valeur), saisissez ou sélectionnez une valeur :

    • Pour une comparaison directe, = ou !=, sélectionnez la valeur dans le ou saisissez une valeur, puis cliquez sur OK. Vous pouvez saisir des valeurs telles que us-central1-a, ou 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 page Filtres de surveillance. pour en savoir plus sur les chaînes de filtre.

      Étant donné que les entrées de menu sont dérivées de la série temporelle reçue, lorsque qu'une ressource surveillée ne génère pas de données pour la métrique sélectionnée, vous devez saisir une valeur de libellé.

    • Pour une comparaison d'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 d'un des us-central1 zones, appliquez un filtre zone=~"us-central1.*".

Lorsque vous ajoutez plusieurs filtres, les points suivants s'appliquent:

  • Vous pouvez utiliser le même libellé plusieurs fois, ce qui vous permet spécifier un filtre pour une plage de valeurs.

  • Tous les critères de filtrage doivent être remplis. ils constituent un AND logique.

Pour modifier la valeur ou le comparateur d'un filtre, procédez comme suit : sur l'élément de filtre, cliquez sur Menu , puis configurez modifications, puis cliquez sur OK.

Pour supprimer un filtre, cliquez sur  Annuler.

Écrire des requêtes MQL

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

  1. Dans la console Google Cloud, accédez à la page Explorateur de métriques :

    Accéder à l'explorateur de métriques

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

  2. Dans la barre d'outils du volet de création de requêtes, sélectionnez le bouton nommé  MQL ou  PromQL.
  3. Vérifiez que MQL est sélectionné dans le bouton d'activation Langage. Le bouton de langage se trouve dans la barre d'outils qui vous permet de mettre en forme votre requête.
  4. Facultatif : Désactivez l'option Exécution automatique.
  5. Saisissez une requête dans l'éditeur de requête. Par exemple, pour représenter le graphique "Utilisation du processeur" des instances de VM de votre projet Google Cloud, utilisez le la requête suivante:

    fetch gce_instance
    | metric 'compute.googleapis.com/instance/cpu/utilization'
    | group_by 1m, [value_utilization_mean: mean(value.utilization)]
    | every 1m
    

    Pour en savoir plus sur MQL, consultez les documents suivants :

  6. Cliquez sur Exécuter la requête.

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

Écrire des requêtes PromQL

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

  1. Dans la console Google Cloud, accédez à la page Explorateur de métriques :

    Accéder à l'explorateur de métriques

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

  2. Dans la barre d'outils du volet de création de requêtes, sélectionnez le bouton nommé  MQL ou  PromQL.
  3. Vérifiez que PromQL est sélectionné dans le bouton d'activation Langage. Le bouton de langage se trouve dans la barre d'outils qui vous permet de mettre en forme votre requête.
  4. Facultatif : Désactivez l'option Exécution automatique.
  5. Saisissez une requête dans l'éditeur de requête. Par exemple, pour représenter la moyenne de l'utilisation du processeur des instances de VM dans votre projet Google Cloud, utilisez le la requête suivante:

    avg(compute_googleapis_com:instance_cpu_utilization)
    

    Pour en savoir plus sur l'utilisation de PromQL, consultez la page PromQL dans Cloud Monitoring.

  6. 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 de filtre Monitoring

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

  • Affichez un objectif de niveau de service (SLO).
  • Afficher le nombre de processus exécutés sur des machines virtuelles (VM).
  • Affichez une métrique personnalisée pour laquelle vous ne disposez pas encore de données.
  • Filtrer 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 Filtre de métrique, est une expression que 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 des filtres de surveillance pour identifier les séries temporelles en fonction de leur type de ressource et de métrique. L'expression suivante donne graphique affichant le nombre d'entrées de journal pour l'ensemble des machines virtuelles Google Cloud instances de machines virtuelles 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 la console Google Cloud, accédez à la page Explorateur de métriques :

    Accéder à l'explorateur de métriques

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

  2. Cliquez sur  Aide dans l'élément Métrique, puis sélectionnez Mode de filtrage direct.

    Les éléments Métrique et Filtre sont supprimés, et un élément Filtres vous permet de saisir du texte.

    Si vous avez sélectionné un type de ressource, une métrique ou des filtres avant de passer en mode Direct filter Mode (Mode de filtrage direct), puis ces paramètres sont affichés dans l'élément Filtres.

  3. Dans la zone de texte de l'élément Filtres, saisissez une expression de filtre Monitoring. Pour en savoir plus sur la syntaxe, consultez les documents suivants :

    Lorsque vous utilisez le mode de filtrage direct et qu'aucune donnée ne répond aux critères du filtre, un message d'erreur s'affiche. Voici quelques-uns des messages d'erreur courants : Chart definition invalid et No data is available for the selected timeframe..

  4. Facultatif: configurez le regroupement et l'alignement des séries temporelles. Pour plus pour plus d'informations, consultez Choisir le mode d'affichage des données représentées graphiquement.

Pour revenir à l'interface basée sur un menu, Cliquez sur Quitter le mode de filtrage direct.

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.

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

Combiner des 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 ou plusieurs libellés et une fonction. Séries temporelles comportant le paramètre la même valeur pour tous les libellés spécifiés sont regroupés, puis la fonction que vous avez spécifié combine ces séries temporelles en une nouvelle série temporelle.

Les paramètres de l'élément Agrégation peuvent modifier le nombre de les séries temporelles affichées par votre graphique. Les paramètres par défaut de cet élément sont déterminés par le type de métrique que vous avez sélectionné. Pour modifier l'affichage, effectuez l'une des opérations suivantes:

  • Pour afficher toutes les séries temporelles, dans l'élément Agrégation, assurez-vous que le premier menu est défini sur Non agrégé et le second sur Aucun.

  • Pour combiner des séries temporelles, dans l'élément Aggregation (Agrégation) : effectuer les opérations suivantes:

    1. Développez le premier menu et sélectionnez une fonction.

      Le graphique est actualisé et affiche une seule série temporelle. Par exemple : si vous sélectionnez Moyenne, la série temporelle affichée correspond à la moyenne de toutes les séries temporelles.

    2. Pour combiner des séries temporelles ayant les mêmes valeurs de libellé, développez le deuxième menu, puis sélectionnez un ou plusieurs libellés.

      Le graphique est actualisé et affiche une série temporelle pour chaque valeur combinaison de valeurs d'étiquette. Par exemple, pour afficher les séries temporelles par zone, définissez le deuxième menu sur zone.

  • Pour configurer l'espacement entre les points de données, cliquez sur  Ajouter un élément de requête, sélectionnez Intervalle minimal, puis saisissez une valeur.

Par exemple, si vous définissez la fonction sur Somme et que vous sélectionnez le libellé user_labels.version, 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 pour des séries temporelles individuelles et pour une version spécifique:

Affichage des séries temporelles regroupées par user_labels.version.

Lorsque vous sélectionnez plusieurs étiquettes, les séries temporelles les valeurs des étiquettes sélectionnées sont combinées. 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. La capture d'écran suivante montre un graphique dans lequel les séries temporelles sont combinées par les libellés user_labels.version et system_labels.machine_image :

Affichage des séries temporelles regroupées par version et image de machine.

Comme illustré, le graphique affiche une série temporelle pour chaque paire de valeurs de libellé. Comme vous obtenez une série temporelle pour chaque combinaison d'étiquettes, cette technique peut créer plus de données que vous ne pouvez en mettre graphique unique.

Afficher toutes les séries temporelles

Pour afficher toutes les séries temporelles, dans l'élément Agrégation, définissez le premier menu sur Non agrégé et le second menu sur Aucun.

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.

Définir l'intervalle d'alignement

Pour spécifier la durée fixe de combinaison des points, cliquez sur Ajouter un élément de requête dans le volet de requête. Sélectionnez Intervalle minimal, puis remplissez les champs de la boîte de dialogue.

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 le champ Intervalle minimal est défini sur 10 minutes, le graphique affiche six points de données. Toutefois, si vous configurez maintenant le graphique pour qu'il affiche une semaine de données, le nombre de points à afficher est trop élevé. Par conséquent, l'intervalle sur lequel les points sont combinés est automatiquement modifié. Dans cet exemple, l'intervalle modifié est d'une heure.

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, le champ Intervalle minimal est défini sur 1 minute:

Utilisation du processeur par les instances de VM en utilisant les paramètres d'alignement par défaut.

À titre de comparaison, la capture d'écran suivante illustre l'effet de la modification l'intervalle de 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. En augmentant la valeur Intervalle minimal, davantage de points sont combinés, ce qui a un effet de lissage sur les données tracées.

Définir la fonction d'alignement

Lorsque vous sélectionnez la fonction d'agrégation, Cloud Monitoring sélectionne la fonction d'alignement à votre place. Cloud Monitoring détermine la configuration optimale fonction d'alignement en fonction du type de métrique sélectionné et de votre choix pour la fonction d'agrégation. Toutefois, vous pouvez spécifier une fonction d'alignement et remplacer le choix effectué par Cloud Monitoring.

Pour spécifier la fonction d'alignement, procédez comme suit :

  1. Dans l'élément Agrégation, développez le premier menu et sélectionnez Configurez l'aligneur. Fonction d'alignement et Les éléments de regroupement sont ajoutés.
  2. Développez l'élément Fonction d'alignement, puis effectuez une sélection.

Bien que la plupart des fonctions d'alignement compatibles effectuent des fonctions mathématiques courantes, certaines effectuent des actions plus complexes :

  • suivante: pour ne conserver que l'échantillon le plus récent dans un alignement période, sélectionnez Suivante. Cette fonction est couramment utilisée avec les tests de disponibilité et représente un bon choix lorsque vous vous intéressez uniquement à la valeur la plus récente.

    Cette fonction 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. Une façon de spécifier ce centile consiste à sélectionner une fonction de centile. 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.

    Cette fonction n'est valide que pour les métriques de jauge et delta lorsqu'elles de type "distribution".

  • delta : utilisez cette fonction pour convertir une métrique cumulative ou une métrique delta en métrique delta avec un échantillon par période d'alignement. Une interpolation des données peut se produire lorsque vous utilisez cette fonction. Pour voir un exemple, consultez Genres, types et conversions :

    Cette fonction n'est valide que pour les métriques cumulatives et delta.

  • rate : utilisez cette fonction pour convertir une métrique cumulative ou delta en métrique de jauge. Si vous choisissez cette fonction, vous pouvez considérer que la série temporelle transformées comme avec une fonction delta, puis divisée par la période d'alignement. Par exemple, si l'unité de la série temporelle d'origine est le Mio et l'unité de la période d'alignement est la seconde, a une unité de Mio par seconde. Pour en savoir plus, consultez Genres, types et conversions :

    Cette fonction n'est valide que pour les métriques cumulatives et les métriques delta.

Pour en savoir plus sur les fonctions d'alignement disponibles, Voir Aligner dans la documentation de référence de l'API.

Regroupement et alignement secondaires

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 certains types de métriques, vous avez la possibilité de transformer les données. Si cette option est disponible et que vous définissez le champ Transformer sur une valeur autre que Aucune, tous les autres champs sont les paramètres d'agrégation secondaires.

Lorsque les champs d'agrégation secondaire sont configurables, procédez comme suit pour y accéder :

  1. Cliquez sur  Ajouter un élément de requête, puis sélectionnez Agrégation secondaire.
  2. Configurez l'élément Agrégation secondaire.

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 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 Alias de légende.
  2. Cliquez sur 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} a été 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é.

Étape suivante