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