Sélectionner des métriques pour les graphiques des tableaux de bord

Ce document explique comment configurer un graphique sur un tableau de bord personnalisé pour afficher les données de séries temporelles collectées par votre projet. Les graphiques ne peuvent afficher que des données de séries temporelles numériques. Pour en savoir plus sur la configuration du style d'un graphique, consultez Définir les options d'affichage des graphiques.

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 en écrivant 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 et la manière dont elles sont regroupées et alignées. L'interface MQL prend en charge 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 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 du langage de requête Prometheus (PromQL) spécifient les séries temporelles et la manière dont elles sont regroupées et alignées. L'interface PromQL prend en charge 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 ou d'alignement.

Toutes les séries temporelles pouvant être représentées par Monitoring peuvent être spécifiées à 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 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 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 toutes deux 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, vous configurez les paramètres de regroupement et d'alignement à l'aide de menus.

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

La création de requêtes à l'aide de menus est la configuration par défaut. En règle générale, si vous sélectionnez une métrique et un filtre, puis passez à une autre 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 pilotée par menu à partir des autres interfaces en sélectionnant Builder (Compilateur). Cependant, votre requête est supprimée. Autrement dit, une requête MQL ne peut pas être convertie dans un format équivalent basé sur un menu.

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

Dans le panneau de navigation de la console Google Cloud, sélectionnez Monitoring, puis Tableaux de bord :
Accédez à Tableaux de bord.
Effectuez l'une des opérations suivantes :
- Pour créer un nouveau tableau de bord, sélectionnez Créer un tableau de bord.
- Pour mettre à jour un tableau de bord existant, recherchez-le dans la liste des tableaux de bord, puis sélectionnez son nom.
Dans la barre d'outils, cliquez sur Ajouter un widget.
Dans la boîte de dialogue Add widget (Ajouter un widget), sélectionnez Métrique.
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 restreignez le menu pour 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 avec des données.
2. Effectuez votre 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 sous forme de graphique, vous pouvez sélectionner Instance de VM, Instance et Utilisation du processeur, puis cliquer sur Appliquer.
  
  Le menu Ressources répertorie la ressource à partir de laquelle les données sont collectées. Lorsqu'aucune métrique n'est écrite pour une ressource, sélectionnez Non spécifié.
Une fois l'étape précédente terminée, le graphique affiche les séries temporelles disponibles:

Le graphique précédent contient plus de données que vous ne pouvez en afficher. Les graphiques sont limités à 50 lignes affichables. Le graphique indique que la quantité de données à afficher est trop importante. Pour réduire la quantité de données, utilisez les champs de l'élément Trier et limiter. Pour en savoir plus, consultez 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 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.
Pour appliquer vos modifications au tableau de bord, cliquez sur Apply (Appliquer) dans la barre d'outils. Pour supprimer vos modifications, cliquez sur Annuler.

Les filtres garantissent 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 les options d'agrégation, ainsi qu'à trier et limiter le nombre de séries temporelles affichées. Pour en savoir plus, consultez 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(e) à, =
est différent(e) de, !=
Correspondance d'expression régulière : =~
l'expression régulière ne correspond pas à !=~

Lorsque vous filtrez les données par ID de projet ou par conteneur de ressources, vous devez utiliser l'opérateur est é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 libellés de métriques et de ressources, et 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 (opérateur logique AND).

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

Dans l'élément Filter (Filtre), cliquez sur Add filter (Ajouter un filtre) et sélectionnez une option dans le menu.
Pour modifier la comparaison, sélectionnez une valeur dans le menu Comparateur.
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 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"). Pour en savoir plus sur les chaînes de filtres, consultez la section 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 satisfaits. Ils constituent une AND logique.

Pour modifier la valeur ou le comparateur d'un filtre, dans 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:

Dans le panneau de navigation de la console Google Cloud, sélectionnez Monitoring, puis Tableaux de bord :
Accédez à Tableaux de bord.
Effectuez l'une des opérations suivantes :
- Pour créer un nouveau tableau de bord, sélectionnez Créer un tableau de bord.
- Pour mettre à jour un tableau de bord existant, recherchez-le dans la liste de tous les tableaux de bord, puis sélectionnez son nom.
Dans la barre d'outils, cliquez sur Ajouter un widget.
Dans la boîte de dialogue Add widget (Ajouter un widget), sélectionnez Métrique.
Dans la barre d'outils du volet de création de requêtes, sélectionnez le bouton nommé MQL ou PromQL.
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.
Facultatif : Désactivez l'option Exécution automatique.
Saisissez votre requête dans l'éditeur de requête. Par exemple, pour représenter l'utilisation du processeur par les instances de VM de 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:
- Présentation de MQL
- Utiliser l'éditeur de code pour MQL
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 PromQL

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

