Métriques basées sur les journaux à l'échelle du bucket

Ce document récapitule les caractéristiques des métriques basées sur les journaux à l'échelle du bucket et décrit en quoi elles diffèrent des métriques basées sur les journaux à l'échelle du projet.

Caractéristiques des métriques basées sur les journaux à l'échelle du bucket

Les métriques basées sur les journaux à l'échelle du bucket sont définies par l'utilisateur. Elles é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 à l'échelle du projet, les métriques basées sur les journaux à l'échelle 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 à l'échelle du bucket présentent plusieurs différences par rapport aux métriques basées sur les journaux à l'échelle du 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 celui contenant le bucket source. Par défaut, seul le projet qui définit une métrique basée sur les journaux à l'échelle d'un bucket peut voir les données de ce bucket de journaux. Toutefois, si votre projet apparaît dans le champ d'application des métriques d'autres projets, ceux-ci peuvent également voir vos métriques.

Les projets Google Cloud qui acheminent les journaux vers le bucket n'ont pas besoin de se trouver dans le champ d'application des métriques d'un projet.

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

Lorsque les journaux sont reçus au niveau du bucket, les données de métriques de journaux acheminées qui sont dérivées sont visibles par tout projet qui inclut le projet du bucket dans son champ d'application des métriques. Si les journaux de routage d'un projet ne figurent dans le champ d'application des métriques d'aucun projet, les autres informations du projet de routage ne sont pas visibles.

Lorsque vous utilisez des métriques basées sur les journaux à l'échelle du bucket, les instructions 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 celui-ci, que les journaux proviennent du même projet que celui-ci ou d'un autre projet.
  • Les données de métriques sont visibles par tout autre projet incluant le projet avec le bucket dans le champ d'application des métriques.
  • Il n'est pas nécessaire que les journaux de routage des projets ne se trouvent dans le champ d'application des métriques d'aucun projet.

Type de ressource surveillée: logging_bucket

Les métriques basées sur les journaux à l'échelle du 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 comprend les libellés suivants:

  • project_id: identifiant de votre projet Google Cloud, sous forme de chaîne telle que my-test-project.
  • bucket_id: nom du bucket de journaux associé à la métrique basée sur les journaux (chaîne telle que 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 (chaîne sous l'une des formes suivantes) :
    • projects/PROJECT_ID
    • organizations/ORGANIZATION_ID
    • folders/FOLDER_ID