Configurer une métrique cible

Cette page explique comment utiliser l'outil de sélection de métriques afin de spécifier une métrique cible pour une règle d'alerte. Le graphique situé à côté de la région cible vous donne un aperçu visuel des données capturées par la cible.

La région cible utilise le même sélecteur de métriques que celui utilisé dans l'explorateur de métriques, ainsi que pour la création de graphiques. Si vous le connaissez déjà, vous pouvez ignorer cette page.

Sélectionner une métrique

Pour sélectionner une métrique, utilisez le champ Find resource type and metric (Trouver le type de ressource et la métrique) afin de choisir un type de ressource et un type de métrique. Vous pouvez les spécifier dans n'importe quel ordre. Pour commencer, cliquez dans le champ. Une ou deux listes s'affichent, selon les éléments précédemment sélectionnés. Ces listes sont identifiées par les en-têtes Resource types (Types de ressources) et Metrics (Métriques), comme dans cette capture d'écran :

Listes de recherche pour la sélection de métriques et de ressources.

Vous pouvez sélectionner une entrée de deux manières :

  • Sélectionnez cette entrée dans l'une des listes.

  • Saisissez un filtre de métrique. Pour saisir un filtre de métrique, procédez comme suit :

    1. À côté de Find resource type and metric (Rechercher un type de ressource et une métrique), cliquez sur Aide .
    2. Cliquez sur Direct filter mode (Mode de filtrage direct) dans le panneau d'aide.

      Lorsque Direct filter mode (Mode de filtrage direct) est activé, l'option Find resource type and metric (Rechercher un type de ressource et une métrique) est remplacée par une zone de texte modifiable intitulée Resource type, metric, and filter (Type de ressource, métrique et filtre) :

      Le mode de filtrage direct s'affiche.

      Si vous avez sélectionné un type de ressource, une métrique ou un filtre avant d'activer le Mode de filtrage direct, ces paramètres sont utilisés pour préremplir la zone de texte Resource type, metric, and filter (Type de ressource, métrique et filtre).

    3. Saisissez un filtre de métrique dans la zone de texte Resource type, metric, and filter (Type de ressource, métrique et filtre). Votre filtre doit inclure un type de métrique et un type de ressource. Vous pouvez également inclure des filtres de libellés. Pour en savoir plus sur la syntaxe de filtrage, consultez la page Filtres de surveillance.

      Par exemple, pour afficher les entrées de journal correspondant à l'ensemble des instances de VM Google Cloud dans la zone us-east1-b, saisissez ce qui suit :

      metric.type="logging.googleapis.com/log_entry_count" resource.type="gce_instance" resource.label."zone"="us-east1-b"
          

      Si vous avez utilisé le mode de filtrage direct pour configurer des graphiques ou des règles d'alerte et qu'aucune donnée n'est disponible, le graphique affiche un message d'erreur. Le message d'erreur exact dépend du filtre que vous avez saisi. Par exemple, Chart definition invalid (Définition de graphique non valide) est un message courant. Le message No data is available for the selected time frame. (Aucune donnée disponible pour la fenêtre temporelle sélectionnée) peut également s'afficher.

En passant la souris sur l'une ou l'autre liste, vous obtenez une info-bulle affichant les informations contenues dans le descripteur de l'élément désigné. Pour en savoir plus sur les descripteurs des types de métriques ou des ressources surveillées, consultez la liste des métriques ou la liste des ressources surveillées.

Dès que vous avez sélectionné au moins une paire composée d'un type de ressource et d'une métrique, le graphique affiche toutes les séries temporelles disponibles, et des éléments supplémentaires apparaissent sous la métrique spécifiée dans l'onglet Metric (Métrique). La capture d'écran suivante montre l'onglet Metric (Métrique) après qu'une métrique a été spécifiée :

Affichage d'options de sélection supplémentaires.

Filtrer

