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 sur un graphique, vous pouvez créer une requête en effectuant des sélections dans les menus ou écrire une requête. Lorsque vous écrivez 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 MQL (Monitoring Query Language) spécifient les séries temporelles, ainsi que la manière dont elles sont regroupées et alignées. L'interface MQL propose 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 dans des formulaires pouvant être utilisés 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, ainsi que leur mode de regroupement et d'alignement. L'interface PromQL propose un éditeur avec des suggestions.

    Il n'est généralement pas possible de convertir les requêtes PromQL dans des formulaires pouvant être utilisés 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 de surveillance spécifient la série temporelle, mais n'incluent pas d'instructions de regroupement ou d'alignement.

    Toutes les séries temporelles que Monitoring peut représenter peuvent être spécifiées à l'aide d'un filtre Monitoring. Par exemple, pour représenter sous forme graphique 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 peut ê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 page 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 créez un filtre Monitoring ou utilisez des menus pour sélectionner la série temporelle à représenter dans le 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 changez d'interface, vos sélections sont conservées et reformatées pour cette interface. Autrement dit, une requête construite par des menus peut être convertie en requête MQL.

Vous pouvez revenir à l'interface basée sur un menu depuis les autres interfaces en sélectionnant Builder. Cependant, votre requête est ignorée. Autrement dit, une requête MQL ne peut pas être convertie en un format équivalent basé sur le 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 Surveillance.

  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 contient des fonctionnalités qui vous aident à trouver les types de métriques disponibles:

      • Pour rechercher un type de métrique spécifique, utilisez la barre de filtres . Par exemple, si vous saisissez util, vous limitez le menu afin d'afficher les entrées qui incluent 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 celles sans données, cliquez sur Active. Par défaut, les menus n'affichent que les types de métriques contenant 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 machine virtuelle Compute Engine, vous pouvez sélectionner Instance de VM, Instance, Utilisation du processeur, puis cliquer 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 sur 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 être affiché. Les graphiques sont limités à 50 lignes affichables. Le graphique indique qu'il y a trop de données à afficher. Pour réduire la quantité de données, utilisez l'élément Sort & limit (Trier et limiter) dans la barre d'outils de la requête. Pour en savoir plus, consultez la section Afficher 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 les diagnostics et l'analyse, et augmentent les performances et la réactivité de l'interface utilisateur elle-même.

  3. Facultatif: Ajoutez des filtres pour limiter l'affichage des séries temporelles. La section suivante décrit les options de filtrage.

  4. Facultatif: configurez le regroupement et l'alignement des séries temporelles. Pour en savoir plus, consultez la section Choisir comment afficher les 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 du graphique, ce qui peut améliorer ses performances. Une autre façon d'améliorer la réactivité d'un graphique consiste à configurer des options d'agrégation, ainsi qu'à trier et limiter 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 pouvez 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 par conteneur de ressources, vous devez utiliser l'opérateur "égal", (=). Lorsque vous filtrez selon d'autres étiquettes, 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, ainsi que par groupe de ressources.

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 (AND logique).

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

  1. Dans l'élément Filter (Filtre), cliquez sur Add filter (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 Valeur, saisissez ou sélectionnez une valeur:

    • Pour effectuer une comparaison directe, = ou !=, sélectionnez la valeur dans le menu, ou saisissez-en une et 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"). Pour en savoir plus sur les chaînes de filtre, consultez la page Surveiller les 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é.

    • 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=~"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 de spécifier un filtre pour une plage de valeurs.

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

Pour modifier la valeur ou le comparateur d'un filtre, sur l'élément de filtre, cliquez sur Menu , apportez vos 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 votre requête dans l'éditeur de requête. Par exemple, pour représenter l'utilisation du processeur des instances de VM dans votre projet Google Cloud, utilisez 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 l'option Exécution automatique est activée, le bouton Exécuter la requête n'est pas affiché.

É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 votre requête dans l'éditeur de requête. Par exemple, pour représenter sous forme graphique l'utilisation moyenne du processeur par les instances de VM de votre projet Google Cloud, utilisez 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 n'est pas affiché.

