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.
- Para informa��es gerais sobre m�tricas com base em registros, consulte Vis�o geral de m�tricas com base em registros.
- Para informa��es sobre roteamento e coletores, consulte Vis�o geral de roteamento e armazenamento.
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 comomy-test-project
.bucket_id
: o nome do bucket de registros associado � m�trica com base em registros, uma string comomy-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 campotype
da estruturaMonitoredResource
contida no camporesource
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