Dans le panneau de navigation de la console Google Cloud, sélectionnez Monitoring, puis Tableaux de bord :
Accédez à Tableaux de bord.
Effectuez l'une des opérations suivantes :
- Pour créer un nouveau tableau de bord, sélectionnez Créer un tableau de bord.
- Pour mettre à jour un tableau de bord existant, recherchez-le dans la liste de tous les tableaux de bord, puis sélectionnez son nom.
Dans la barre d'outils, cliquez sur Ajouter un widget.
Dans la boîte de dialogue Add widget (Ajouter un widget), sélectionnez Métrique.
Dans la barre d'outils du volet de création de requêtes, sélectionnez le bouton nommé MQL ou PromQL.
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.
Facultatif : Désactivez l'option Exécution automatique.
Saisissez votre requête dans l'éditeur de requête. Par exemple, pour représenter 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 section PromQL dans Cloud Monitoring.
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 saisir 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 équivalent à un filtre de métrique, est une expression utilisée par Monitoring pour identifier les séries temporelles à 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 machine virtuelle 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 le panneau de navigation de la console Google Cloud, sélectionnez Monitoring, puis Tableaux de bord :
Accédez à Tableaux de bord.
Effectuez l'une des opérations suivantes :
- Pour créer un nouveau tableau de bord, sélectionnez Créer un tableau de bord.
- Pour mettre à jour un tableau de bord existant, recherchez-le dans la liste des tableaux de bord, puis sélectionnez son nom.
Dans la barre d'outils, cliquez sur Ajouter un widget.
Dans la boîte de dialogue Add widget (Ajouter un widget), sélectionnez Métrique.
Cliquez sur Help (Aide) sur l'élément Metric (Métrique), puis sélectionnez Direct Filter Mode (Mode de filtrage direct).

Les éléments Métrique et Filtre sont supprimés, et un élément Filtres est créé, qui 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), ces paramètres sont affichés dans l'élément Filters (Filtres).
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épondant aux critères du filtre 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 menu, cliquez sur Quitter le mode de filtrage direct.

Choisir le mode d'affichage des données représentées graphiquement

Une fois les séries temporelles sélectionnées, l'étape suivante consiste à déterminer comment ces données sont affichées. Par exemple, voulez-vous afficher chaque série temporelle ou souhaitez-vous combiner des séries temporelles ?

Cette section explique comment définir les 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, consultez Explorer les données représentées graphiquement.

Le contenu de cette section ne s'applique pas si vous avez sélectionné les données à représenter graphiquement à l'aide de 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 spécifiez généralement un ou plusieurs libellés et une fonction. Les séries temporelles qui ont 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 Aggregation (Agrégation) peuvent modifier le nombre de séries temporelles affichées dans le 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 chaque série temporelle, dans l'élément Aggregation (Agrégation), assurez-vous que le premier menu est défini sur Unaggregated (Non agrégé) et que le second menu est défini sur None (Aucun).
Pour combiner des séries temporelles, dans l'élément Aggregation (Agrégation), procédez comme suit:
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 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 d'étiquette, 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 combinaison unique de valeurs de libellé. 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 d'une série temporelle spécifique pour une version spécifique:

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

Lorsque vous sélectionnez plusieurs libellés, les séries temporelles ayant les mêmes valeurs pour les libellés sélectionnés 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 de libellé. Le fait que vous obteniez une série temporelle pour chaque combinaison de libellés 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, sur l'élément Aggregation (Agrégation), définissez le premier menu sur Unaggregated (Non agrégé) et le second menu sur None (Aucun).

Aligner des données

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 des points à combiner, cliquez sur Ajouter un élément de requête dans le volet des requêtes, 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 afficher une semaine de données, il y a trop de points à afficher. 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.

À des fins de comparaison, la capture d'écran suivante illustre l'effet du changement d'intervalle de 1 minute à 5 minutes:

Utilisation du processeur pour les instances de VM avec la valeur par défaut avec une période d'alignement de 5 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 du champ Min Interval (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 la fonction d'alignement pour vous. 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 effectué par Cloud Monitoring.

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

Dans l'élément Agrégation, développez le premier menu et sélectionnez Configurer l'aligneur. Ajout des éléments de fonction d'alignement et de regroupement.
Développez l'élément Fonction d'alignement et sélectionnez-en un.

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

suivant plus ancien: pour ne conserver que l'échantillon le plus récent au cours d'une période d'alignement, sélectionnez next plus ancien. Cette fonction est couramment utilisée avec les tests de disponibilité. Elle est idéale 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 de delta lorsqu'elles ont un type de données de distribution.
delta: pour convertir une métrique cumulative ou une métrique delta en métrique delta avec un échantillon par période d'alignement, utilisez cette fonction. L'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 que la série temporelle est transformée de la même manière qu'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.

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

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 correspondent aux paramètres d'agrégation secondaires.

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

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