Métricas com base em registros no escopo do bucket

Este documento resume as características das métricas com base em registros no escopo do bucket e descreve como elas diferem das métricas com base em registros no escopo do projeto.

Características das métricas com base em registros no escopo do bucket

As métricas com base em registros no escopo do bucket são definidas pelo usuário e avaliam as entradas de registro roteadas para um bucket de registros específico. Com as métricas com base em registro com escopo de bucket, é possível criar métricas que extraem dados de registros nestes casos:

  • Registros que são encaminhados de um projeto a um bucket em outro projeto.
  • Registros que são encaminhados a um bucket com um coletor agregado.

Assim como as métricas com base em registros no escopo do projeto, as métricas com base em registros no escopo do bucket são definidas em um projeto do Google Cloud, não no nível da pasta ou da organização. Se você quiser acompanhar a pasta ou a organização de onde uma entrada de registro foi roteada para o bucket, defina identificadores na métrica com base em registro para registrar essas informações.

As métricas com base em registros no escopo do bucket têm várias diferenças em relação às métricas com base em registros no escopo do projeto.

Projetos e escopos de métricas

As métricas com base em registros no escopo do bucket são definidas no mesmo projeto que contém o bucket de origem. Por padrão, apenas o projeto que define uma métrica com base em registros no escopo do bucket pode acessar os dados da métrica do bucket de registros. No entanto, se o projeto aparecer no escopo de métricas de outros projetos, esses projetos também poderão acessar suas métricas.

Os projetos do Google Cloud que encaminham registros para o bucket não precisam estar no escopo de métricas de nenhum projeto.

Para mais informações sobre métricas com base em registros e escopos de métricas, consulte Visibilidade para escopos de métricas.

Quando os registros são recebidos no bucket, os dados de métrica de registro roteado são gerados e ficam visíveis para qualquer projeto que inclua o projeto do bucket no escopo de métricas. Se os registros de roteamento de um projeto não estiverem no escopo de métricas de nenhum projeto, outras informações no projeto de roteamento não estarão visíveis.

Ao usar métricas com base em registros com escopo de bucket, as seguintes declarações se aplicam:

  • Você define a métrica com base em registros no projeto com o bucket de destino.
  • As métricas com base em registro no escopo do bucket avaliam todas as entradas de registro roteadas para o bucket, independentemente de o registro ser do mesmo projeto que o bucket ou de um projeto diferente.
  • Os dados da métrica ficam visíveis para qualquer outro projeto que inclua o projeto com o bucket no escopo de métricas.
  • Os registros de roteamento de projetos não precisam estar no escopo de métricas de nenhum projeto.

Tipo de recurso monitorado: logging_bucket

As métricas baseadas em registros no escopo do bucket usam o tipo de recurso monitorado logging_bucket ao gravar dados de série temporal no Cloud Monitoring. O tipo de recurso logging_bucket inclui os seguintes rótulos:

  • project_id: o identificador do seu projeto do Google Cloud, uma string como my-test-project.
  • bucket_id: o nome do bucket de registros associado à métrica com base em registros, uma string como my-test-bucket.
  • location: o local do bucket de registros.
  • monitored_resource_type: o tipo de recurso monitorado que produziu essa entrada de registro. O valor vem do campo type da estrutura MonitoredResource contida no campo resource da entrada de registro.
  • source_resource_container: o identificador do projeto, da pasta ou da organização de onde a entrada de registro foi enviada, uma string em um dos seguintes formatos:
    • projects/PROJECT_ID
    • organizations/ORGANIZATION_ID
    • folders/FOLDER_ID