En este documento, se resumen las características de las métricas basadas en registros con permiso de bucket y se describe en qué se diferencian de las métricas basadas en registros con permiso de proyecto.
Características de las métricas basadas en registros con alcance de bucket
Las métricas basadas en registros con alcance en el 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 de permisos 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 en el proyecto, las métricas basadas en registros con alcance en el 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.
- Para obtener información general sobre las métricas basadas en registros, consulta Descripción general de las métricas basadas en registros.
- Para obtener información sobre el enrutamiento y los receptores, consulta Descripción general del enrutamiento y el almacenamiento.
Las métricas basadas en registros con permiso a nivel del bucket tienen varias diferencias con respecto a las métricas basadas en registros con permiso a nivel del proyecto.
Permisos 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 la métrica para el bucket de registros. Sin embargo, si tu proyecto aparece en el permiso de las métricas de otros proyectos, estos también podrán ver tus métricas.
Los proyectos Google Cloud que enrutan registros al bucket no deben estar en el alcance de las 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 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 se encuentra en el alcance de las métricas de ningún proyecto, no se podrá ver otra información en el proyecto de enrutamiento.
Cuando se usan métricas basadas en registros con permisos 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 permisos de 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 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 alcance de las métricas de ningún proyecto.
Tipo de recurso supervisado: logging_bucket
Las métricas basadas en registros con alcance 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 comomy-test-project
.bucket_id
: Es el nombre del bucket de registros asociado con la métrica basada en registros, una cadena comomy-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 campotype
de la estructuraMonitoredResource
que se incluye en el camporesource
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 con uno de los siguientes formatos:projects/PROJECT_ID
organizations/ORGANIZATION_ID
folders/FOLDER_ID