Métricas com base em registros no escopo do bucket

Este documento resume as características das métricas com base em registros com escopo de 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 registro com escopo de bucket são definidas pelo usuário e avaliam 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 desse tipo que extraem dados de registros nos seguintes 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 registro no escopo do projeto, as com base no escopo do bucket são definidas em um projeto do Google Cloud, não no nível da pasta ou 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 registros para registrar essa informação.

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

Escopos de projetos e métricas

As métricas com base em registros com escopo de 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 com escopo de bucket pode ver os dados da métrica para o bucket de registros. No entanto, se o seu projeto aparece no escopo de métricas de outros projetos, eles também podem ver as métricas.

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

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

Quando os registros são recebidos no bucket, os dados de métricas de registro roteados derivados ficam visíveis para qualquer projeto que inclua o projeto do bucket no respectivo escopo de métricas. Se um registro de roteamento de projeto não estiver 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 instruçõ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 registros com escopo de bucket avaliam todas as entradas de registro roteadas para o bucket, quer o registro seja do mesmo projeto do 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 com base 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 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 do 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 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