Métricas basadas en registros centradas en el bucket

En este documento, se resumen las características de las métricas basadas en registros centradas en el bucket y se describe en qué se diferencian de las métricas basadas en registros centradas en el proyecto.

Características de las métricas basadas en registros centradas en el bucket

Las métricas basadas en registros centradas en el bucket son métricas basadas en registros definidas por el usuario que evalúan las entradas de registro enrutada a un bucket de registros específico. Con las métricas basadas en registros de permisos de bucket, puedes crear métricas basadas en registros que extraen datos de los registros en los siguientes casos:

  • Los registros que se enrutan de un proyecto a un bucket de otro proyecto.
  • Los registros que se enrutan a un bucket a través de un receptor agregado.

Al igual que las métricas basadas en registros centradas en el proyecto, las métricas basadas en registros centradas en el bucket se definen dentro de un proyecto de Google Cloud, no a nivel de la carpeta o la organización. Si deseas hacer un seguimiento de la carpeta o la organización desde la que se enrutó una entrada de registro al bucket, puedes definir etiquetas en la métrica basada en registros para registrar esa información.

Las métricas basadas en registros centradas en el bucket tienen varias diferencias con las métricas basadas en registros centradas en el proyecto.

Alcance de las métricas y los proyectos

Las métricas basadas en registros con alcance de bucket se definen en el mismo proyecto que contiene el bucket de origen. De forma predeterminada, solo el proyecto que define una métrica basada en registros con alcance de bucket puede ver los datos de métricas del bucket de registros. Sin embargo, si tu proyecto aparece en el permiso de las métricas de otros proyectos, esos proyectos también pueden ver tus métricas.

Los proyectos de Google Cloud que enrutan los registros al bucket no tienen que estar en el permiso de métricas de ningún proyecto.

Para obtener más información sobre las métricas basadas en registros y los permisos de métricas, consulta Visibilidad de los permisos de métricas.

Cuando se reciben los registros en el bucket, los datos de métricas de registro enrutados derivados son visibles para cualquier proyecto que incluya el proyecto del bucket en su permiso de métricas. Si los registros de enrutamiento de un proyecto no están en el alcance de las métricas de ningún proyecto, entonces no se mostrará otra información del proyecto de enrutamiento.

Cuando usas métricas basadas en registros de permisos de bucket, se aplican las siguientes afirmaciones:

  • Define la métrica basada en registros en el proyecto con el bucket de destino.
  • Tus métricas basadas en registros centradas en el bucket evalúan todas las entradas de registro enrutadas al bucket, independientemente de si el registro proviene del mismo proyecto que el bucket o de un proyecto diferente.
  • Los datos de las métricas son visibles para cualquier otro proyecto que incluya el proyecto con el bucket en su permiso de métricas.
  • Los registros de enrutamiento de los proyectos no tienen que estar en el alcance de las métricas de ningún proyecto.

Tipo de recurso supervisado: logging_bucket

Las métricas basadas en registros centradas en el bucket usan el tipo de recurso supervisado logging_bucket cuando escriben datos de series temporales en Cloud Monitoring. El tipo de recurso logging_bucket incluye las siguientes etiquetas:

  • project_id: Es el identificador de tu proyecto de Google Cloud, una cadena como my-test-project.
  • bucket_id: Es el nombre del bucket de registros asociado con la métrica basada en registros, una cadena como my-test-bucket.
  • location: Es la ubicación del bucket de registros.
  • monitored_resource_type: Es el tipo de recurso supervisado que produjo esta entrada de registro. El valor proviene del campo type de la estructura MonitoredResource contenida en el campo resource de la entrada de registro.
  • source_resource_container: Es el identificador del proyecto, la carpeta o la organización desde la que se envió la entrada de registro, una cadena en uno de los siguientes formatos:
    • projects/PROJECT_ID
    • organizations/ORGANIZATION_ID
    • folders/FOLDER_ID