Métriques basées sur les journaux de portée bucket

Ce document résume les caractéristiques des métriques basées sur les journaux à portée de bucket et décrit en quoi elles diffèrent des métriques basées sur les journaux à portée de projet.

Caractéristiques des métriques basées sur les journaux de portée bucket

Les métriques basées sur les journaux de portée bucket sont des métriques basées sur les journaux définies par l'utilisateur qui évaluent les entrées de journal acheminées vers un bucket de journaux spécifique. Avec les métriques basées sur les journaux à l'échelle du bucket, vous pouvez créer des métriques basées sur les journaux qui extraient des données des journaux dans les cas suivants:

  • Journaux acheminés d'un projet vers un bucket dans un autre projet
  • Journaux acheminés vers un bucket via un récepteur agrégé

Comme les métriques basées sur les journaux au niveau du projet, les métriques basées sur les journaux au niveau du bucket sont définies dans un projet Google Cloud, et non au niveau du dossier ou de l'organisation. Si vous souhaitez suivre le dossier ou l'organisation à partir duquel une entrée de journal a été acheminée vers le bucket, vous pouvez définir des libellés dans la métrique basée sur les journaux pour enregistrer ces informations.

Les métriques basées sur les journaux de portée bucket présentent plusieurs différences par rapport aux métriques basées sur les journaux de portée projet.

Champs d'application des projets et des métriques

Les métriques basées sur les journaux à l'échelle du bucket sont définies dans le même projet que le bucket source. Par défaut, seul le projet qui définit une métrique basée sur les journaux à l'échelle du bucket peut voir les données de métrique pour le bucket de journaux. Toutefois, si votre projet apparaît dans le champ d'application des métriques d'autres projets, ces projets peuvent également voir vos métriques.

Les projets Google Cloud qui acheminent les journaux vers le bucket ne doivent pas faire partie du champ d'application des métriques d'un projet.

Pour en savoir plus sur les métriques basées sur les journaux et les champs d'application des métriques, consultez la section Visibilité des champs d'application des métriques.

Lorsque les journaux sont reçus dans le bucket, les données de métriques de journal acheminées sont visibles par tous les projets qui incluent le projet du bucket dans leur champ d'application des métriques. Si les journaux d'acheminement d'un projet ne sont pas inclus dans le champ d'application des métriques d'un projet, les autres informations du projet d'acheminement ne sont pas visibles.

Lorsque vous utilisez des métriques basées sur les journaux à l'échelle du bucket, les affirmations suivantes s'appliquent:

  • Vous définissez la métrique basée sur les journaux dans le projet avec le bucket de destination.
  • Vos métriques basées sur les journaux à l'échelle du bucket évaluent toutes les entrées de journal acheminées vers le bucket, que le journal provienne du même projet que le bucket ou d'un autre projet.
  • Les données de métrique sont visibles par tous les autres projets qui incluent le projet avec le bucket dans son champ d'application des métriques.
  • Les journaux de routage des projets ne doivent pas nécessairement faire partie du champ d'application des métriques d'un projet.

Type de ressource surveillée: logging_bucket

Les métriques basées sur les journaux de portée bucket utilisent le type de ressource surveillée logging_bucket lors de l'écriture de données de séries temporelles dans Cloud Monitoring. Le type de ressource logging_bucket inclut les libellés suivants:

  • project_id: identifiant de votre projet Google Cloud, une chaîne comme my-test-project.
  • bucket_id: nom du bucket de journaux associé à la métrique basée sur les journaux, une chaîne comme my-test-bucket.
  • location: emplacement du bucket de journaux.
  • monitored_resource_type: type de la ressource surveillée qui a généré cette entrée de journal. La valeur provient du champ type de la structure MonitoredResource contenue dans le champ resource de l'entrée de journal.
  • source_resource_container: identifiant du projet, du dossier ou de l'organisation à partir duquel l'entrée de journal a été envoyée, une chaîne sous l'un des formats suivants :
    • projects/PROJECT_ID
    • organizations/ORGANIZATION_ID
    • folders/FOLDER_ID