Vous pouvez réduire la quantité de données renvoyées en spécifiant des critères de filtre, de sorte que seules les séries temporelles répondant à certains critères soient utilisées. Le filtrage supprime certaines données du graphique en excluant les séries temporelles qui ne correspondent pas aux critères de filtrage. Vous réduisez ainsi le nombre de lignes tracées sur le graphique représentant ces métriques, ce qui peut améliorer les performances de ce graphique.

Vous pouvez fournir 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).

Lorsque vous cliquez dans le champ Filter (Filtre), un panneau contenant les listes des critères de filtre possibles apparaît. Dans les grandes lignes, vous pouvez filtrer par groupe de ressources, par nom, par libellé de ressource et par libellé de métrique.

La capture d'écran suivante montre les libellés de filtrage connus pour un projet déterminé :

Listes de libellés de filtre préremplies

Vous pouvez choisir parmi les listes ou saisir une chaîne pour trouver des correspondances. En outre, vous pouvez créer des filtres correspondant à des données qui ne sont pas encore apparues. De tels critères de filtrage n'apparaîtront pas dans la liste de sélection, mais vous pouvez spécifier manuellement des filtres dont vous savez qu'ils seront valides à l'avenir.

Après avoir choisi le libellé sur lequel filtrer, vous devez spécifier les autres composantes du filtre : une valeur ou une plage de valeurs, et un opérateur de comparaison.

Par exemple, la capture d'écran suivante présente un filtre configuré sur le libellé de ressource zone. Le champ Filter (Filtre) accepte une paire d'opérateurs de comparaison pour l'égalité, = et =~, ainsi qu'une paire pour l'inégalité, != et !=~. Le deuxième élément de chaque paire prend une expression régulière en tant que valeur. L'égalité simple = est la valeur par défaut.

Comparateurs de filtres

En dessous de la liste des opérateurs de comparaison se trouve une liste des valeurs disponibles. La capture d'écran suivante montre les noms des zones du projet :

Quelques valeurs de filtre prérenseignées

Pour le champ Value (Valeur), vous pouvez sélectionner l'un des éléments de la liste déroulante ou saisir une expression qui correspond à plusieurs éléments :

  • Si vous utilisez une comparaison directe = ou !=, vous pouvez créer une chaîne de filtre telle que starts_with (commence par). Par exemple, la chaîne de filtre starts_with("us-central") correspond à n'importe quelle zone us-central :

    Utiliser une chaîne de filtre

    Consultez la section Surveiller les filtres pour en savoir plus sur les chaînes de filtres.

  • Si vous sélectionnez =~ ou !=~, vous pouvez utiliser une expression régulière dans la valeur. Par exemple, l'expression régulière us-central1-.* correspond à n'importe quelle zone us-central1 :

    Filtrer avec les expressions régulières

    L'expression régulière ^us.*.a$ correspond à n'importe quelle zone des États-Unis se terminant par "a" :

    Filtrer avec plus d'expressions régulières

Vous pouvez spécifier plusieurs critères de filtre et utiliser le même libellé plusieurs fois. Cela vous permet de spécifier un filtre pour une plage de valeurs. Pour ajouter des filtres, cliquez sur Add a filter (Ajouter un filtre) au bas du champ de filtre. Actuellement, tous les critères de filtrage doivent être satisfaits (opérateur logique AND). Par exemple, vous pouvez utiliser les chaînes de filtre starts_with et ends_with pour afficher seulement les zones se terminant par "a" aux États-Unis :

Utiliser plusieurs filtres

Regroupement

Vous pouvez réduire la quantité de données renvoyées pour une métrique en combinant des données de séries temporelles similaires.

Comme le filtrage, le regroupement permet de réduire la quantité de données que vous manipulez. Le filtrage a pour effet d'exclure certaines séries temporelles, tandis que le regroupement consiste à identifier des ensembles de séries temporelles correspondant tous à certains critères, puis à combiner, ou agréger, les membres des ensembles.

Le regroupement est effectué en fonction des libellés. Lorsque vous cliquez dans le champ Group By (Grouper par), vous obtenez les mêmes libellés que ceux disponibles pour le filtrage.

