Comprendre comment les types de ressources surveillées, les types de métriques, les étiquettes et les séries temporelles fonctionnent ensemble dans Cloud Monitoring vous aide à interroger et à interpréter les données de surveillance avec précision. Vous appliquez ces concepts lorsque vous récupérez des données de séries temporelles avec l'API Cloud Monitoring.
Si ces concepts sont nouveaux pour vous, commencez par Métriques, séries temporelles et ressources. Pour en savoir plus sur les schémas d'objets de l'API Monitoring, consultez Structure des séries temporelles.
Un mot sur les libellés
Les types de ressources surveillées et les types de métriques prennent en charge les libellés, ce qui permet de classer les données lors de l'analyse. Exemple :
- Un type de ressource surveillée pour une machine virtuelle peut inclure des étiquettes pour l'emplacement de la machine et l'ID du projet associé à la machine. Lorsque des informations sur la ressource surveillée sont enregistrées, elles incluent les valeurs des libellés.
- Un type de métrique qui compte les requêtes API peut avoir des libellés pour enregistrer le nom de la méthode appelée et l'état de la requête.
L'utilisation des libellés est décrite plus en détail dans la section Libellés.
Types de ressources surveillées
Une ressource surveillée est une ressource à partir de laquelle les données de métrique sont capturées. Cloud Monitoring accepte environ 270 types de ressources surveillées.
Les types de ressources surveillées incluent les nœuds et les tâches génériques, les composants architecturaux de Google Kubernetes Engine, et bien d'autres.Chaque type de ressource surveillée est officiellement décrit dans une structure de données appelée descripteur de ressources surveillées. Pour en savoir plus, consultez Descripteurs de ressources surveillées.
Chacun des types de ressources surveillées compatibles contient une entrée dans la liste des ressources surveillées. Les entrées de la liste sont créées à partir des descripteurs de ressources surveillées. Cette section décrit les informations capturées dans un descripteur de ressource surveillée et montre comment elles sont présentées dans la liste.
Exemple de type de ressources surveillées
L'image suivante montre l'entrée dans la liste pour un bucket Cloud Storage :
Toutes les entrées de la liste incluent les informations suivantes :
- Type : l'en-tête de l'entrée indique le type de ressource surveillée,
gcs_bucketdans l'exemple. - Display name (Nom à afficher) : brève description de la ressource surveillée.
- Description : description plus longue de la ressource surveillée.
- Libellés : ensemble de dimensions permettant de classer les données. Pour plus d'informations, consultez la section Libellés.
Types de métriques
Un type de métrique décrit les mesures pouvant être collectées à partir d'une ressource surveillée. Un type de métrique inclut une description de ce qui est mesuré et comment les mesures sont interprétées.Les types de métriques incluent le nombre d'appels d'API, les statistiques d'utilisation du disque, la consommation de l'espace de stockage, etc.
Chaque type de métrique est officiellement décrit dans une structure de données appelée descripteur de la métrique. Pour en savoir plus, consultez Descripteurs de métriques.
Chacun des types de métriques intégrés possède une entrée dans les pages de la liste des métriques. Les entrées de ces tables sont créées à partir des descripteurs de métriques. Cette section décrit les informations capturées dans un type de métrique et montre comment elles sont présentées dans la documentation de référence.
Exemple de type de métriques
L'image suivante montre une entrée pour un type de métrique Cloud Storage :
Les types de métriques sont affichés dans une table, dont l'en-tête explique la disposition des informations. Cette section utilise une entrée comme exemple, mais toutes les tables utilisent le même format.
L'exemple d'entrée de table Cloud Storage fournit les informations suivantes sur un type de métrique :
Metric type (Type de métrique) : identifiant du type de métrique,
storage.googleapis.com/api/request_countdans le cas présent.Le préfixe
storage.googleapis.comfait office d'espace de noms pour Cloud Storage. Tous les types de métriques associés à un type de ressource surveillée spécifique utilisent le même espace de noms.Les espaces de noms sont omis dans les entrées des tables.
Tous les types de métriques associés à Cloud Storage sont répertoriés dans la table des métriques Cloud Storage.
Étape de lancement : bloc de couleur qui indique l'étape de lancement du type de métrique avec une valeur telle que Alpha, Bêta ou DG.
Display name (Nom à afficher) : brève chaîne décrivant le type de métrique, "Request count" (Nombre de requêtes) dans le cas présent.
Kind, Type, Unit (Genre, Type, Unité) : cette ligne fournit des informations permettant d'interpréter les valeurs des données. L'exemple montre une métrique delta enregistrée sous forme d'entier de 64 bits sans unité (valeur
1).Genre : cet exemple est une métrique delta, qui enregistre une modification sur une période donnée. Autrement dit, chaque point de données enregistre le nombre d'appels d'API depuis l'écriture du point de données précédent. Pour plus d'informations sur les genres, consultez la section Types de valeurs et genres de métriques.
Type : cet exemple enregistre ses valeurs sous forme d'entiers 64 bits. Pour en savoir plus sur les types, consultez Types de valeurs et genres de métriques.
Unit (Unité) : cette métrique n'a pas besoin d'une unité explicite, car elle représente un décompte. Le chiffre
1est utilisé pour indiquer qu'aucune unité n'est nécessaire.
Ressources surveillées : ressources surveillées pour lesquelles ce type de métrique est disponible. Les valeurs indiquées ici sont les mêmes que celles décrites dans la section Types de ressources surveillées.
Description : informations plus détaillées ce qui est enregistré et selon quelle méthode. Indiquez-la en italique pour la distinguer des libellés.
Libellés : ensemble de dimensions permettant de classer les données. Pour plus d'informations, consultez la section Libellés.
Lorsque vous accédez aux données de surveillance via l'API Cloud Monitoring, vous incluez un projet Cloud de Confiance dans l'appel d'API. Vous ne pouvez récupérer que les données visibles par ce projet Cloud de Confiance . Par exemple, si vous demandez les données de votre projet pour le type de métrique storage.googleapis.com/api/request_count, vous ne verrez que le nombre d'API pour les buckets Cloud Storage de votre projet.
Si votre projet n'utilise pas de buckets Cloud Storage, aucune donnée de métrique n'est renvoyée.
Types de métriques intégrées
Les types de métriques intégrés sont définis par des services Cloud de Confiance by S3NS , y compris Cloud Monitoring. Ces types de métriques décrivent des mesures standards pour large part de l'infrastructure commune et sont accessibles à tous.
La liste des métriques affiche l'ensemble des types de métriques intégrés.Étiquettes
Une étiquette est une paire clé/valeur qui peut être utilisée pour fournir des informations sur une valeur de données.
Libellés de métriques et de ressources surveillées
Les définitions des types de métriques et de ressources surveillées incluent des libellés. Les libellés sont des outils de classification des données collectées. Ils permettent de classer les données pour une analyse plus approfondie. Exemple :
- Le type de métrique Cloud Storage
storage.googleapis.com/api/request_countcomporte deux libellés :response_codeetmethod. - Le type de ressource surveillée Cloud Storage
gcs_bucketcomporte trois libellés :project_id,bucket_nameetlocation. Les libellés identifient des instances spécifiques du type de ressource.
Par conséquent, toutes les données collectées pour les requêtes API d'un bucket Cloud Storage sont classées selon la méthode appelée, le code de réponse de l'appel, ainsi que le nom, l'emplacement et le projet du bucket concerné. L'ensemble de libellés varie en fonction du type de métrique ou de ressource surveillée. Les libellés disponibles sont présentés dans les pages Liste des métriques et Liste des ressources surveillées.
En suivant le code de réponse, le nom de la méthode et l'emplacement lors du comptage des appels d'API, vous pouvez ensuite récupérer le nombre d'appels à une méthode d'API particulière, le nombre d'appels ayant échoué à n'importe quelle méthode ou le nombre d'appels ayant échoué à une méthode spécifique dans un emplacement spécifique.
Le nombre de libellés et le nombre de valeurs que chacun peut accepter est appelé cardinalité. La cardinalité correspond au nombre de séries temporelles pouvant être collectées pour une paire de type de métrique et de type de ressource surveillée : il existe une série temporelle pour chaque combinaison de valeurs de leurs libellés. Pour en savoir plus, consultez Cardinalité : séries temporelles et étiquettes.
Séries temporelles : données d'une ressource surveillée
Cette section décrit les données de surveillance et leur organisation en séries temporelles. C'est là que les composants conceptuels du modèle de métrique deviennent des artefacts concrets.
Cloud Monitoring stocke des mesures régulières au fil du temps pour les paires de types de métriques et de ressources surveillées. Les mesures sont collectées en séries temporelles, et chaque série temporelle contient les éléments suivants :
Le nom du type de métrique auquel appartient la série temporelle, et une combinaison de valeurs pour les libellés de la métrique.
Une série de paires (horodatage, valeur). La valeur correspond à la mesure, et l'horodatage correspond à l'heure à laquelle la mesure a été effectuée.
La ressource surveillée qui est la source des données de séries temporelles, et une combinaison de valeurs pour les libellés de la ressource.
Une série temporelle est créée pour chaque combinaison d'étiquettes de métriques et de ressources qui génère des données.
Exemple stylisé : le type de métrique storage.googleapis.com/api/request_count peut comporter de nombreuses séries temporelles pour les buckets Cloud Storage de votre projet. Le tableau suivant présente quelques séries temporelles possibles.
Dans le tableau, la valeur bucket: xyz représente la valeur de l'étiquette bucket_name dans le type de ressource surveillée, et response_code et method sont des étiquettes dans le type de métrique. Il existe une série temporelle pour chaque combinaison de valeurs dans les étiquettes de ressource et de métrique. Le tableau en présente quelques-unes :
| Étiquette de ressource surveillée |
Étiquettes de métriques | Données de métriques |
|---|---|---|
bucket: 1234 |
response_code: OK, |
{ |
bucket: 1234 |
response_code: OK, |
{ |
bucket: 1234 |
response_code: FAIL, |
{ |
bucket: 9876 |
response_code: OK, |
{ |
Cloud Monitoring n'enregistre pas les séries temporelles "vides". Dans l'exemple des buckets Cloud Storage, si vous n'utilisez pas un bucket particulier ou si vous n'appelez jamais une méthode d'API particulière, aucune donnée n'est collectée pour ce libellé et aucune série temporelle ne le mentionne. Cela signifie que, si votre projet ne contient aucune donnée pour une métrique spécifique, le type de métrique ne s'affiche jamais.
Les types de métriques n'indiquent pas les types de ressources surveillées trouvés dans les séries temporelles des métriques. Pour Cloud Storage, il n'existe qu'un seul type de ressource surveillée : gcs_bucket. Certains types de métriques sont associés à plusieurs ressources surveillées.
Cardinalité : séries temporelles et libellés
Chaque série temporelle est associée à une paire spécifique de types de métriques et de ressources surveillées. Les types de métriques et de ressources surveillées fournissent chacun un certain nombre d'étiquettes. Dans Cloud Monitoring, le nombre de combinaisons uniques de valeurs pour l'ensemble d'étiquettes correspond à la cardinalité du type de métrique ou du type de ressource surveillée. Ces valeurs sont appelées cardinalité de métrique et cardinalité de ressource. Elles déterminent le nombre de séries temporelles possibles, la cardinalité totale, qui peuvent être générées.
Supposons que vous disposiez d'un type de métrique qui spécifie deux étiquettes, color et zone. La cardinalité de la métrique dépend du nombre de valeurs possibles de ces étiquettes :
- S'il n'y a que trois couleurs possibles, "rouge", "vert" et "bleu", l'étiquette
colorpeut avoir jusqu'à trois valeurs distinctes. - S'il n'y a que deux zones possibles, "est" et "ouest", l'étiquette
zonepeut avoir jusqu'à deux valeurs distinctes.
La cardinalité de cette métrique est de 6 (3 × 2). S'il existe 1 000 valeurs possibles pour l'étiquette color et que chaque couleur peut apparaître dans chaque zone, la cardinalité de la métrique est de 2 000 (1 000 × 2). Le même calcul s'applique s'il s'agit d'étiquettes sur un type de ressource surveillée plutôt que sur un type de métrique.
Cette valeur de cardinalité est un maximum, basé sur le nombre de combinaisons de valeurs d'étiquettes possibles. La valeur réelle peut être nettement inférieure lorsque toutes les combinaisons de valeurs d'étiquettes ne se produisent pas réellement. Par exemple, si chaque couleur n'apparaît que dans une seule zone, et non dans les deux, le nombre maximal de séries temporelles que vous voyez dans le système en cours d'exécution est de 1 000. Toutefois, l'utilité de la cardinalité effective dépend des raisons pour lesquelles certaines combinaisons n'apparaissent pas et de la possibilité qu'elles apparaissent à l'avenir.
Lorsque des données de séries temporelles sont écrites, elles sont classées par types de métriques et de ressources surveillées. Pour toute paire de types de métriques et de ressources, la cardinalité totale est le produit de la cardinalité des métriques et de la cardinalité des ressources. Si vous disposez d'une métrique avec une cardinalité de 1 000 et d'une ressource avec une cardinalité de 100, et si chaque valeur d'étiquette apparaît, vous disposez de 100 000 séries temporelles (1 000 x 100).