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 encaminhadas 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 Google Cloud , não no nível da pasta ou da organização. Se você quiser rastrear a pasta ou a organização de onde uma entrada de registro foi roteada para o bucket, defina rótulos na métrica com base em registro para gravar 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, somente o projeto que define uma métrica com base em registros no escopo do bucket pode ver os dados de métricas do bucket de registros. No entanto, se o projeto aparecer no escopo de métricas de outros projetos, eles também poderão ver suas métricas.

Os projetos 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 dos escopos de métricas.

Quando os registros são recebidos no bucket, os dados de métricas de registro encaminhados derivados ficam visíveis para qualquer projeto que inclua o projeto do bucket no escopo de métricas. Se um projeto que roteia registros não estiver no escopo de métricas de nenhum projeto, outras informações no projeto de roteamento não ficarão visíveis.

Ao usar métricas com base em registros com escopo de bucket, as seguintes declarações são válidas:

  • Você define a métrica com base em registros no projeto com o bucket de destino.
  • As métricas com base em registros com escopo de bucket avaliam todas as entradas de registro roteadas para o bucket, seja o registro do mesmo projeto do bucket ou de um projeto diferente.
  • Os dados de métricas ficam visíveis para qualquer outro projeto que inclua o projeto com o bucket no escopo de métricas.
  • Os registros de rotas 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 logging_bucket (tipo de recurso) inclui os seguintes rótulos:

  • project_id: o identificador do projeto 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 esta 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