L'option Group By (Grouper par) vous permet de regrouper des séries temporelles par libellé de ressource et de métrique, puis de combiner les données au sein de ces groupes. Vous créez ainsi une série temporelle unique pour chaque combinaison de valeurs de regroupement. Cette série représente tous les membres du groupe.

Par exemple, supposons que vous souhaitiez examiner la charge de journalisation, mais uniquement au niveau régional : vous ne vous souciez donc pas du nombre d'entrées provenant des différents serveurs. Vous pouvez regrouper les séries temporelles par zone, puis générer un graphique représentant le total, la moyenne ou toute autre mesure pour chaque zone.

L'option Group By (Grouper par) sélectionne une fonction d'agrégation par défaut selon le type de données regroupé. Vous pouvez toutefois modifier cette sélection. Pour en savoir plus sur les autres options possibles, consultez la section Agrégation.

La capture d'écran suivante montre un regroupement par zone. L'option sum (Somme) qui figure sous Aggregator (Agrégateur) est définie par défaut.

Regrouper des séries temporelles

Vous créez ainsi une nouvelle série temporelle pour chaque zone, avec des valeurs correspondant à la somme de toutes les valeurs des différentes séries temporelles de cette zone.

Vous pouvez également effectuer un regroupement d'après plusieurs libellés. En ce cas, vous obtenez une série temporelle pour chaque combinaison de libellés. L'ordre dans lequel vous spécifiez les libellés est indifférent.

Pour supprimer une condition de regroupement, procédez comme suit :

  1. Supprimez les libellés de regroupement.
  2. Définissez la méthode d'agrégation sur none (aucune).

Agrégation

L'option Aggregator (Agrégateur) vous permet de combiner des séries temporelles à l'aide de fonctions courantes. Cela permet de réduire le nombre de lignes sur le graphique affichant la métrique, ce qui peut améliorer les performances de ce graphique.

Cliquez dans le champ Aggregator (Agrégateur) pour afficher la liste des options d'agrégation disponibles. Il s'agit des fonctions, ou réducteurs, qui permettent de combiner les séries temporelles.

Les fonctions de réduction disponibles dépendent du type des valeurs capturées par la métrique. Toutefois, elles incluent généralement des options telles que la moyenne, le maximum ou le minimum, l'écart type, différentes valeurs de centile, etc. Pour en savoir plus sur ces dépendances, consultez la page Métriques, séries temporelles et ressources.

Lorsqu'elle est utilisée sans regroupement, la fonction de réduction s'applique à toutes les séries temporelles sélectionnées, qui sont alors combinées en une seule série temporelle composée de la moyenne, de la somme ou d'une autre mesure calculée pour l'ensemble de ces séries temporelles. Lorsqu'elle est utilisée avec le regroupement, la fonction est appliquée à la série temporelle de chaque groupe.

Pour en savoir plus sur l'agrégation, consultez la section Aggregation dans la documentation de référence de l'API.

L'option Group by (Grouper par) applique automatiquement l'agrégation pour calculer des statistiques au sein de chaque groupe. Les lignes d'un graphique généré avec l'option Group by (Grouper par) représentent déjà des agrégations. L'option Group By (Grouper par) sélectionne une fonction d'agrégation par défaut selon le type de données regroupé. Vous pouvez toutefois modifier cette sélection.

Vous pouvez également appliquer une agrégation à un ensemble de séries temporelles que vous avez filtrées. Comme pour les séries temporelles non filtrées, l'agrégation de séries temporelles filtrées réduit l'ensemble des lignes à une ligne unique reflétant la fonction d'agrégation choisie, à moins que vous n'utilisiez également le regroupement.

Il existe d'autres options pour sélectionner une métrique. Elles ont des valeurs par défaut. Vous pouvez toutefois afficher ces options et remplacer les valeurs par défaut. Pour afficher les autres options, cliquez sur Show advanced options (Afficher les options avancées).

Alignement

