Utiliser des métriques personnalisées

Ce guide explique comment créer et utiliser des métriques personnalisées. Les informations sont réparties dans les sections suivantes :

  • La page Métriques personnalisées avec OpenCensus décrit comment utiliser OpenCensus, une bibliothèque de surveillance et de traçage Open Source, pour créer des métriques personnalisées, y ajouter des données de métriques et les exporter vers Cloud Monitoring.

    Lorsque les métriques d'OpenCensus sont exportées vers Cloud Monitoring, elles sont traitées comme toute autre métrique personnalisée.

  • La page Créer des métriques personnalisées indique comment utiliser l'API Cloud Monitoring pour créer des métriques personnalisées et y ajouter des données de séries temporelles.

    L'API Monitoring est illustrée avec des exemples utilisant les langages de programmation API Explorer, C#, Go, Java, Node.js, PHP, Python et Ruby.

Les informations suivantes concernent les métriques personnalisées et celles fournies par Cloud Monitoring :

  • La section Parcourir les métriques explique comment répertorier et examiner les métriques personnalisées ainsi que les quelque 900 métriques intégrées.
  • La section Lire des métriques explique comment récupérer des données de séries temporelles à partir de métriques personnalisées et intégrées à l'aide de l'API Monitoring. Vous pouvez également utiliser les données de métriques dans les graphiques et les alertes.

L'API Cloud Monitoring v3 est nécessaire pour réaliser toutes ces opérations sur les métriques. Pour consulter la documentation de référence, reportez-vous à la page Présentation de l'API Cloud Monitoring.

Pour en savoir plus sur les concepts sur lesquels reposent les métriques dans Cloud Monitoring, consultez la page Métriques, séries temporelles et ressources.

Avant de commencer

Les statistiques personnalisées appartiennent à des projets Google Cloud membres d'un espace de travail. Même si vous ne parcourez que les métriques intégrées, vous devez créer un projet à partir duquel travailler :

  1. Créez ou sélectionnez un projet Google Cloud Console dont vous souhaitez accéder aux données de surveillance. Dans ce guide, l'ID de votre projet est appelé {your-project-id}.
  2. Activez le projet pour Monitoring.

Si vous souhaitez configurer des métriques basées sur les journaux dans vos projets Google Cloud, utilisez des métriques basées sur les journaux.

À propos des métriques personnalisées

Les métriques personnalisées sont identiques aux métriques intégrées de Monitoring, avec les exceptions suivantes :

  • Vous pouvez créer des métriques personnalisées dans vos projets Google Cloud.
  • Les noms des métriques personnalisées commencent généralement par custom.googleapis.com/, à la différence des métriques intégrées.
  • Vous pouvez écrire des données de séries temporelles dans les métriques personnalisées.
  • Vous pouvez supprimer des métriques personnalisées.

Consultez la liste de métriques pour obtenir davantage de détails sur les métriques intégrées.

Le tableau suivant répertorie les méthodes de l'API Monitoring pouvant être utilisées avec les métriques personnalisées et avec les métriques intégrées :

Méthode API Monitoring Utilisation avec des
métriques personnalisées
Utilisation avec des
métriques intégrées
monitoredResourceDescriptors.get oui oui
monitoredResourceDescriptors.list oui oui
metricDescriptors.get oui oui
metricDescriptors.list oui oui
timeSeries.list oui oui
timeSeries.create oui
metricDescriptors.create oui
metricDescriptors.delete oui

Limites et latences

Consultez la page Quotas et limites pour consulter les limites associées métriques et à la conservation des données. Si vous souhaitez conserver les données des métriques au-delà de la durée de conservation, vous devez les copier manuellement vers un autre emplacement, tel que Cloud Storage ou BigQuery.

Pour en savoir plus sur les latences associées à l'écriture de données dans les métriques personnalisées, consultez la section Latence des données de métriques.