Présentation de l'API Cloud Monitoring

Cette page décrit certaines des fonctionnalités de l'API Cloud Monitoring v3.

Pour obtenir la documentation de référence de l'API, consultez l'une des pages suivantes :

Ressources liées aux API

Métriques

L'API Monitoring v3 vous donne accès à plus de 1 500 métriques Cloud Monitoring depuis Google Cloud et Amazon Web Services. Vous pouvez créer vos propres métriques personnalisées et organiser vos ressources cloud à l'aide de groupes.

Pour un aperçu des concepts de métriques et des structures de données qui les représentent, consultez la section Métriques, séries temporelles et ressources.

Pour en savoir plus sur la gestion des métriques personnalisées et des métriques intégrées, consultez la page Utiliser des métriques personnalisées.

Pour obtenir la liste complète des métriques disponibles, consultez la section Liste des métriques.

Ressources surveillées

Une ressource surveillée est un élément sur lequel des métriques sont collectées. Par exemple, il se peut que vous soyez intéressé par l'activité d'une instance de VM ou d'un élément de matériel.

Pour obtenir la liste des ressources surveillées disponibles, consultez la liste des ressources surveillées.

Groupes de ressources surveillées

Un groupe est une collection dynamique de ressources surveillées. Vous avez toujours pu créer des groupes manuellement dans la console Monitoring et vous pouvez utiliser l'API Cloud Monitoring pour écrire du code qui crée et utilise des groupes.

Pour en savoir plus, consultez la documentation de référence de l'API pour Group.

Règles d'alerte

Une règle d'alerte est une ressource de configuration qui décrit les critères de génération des incidents et la manière dont vous êtes averti lorsqu'un incident est créé. La section Concepts d'alerte décrit les concepts de base des règles d'alerte. Pour plus d'informations, consultez la documentation de référence de l'API pour AlertPolicy.

L'API vous permet également de créer des règles d'alerte basées sur un ratio de deux métriques. Actuellement, les ratios ne sont pas créés à l'aide de Monitoring dans Google Cloud Console. Pour plus d'informations, consultez MetricThreshold dans la documentation de référence sur AlertPolicy.

Canaux de notification

Un canal de notification est une ressource de configuration qui décrit la manière dont vous êtes averti lorsque des incidents se produisent. Les canaux de notification peuvent référencer différents types de services de communication et de points de terminaison. Ils sont spécifiées dans les descripteurs. Les descripteurs déterminent l'ensemble des paramètres de configuration inclus dans un objet de canal.

Pour plus d'informations, consultez la documentation de référence de NotificationChannel et la documentation de référence de NotificationChannelDescriptor.

Service Monitoring

Les ressources de surveillance des services permettent de définir des objectifs de niveau de service pouvant servir à surveiller l'état de vos services.

Service Monitoring ajoute les ressources suivantes à l'API Monitoring :

Pour en savoir plus sur ces concepts de surveillance des services et sur l'utilisation de l'API, consultez la page Surveillance SLO.

Tableaux de bord

Vous pouvez créer et manipuler de manière automatisée à la fois des tableaux de bord et des graphiques à l'aide du point de terminaison Dashboards. Pour plus d'informations sur l'utilisation de ce point de terminaison pour gérer les tableaux de bord et les graphiques, consultez la page Gérer les tableaux de bord à l'aide d'API.

Langage MQL

Le langage MQL (Monitoring Query Language) fournit une interface textuelle pour l'interrogation des données de séries temporelles Cloud Monitoring. Il utilise un modèle de requête redirigée et est plus expressif que les filtres Monitoring. Vous pouvez utiliser des requêtes MQL à partir de l'API Monitoring ou de l'éditeur de requête.

Pour obtenir des informations générales sur le langage MQL, consultez la page Utiliser le langage MQL.

Pour plus d'informations sur l'utilisation de MQL pour récupérer des données de séries temporelles à l'aide de l'API Monitoring, consultez la documentation de référence de l'API pour la méthode timeSeries.query.

Pour plus d'informations sur la création de tableaux de bord avec des graphiques basés sur MQL à l'aide de l'API Monitoring, consultez la documentation de référence de l'API pour l'objet TimeSeriesQuery. Cet objet fournit le mécanisme permettant de récupérer l'ensemble de données pour un graphique ou un tableau de données.

Concepts de l'API

Filtres

L'API Monitoring v3 utilise des filtres pour sélectionner des métriques, récupérer des données de séries temporelles et collecter des ressources surveillées en groupes. Pour en savoir plus, consultez la page Filtres de surveillance.

L'API Monitoring v3 utilise également des filtres pour restreindre l'ensemble de résultats de certaines opérations list. Pour en savoir plus sur la gestion des résultats des méthodes alertPolicies.list et notificationChannels.list, consultez la page Tri et filtrage.

Étapes suivantes