Une série temporelle est un ensemble de points de données indiqués dans l'ordre chronologique. Aligner une série temporelle consiste à répartir les points de données en intervalles de temps réguliers définissant la durée de l'alignement. Lorsque vous utilisez plusieurs séries temporelles, celles-ci doivent être alignées avant de pouvoir être combinées.

L'alignement est une condition préalable à l'agrégation de plusieurs séries temporelles et s'applique individuellement à chacune de ces dernières. Étant donné que l'alignement est une condition préalable à la représentation graphique des données, Monitoring le fait automatiquement, à l'aide de valeurs par défaut. Vous pouvez remplacer ces valeurs par défaut à l'aide des options d'alignement Aligner (Aligneur) et Alignment Period (Durée de l'alignement).

Champs correspondant aux options d'alignement

Alignment Period (Durée de l'alignement) : ce paramètre indique la durée du processus de subdivision de la série temporelle. Par exemple, vous pouvez diviser une série temporelle en blocs d'une minute ou d'une heure. Les données correspondant à chaque durée sont résumées de sorte que cette dernière soit représentée par une valeur unique. La durée d'alignement par défaut est d'une minute.

Même si vous pouvez définir l'intervalle d'alignement pour vos données, les séries temporelles peuvent être réalignées lorsque vous modifiez l'intervalle de temps affiché sur un graphique ou le niveau de zoom.

Aligner (Aligneur) : l'aligneur est une fonction qui détermine comment les données correspondant à chaque durée d'alignement doivent être résumées. Il inclut la somme, la moyenne, etc. Les options d'aligneur valides dépendent du genre et du type des données de métriques stockées dans une série temporelle. En d'autres termes, les options d'aligneur proposées sont déterminées par les valeurs MetricKind et ValueType de la série temporelle.

Certains aligneurs se chargent à la fois d'aligner les données et de les convertir d'un genre ou d'un type de métrique à un autre. Pour en savoir plus sur les aligneurs 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, comme dans les exemples illustrant l'option Group By (Grouper par), vous pouvez ensuite les agréger en choisissant l'option Secondary Aggregator (Agrégateur secondaire).

Champ correspondant à l'agrégation secondaire

L'agrégation secondaire permet de réduire toutes les séries temporelles du graphique à une série unique.

Modèle de légende

Le champ Legend Template (Modèle de légende) vous permet de personnaliser une description de série temporelle sur votre graphique. Cette description apparaît sur la fiche informative du graphique et dans la légende figurant dans la colonne Nom.

Par défaut, cette description est créée pour vous à partir des valeurs de 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. Ce champ vous permet de créer un modèle pour les descriptions.

Le champ Legend Template (Modèle de légende) accepte les éléments suivants :

  • Texte brut.
  • Variables représentant des libellés de votre série temporelle. Les libellés disponibles dépendent de la série temporelle que vous représentez. Toutefois, la syntaxe des variables se présente généralement comme suit : ${resource.labels.project_id}. La notation ${} entraîne l'évaluation de la variable dans votre description.

Si vous ne spécifiez que du texte, les descriptions des séries temporelles du graphique sont identiques. L'utilisation de variables vous permet d'intégrer des valeurs de libellés des séries temporelles dans la description.

Si vous connaissez les noms des variables, vous pouvez les saisir manuellement dans le champ du modèle. Vous avez également la possibilité de sélectionner des variables pour les libellés disponibles en utilisant le widget + Add a filter (Ajouter un filtre) dans le champ. Cette approche garantit que la syntaxe des variables est correcte.

La capture d'écran ci-dessous montre un modèle composé d'une chaîne et d'une seule variable.

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 intitulée Name (Nom). Les valeurs s'affichent également sur la fiche informative.

La capture d'écran ci-dessous montre les valeurs Name (Nom) et la fiche informative résultant du modèle.

Descriptions générées à partir d'un modèle

Vous pouvez créer des modèles qui utilisent plusieurs chaînes et variables. Toutefois, l'espace disponible pour l'affichage sur la fiche informative est limité.