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 las 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 Google Cloud proyecto, 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 con alcance de bucket tienen varias diferencias con respecto a las métricas basadas en registros con alcance de 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 para el bucket de registros. Sin embargo, si tu proyecto aparece en el alcance de métricas de otros proyectos, esos proyectos también pueden ver tus métricas.

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

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

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

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

  • 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, independientemente de si el registro es del mismo proyecto que el bucket o de un proyecto diferente.
  • Los datos de métricas son visibles para cualquier otro proyecto que incluya el proyecto con el bucket en su alcance de métricas.
  • Los proyectos que enrutan registros no necesitan estar en el alcance 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 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 Google Cloud proyecto, 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 que se encuentra 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