É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 un filtre Monitoring:

  • Affichez un objectif de niveau de service (SLO).
  • Affichez 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.
  • Vous pouvez filtrer une série temporelle en fonction d'une étiquette pour laquelle 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 des 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 :

  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. Cliquez sur Help (Aide) sur l'élément Metric (Métrique), puis sélectionnez Direct Filter Mode (Mode de filtrage direct).

    Les éléments Metric (Métrique) et Filter (Filtre) sont supprimés, et un élément Filters (Filtres) qui vous permet de saisir du texte est créé.

    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), ces paramètres sont affichés dans l'élément Filters (Filtres).

  3. Dans la zone de texte de l'élément Filters (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 répondant au filtre n'est disponible, une erreur s'affiche. Voici les 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 en savoir plus, consultez la section Choisir comment afficher les 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 à représenter dans le graphique à 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 une ou plusieurs étiquettes et une fonction. Les séries temporelles ayant la même valeur pour tous les libellés spécifiés sont regroupées, puis la fonction que vous avez spécifiée 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 séries temporelles affichées dans 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 Aggregation (Agrégation), assurez-vous que le premier menu est défini sur Unaggregated (Non agrégé) et le second sur None (Aucun).

  • Pour combiner des séries temporelles, procédez comme suit dans l'élément Aggregation (Agrégation) :

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

      Le graphique est actualisé et n'affiche qu'une seule série temporelle. Par exemple, si vous sélectionnez Mean (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 une ou plusieurs étiquettes.

      Le graphique est actualisé et affiche une série temporelle pour chaque combinaison unique 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 Sum 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 de chaque série temporelle 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 ayant les mêmes valeurs pour les é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 étiquettes user_labels.version et system_labels.machine_image:

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

Comme indiqué, le graphique affiche une série temporelle pour chaque paire de valeurs d'étiquette. Le fait que vous obteniez une série temporelle pour chaque combinaison d'étiquettes signifie que cette technique peut créer plus de données que vous ne pouvez en placer sur un seul graphique.

Afficher toutes les séries temporelles

Pour afficher toutes les séries temporelles, dans l'élément Aggregation (Agrégation), définissez le premier menu sur Unaggregated (Non agrégé) et le second sur None (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 pour la combinaison des points, cliquez sur Ajouter un élément de requête dans le volet de requête, sélectionnez Intervalle minimal, puis renseignez 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 Min Interval (Intervalle minimal) est défini sur 10 minutes, le graphique affiche six points de données. Toutefois, si vous configurez maintenant le graphique pour afficher une semaine de données, le nombre de points à afficher est trop élevé. L'intervalle sur lequel les points sont combinés est donc 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 de l'intervalle de 1 minute à 5 minutes:

Utilisation du processeur par les instances de VM à l'aide de 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. Si vous augmentez le champ Intervalle minimal, davantage de points sont combinés, ce qui a un effet de lissage sur les données représentées.

Définir la fonction d'alignement

Lorsque vous sélectionnez la fonction pour l'agrégation, Cloud Monitoring sélectionne automatiquement la fonction d'alignement. Cloud Monitoring détermine la fonction d'alignement optimale en fonction du type de métrique que vous avez sélectionné et de votre choix pour la fonction d'agrégation. Toutefois, vous pouvez spécifier une fonction d'alignement et ignorer le choix fait 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 Configurer l'aligneur. La fonction d'alignement et les éléments Grouping sont ajoutés.
  2. Développez l'élément Fonction d'alignement, puis effectuez une sélection.

Si la plupart des fonctions d'alignement compatibles effectuent des opérations mathématiques courantes, certaines effectuent des actions plus complexes:

  • Suivant le plus ancien: pour ne conserver que l'échantillon le plus récent d'une période d'alignement, sélectionnez Suivant. Cette fonction est couramment utilisée avec les tests de disponibilité et constitue un bon choix lorsque vous ne vous intéressez qu'à 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. Pour spécifier ce centile, vous pouvez 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 ont un type de données de 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 obtenir un exemple, consultez la section Genres, types et conversions.

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

  • rate: pour convertir une métrique cumulative ou delta en métrique de jauge, utilisez cette fonction. Si vous choisissez cette fonction, vous pouvez considérer la série temporelle en cours de transformation comme elle l'était 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 que l'unité de la période d'alignement est la seconde, le graphique comporte une unité de Mio par seconde. Pour en savoir plus, consultez la section Genres, types et conversions.

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

Pour en savoir plus sur les fonctions d'alignement disponibles, consultez la section 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 Transform sur une valeur autre que None, tous les autres champs constituent les paramètres d'agrégation secondaires.

Lorsque les champs d'agrégation secondaires sont configurables, pour accéder à ces champs, procédez comme suit:

  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 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} :

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