Métricas basadas en registros con alcance de bucket

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

Características de las métricas basadas en registros con alcance de bucket

Las métricas basadas en registros con alcance de bucket son métricas basadas en registros definidas por el usuario que evalúan entradas de registro enrutadas a un bucket de registros específico. Con las métricas basadas en registros con alcance de bucket, puedes crear métricas basadas en registros que extraigan 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 con alcance de proyecto, las métricas basadas en registros con alcance de bucket se definen dentro de un proyecto de Google Cloud, no a nivel de organización o carpeta. Si deseas realizar 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 con alcance de bucket tienen varias diferencias con respecto a las métricas basadas en registros con alcance de proyecto.

Permisos de proyectos y métricas

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 la métrica para el bucket de registros. Sin embargo, si tu proyecto aparece en el permiso de métricas de otros proyectos, estos también pueden ver tus métricas.

Los proyectos de Google Cloud que enrutan registros al bucket no necesitan estar dentro del permiso de métricas de ningún proyecto.

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

Cuando se reciben los registros en el bucket, los datos de las métricas de registro enrutadas derivadas 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 dentro del permiso de métricas de ningún proyecto, otra información en el proyecto de enrutamiento no es visible.

Cuando se usan métricas basadas en registros con alcance de bucket, se aplican las siguientes declaraciones:

  • Tú defines la métrica basada en registros en el proyecto con el bucket de destino.
  • Tus métricas basadas en registros, con alcance de bucket, evalúan todas las entradas de registro enrutadas al bucket, sin importar si el registro pertenece al mismo proyecto que el bucket o a un proyecto diferente.
  • Los datos de 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 proyectos no necesitan estar en el permiso de métricas de ningún proyecto.

Tipo de recurso supervisado: logging_bucket

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

  • project_id: El identificador del proyecto de Google Cloud, una string como my-test-project.
  • bucket_id: Es el nombre del bucket de registros asociado con la métrica basada en registros, una string como my-test-bucket.
  • location: 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 el que se envió la entrada de registro, una string en una de las siguientes formas:
    • projects/PROJECT_ID
    • organizations/ORGANIZATION_ID
    • folders/FOLDER_ID