Esta página oferece uma vista geral conceptual das métricas baseadas em registos. Estas métricas podem ajudar a observar tendências e padrões num grande volume de entradas de registo.
Acerca das métricas baseadas em registos
As métricas baseadas em registos são métricas do Cloud Monitoring derivadas do conteúdo das entradas de registo. Por exemplo, pode usar uma métrica baseada em registos para contar o número de entradas de registo que contêm uma determinada mensagem ou para extrair informações de latência registadas nas entradas de registo. Pode apresentar métricas baseadas em registos em gráficos do Cloud Monitoring, e as políticas de alerta podem monitorizar estas métricas.
As métricas baseadas em registos podem aplicar-se ao nível do projeto ou do contentor de registos. As métricas baseadas em registos ao nível do contentor são úteis quando usa destinos agregados para encaminhar entradas de registo para um contentor de registos e quando encaminha entradas de registo de um projeto para um contentor de registos noutro projeto. Para mais informações, consulte a secção desta página intitulada Fontes de métricas baseadas em registos.
Como são determinados os valores de séries cronológicas para métricas baseadas em registos
Esta secção descreve brevemente como são determinados os valores numa série cronológica para uma métrica baseada em registos do tipo contador. Também descreve o motivo pelo qual uma série cronológica de uma métrica baseada em registos pode ter lacunas. O processo é semelhante para métricas baseadas em registos com valor de distribuição.
Para métricas baseadas em registos do tipo contador, o registo faz o seguinte:
Cria uma ou mais streams de dados e, para cada stream, gere um conjunto de contadores na memória.
Existe uma stream para cada combinação de valores únicos para o conjunto de etiquetas de métricas e recursos. Cada contador na memória destina-se a um intervalo de tempo diferente, mas cada contador regista o número de entradas de registo que correspondem ao filtro e que têm uma data/hora correspondente ao intervalo.
A cada minuto, para cada stream, o back-end do Logging usa os valores dos contadores na memória para determinar como atualizar uma série cronológica gerida pelo Cloud Monitoring.
Se existirem cinco streams, existem cinco séries cronológicas geridas pelo Monitoring. Pode criar gráficos destes intervalos temporais. Também pode criar políticas de alerta para monitorizar estas séries cronológicas.
Exemplo: como os valores zero podem causar lacunas nos dados
Considere a seguinte série cronológica:
Example time series: (T1, -), (T2, -), (T3, 0), (T4, 1), (T5, 0), (T6, -)
Na expressão anterior, (T1, -)
significa que não foi escrito nenhum valor para a hora T1
. Isto corresponde a uma lacuna nos valores na série cronológica.
Por outro lado, (T3, 0)
significa que o valor da série cronológica no momento T3
é zero.
Para cada fluxo, o sistema de back-end para métricas baseadas em registos usa as seguintes regras para determinar que valor escrever na série cronológica armazenada pelo Monitoring:
Quando a contagem agregada para um intervalo é diferente de zero, esse valor é escrito na série cronológica.
Na série cronológica de exemplo, apenas o intervalo
T4
tem um valor diferente de zero. O valor de1
indica que uma entrada de registo com uma data/hora que corresponde ao intervaloT4
correspondeu ao filtro da métrica baseada em registos.Quando a contagem agregada de um intervalo é zero, é escrito um valor de zero na série cronológica quando um intervalo adjacente tem um valor diferente de zero.
Na série cronológica de exemplo, no momento
T3
, a contagem agregada é zero. No entanto, é escrito um valor zero porque, no momentoT4
, a contagem agregada não é zero. Da mesma forma, no momentoT5
, a contagem agregada é zero. É escrito um valor de zero na série cronológica porque o valor do intervalo anterior era diferente de zero.Caso contrário, a série cronológica não é atualizada e existe uma lacuna de dados para o intervalo.
Na série cronológica de exemplo, não existe nenhum valor para os intervalos
T1
,T2
eT6
. Nestes intervalos, as contagens agregadas foram zero e as contagens dos intervalos adjacentes também foram zero.
Processamento de entradas do registo futuras e com atraso
Quando as entradas de registo chegam com uma data/hora para um intervalo que foi processado, o back-end de registo gera dados do histórico. Os dados do histórico são usados para atualizar as contagens escritas anteriormente.
Quando as entradas de registo chegam com uma data/hora futura, o back-end de registo acumula estas contagens. Na série cronológica, estas entradas de registo são contabilizadas quando a respetiva indicação de tempo corresponde ao intervalo atual.
Origens de métricas baseadas em registos
Pode usar as métricas definidas pelo Cloud Logging para recolher informações de utilização geral e definir a sua própria métrica baseada em registos para capturar informações específicas da sua aplicação ou empresa.
As métricas baseadas em registos podem ser aplicadas num único Google Cloud projeto ou num contentor de registos. Não pode criar métricas baseadas em registos para outros Google Cloud recursos, como contas ou organizações do Cloud Billing.
Para obter informações sobre as diferenças entre as métricas baseadas em registos ao nível do projeto e as métricas baseadas em registos ao nível do contentor, consulte o artigo Métricas baseadas em registos ao nível do contentor.
Métricas definidas pelo sistema
O registo fornece um conjunto de métricas para valores de utilização, como o número de entradas de registo armazenadas em contentores de registos no seu projeto ou o número de bytes que exportou. Para ver uma lista completa das métricas definidas pelo sistema, consulte as Google Cloud métricas: registo.
As métricas baseadas em registos definidas pelo sistema aplicam-se ao nível do projeto.
O Log Router contabiliza uma entrada de registo quando todas as seguintes condições são verdadeiras:
- A entrada de registo passa pelos sinks de registo do projeto onde a métrica baseada em registos está definida.
A entrada de registo é armazenada num contentor de registos. O contentor de registos pode estar em qualquer projeto.
Por exemplo, suponhamos que o projeto
A
tem um destino de registo cujo destino é o projetoB
. Suponha também que os destinos de registo no projetoB
encaminham as entradas de registo para um contentor de registo. Neste cenário, as entradas de registo encaminhadas do projetoA
para o projetoB
contribuem para as métricas baseadas em registos definidas pelo sistema do projetoA
. Estas entradas de registo também contribuem para as métricas baseadas em registos definidas pelo sistema do projetoB
.
Métricas definidas pelo utilizador
Pode criar métricas baseadas em registos definidas pelo utilizador para monitorizar outras métricas importantes para o seu projeto. Por exemplo, pode criar uma métrica baseada em registos para contabilizar o número de entradas de registo que correspondem a um determinado filtro.
Por predefinição, as métricas baseadas em registos definidas pelo utilizador são calculadas a partir de todos os registos recebidos pela API Logging para o Google Cloud projeto, independentemente de quaisquer filtros de inclusão ou filtros de exclusão que possam aplicar-se aoGoogle Cloud projeto.
Também pode criar métricas baseadas em registos definidas pelo utilizador para um contentor de registos específico num Google Cloud projeto. As métricas baseadas em registos com âmbito de contentor são calculadas a partir de todos os registos destinados ao contentor, independentemente da respetiva origem. Para mais informações, consulte o artigo Métricas baseadas em registos em contentores de registos.
O Log Router contabiliza uma entrada de registo quando todas as seguintes condições são verdadeiras:
- A faturação está ativada no projeto onde a métrica baseada em registos está definida.
- Para métricas ao nível do contentor, a entrada de registo é armazenada no contentor de registos onde a métrica baseada em registos está definida.
- Para métricas ao nível do projeto, a entrada de registo passa pelos sinks de registo do projeto onde a métrica baseada em registos está definida.
Tipos de dados para métricas baseadas em registos
As métricas baseadas em registos podem extrair dados de registos para criar métricas dos seguintes tipos:
- Contador: estas métricas contabilizam o número de entradas de registo que correspondem a um filtro especificado num período específico. Use contadores quando quiser acompanhar o número de vezes que um valor ou uma string aparece nos seus registos.
- Distribuição: estas métricas também contabilizam valores, mas recolhem as contagens em intervalos de valores (grupos de histogramas). Use distribuições quando quiser extrair valores como latências.
- Booleano: estas métricas captam se uma entrada do registo corresponde ou não a um filtro especificado.
As métricas baseadas em registos definidas pelo utilizador podem ser do tipo de métrica de contador ou de distribuição. A maioria das métricas baseadas em registos definidas pelo sistema são contadores, mas algumas são do tipo booleano. As características dos contadores e das distribuições são descritas mais detalhadamente nas secções subsequentes.
Os dados de uma métrica baseada em registos definida pelo utilizador provêm apenas de entradas de registo recebidas após a criação da métrica. Uma métrica não é preenchida retroativamente com dados de entradas de registo que já estão no registo.
As métricas baseadas em registos do sistema são calculadas apenas a partir dos registos incluídos. As métricas baseadas em registos definidas pelo utilizador são calculadas a partir de registos incluídos e excluídos.
As secções seguintes descrevem as caraterísticas das métricas do tipo contador e do tipo distribuição.
Métricas de contador
As métricas de contador contabilizam o número de entradas de registo que correspondem a um determinado filtro. Por exemplo, pode fazer o seguinte:
- Contar as entradas de registo que contêm uma determinada mensagem de erro específica.
Conte o número de vezes que cada utilizador invoca uma operação, procurando mensagens de registo que correspondam a este padrão:
... user USERNAME called OPERATION ...
Ao extrair USERNAME e OPERATION e usá-los como valores para duas etiquetas, pode perguntar mais tarde: "Quantas vezes
sally
chamou a operaçãoupdate
?" "Quantas pessoas ligaram para aread
operação?", "Quantas vezesgeorge
chamou uma operação?" e assim sucessivamente.
Para mais informações, consulte o artigo Configure métricas de contador.
Métricas de distribuição
As métricas de distribuição acumulam dados numéricos de entradas de registo que correspondem a um filtro. As métricas contêm uma série cronológica de objetos de distribuição, cada um dos quais contém o seguinte:
- Uma contagem do número de valores na distribuição.
- A média dos valores.
- A soma dos desvios ao quadrado: Somai=1..n(xi–média)2
- Um conjunto de contentores de histogramas com a contagem de valores em cada contentor. Pode usar o esquema de contentores predefinido ou escolher o seu próprio esquema.
Uma utilização comum das métricas de distribuição é acompanhar as latências. À medida que cada entrada de registo é recebida, é extraído um valor de latência de algum lugar na entrada de registo e é adicionado à distribuição. A intervalos regulares, a distribuição acumulada é escrita no Cloud Monitoring.
Para obter informações sobre as distribuições, incluindo o respetivo formato num intervalo temporal e a forma como são visualizadas, consulte o artigo Representar graficamente métricas de distribuição.
Para obter informações sobre como criar métricas baseadas em registos de distribuição, consulte o artigo Configure métricas de distribuição.
Tipos de recursos
Recomendamos que as suas métricas baseadas em registos especifiquem um único tipo de recurso. Esta especificação garante que a série cronológica gerada para a sua métrica baseada em registos corresponde ao modelo de dados esperado pelo Cloud Monitoring. Também simplifica o processo de criação de gráficos e políticas de alerta, uma vez que não existe ambiguidade quanto aos dados de séries cronológicas representados em gráficos ou monitorizados.
Considere uma métrica baseada em registos com o seguinte filtro:
severity>="ERROR"
resource.type="gce_instance"
O Cloud Monitoring reconhece que estes dados são para uma instância de VM do Compute Engine. Por conseguinte, quando cria um gráfico para uma instância de VM, a métrica baseada em registos é apresentada como uma opção nos menus. Quando cria um gráfico para um tipo de recurso diferente, a sua métrica baseada em registos não é apresentada como uma opção.
Se criar uma métrica baseada em registos sem especificar um tipo de recurso, o Monitoring apresenta a métrica baseada em registos como uma opção para vários tipos de recursos, mesmo que não conte entradas desses recursos.
Etiquetas
As métricas baseadas em registos podem ter etiquetas, o que permite recolher várias séries cronológicas para a métrica. Os valores das etiquetas são extraídos dos campos nas entradas de registo correspondentes. O registo regista séries temporais separadas para cada combinação de valores de etiquetas.
A maioria das métricas baseadas em registos fornece uma etiqueta log
predefinida.
Esta etiqueta contém o valor da parte LOG_ID do campo logName
na entrada do registo, por exemplo, cloudresourcemanager.googleapis.com%2Factivity
.
As métricas baseadas em registos do sistema têm etiquetas predefinidas que não podem ser alteradas.
As métricas baseadas em registos definidas pelo utilizador podem incluir etiquetas que define. Normalmente, estas etiquetas extraem valores das entradas de registo que contribuem para a métrica baseada em registos.
Por exemplo, pode usar etiquetas na métrica baseada em registos para registar a pasta ou a organização de onde se originou uma entrada de registo, embora não seja possível criar métricas baseadas em registos com âmbito de contentor para pastas ou organizações. Para mais informações, consulte o artigo Etiquetas de métricas baseadas em registos.
Gráficos e políticas de alerta no Cloud Monitoring
Pode usar métricas baseadas em registos definidas pelo sistema e pelo utilizador no Cloud Monitoring para criar gráficos e políticas de alerta. Para estes gráficos e políticas de alerta, pode usar etiquetas para filtrar ou combinar séries cronológicas. Por exemplo, pode definir um filtro para mostrar apenas determinadas séries cronológicas. Para mais informações, consulte os artigos Liste e represente graficamente métricas baseadas em registos e Alerta sobre métricas baseadas em registos.
No Cloud Monitoring, as métricas baseadas em registos usam os seguintes padrões de nomenclatura:
- Sistema:
logging.googleapis.com/SYSTEM_METRIC_NAME
- Definido pelo utilizador:
logging.googleapis.com/user/USER_METRIC_NAME
Tenha em atenção que as métricas baseadas em registos definidas pelo utilizador incluem a string user
.
Visibilidade dos âmbitos das métricas de monitorização
As métricas baseadas em registos são carregadas pelo Cloud Monitoring, e a visibilidade dos dados de métricas para um Google Cloud projeto é determinada por um âmbito de métricas. Um âmbito de métricas é uma lista de projetos monitorizados pelo projeto que aloja o âmbito de métricas. O projeto de alojamento é denominado projeto de âmbito.
Por predefinição, cada projeto aloja um âmbito de métricas que inclui apenas o próprio projeto, pelo que um projeto é um projeto de âmbito para si próprio. Por conseguinte, as suas métricas, incluindo as métricas baseadas em registos, só são visíveis para o seu Google Cloud projeto.
Também pode criar um âmbito de métricas de vários projetos para o projeto de âmbito. Com um âmbito de métricas de vários projetos, o projeto de âmbito pode ver as métricas de todos os projetos no âmbito de métricas. O que é visível para os projetos individuais num âmbito de métricas de vários projetos é determinado pelo âmbito de métricas alojado por cada um desses projetos. O facto de dois projetos estarem num âmbito de métricas de vários projetos não significa que cada projeto tenha acesso aos dados de métricas ou de configuração no outro projeto.
Um único projeto também pode aparecer em vários âmbitos de métricas. As métricas de um projeto deste tipo são visíveis para os projetos de âmbito de cada um desses âmbitos de métricas.
As métricas, incluindo as métricas baseadas em registos, são definidas num projeto específico. Quando esse projeto aparece em vários âmbitos de métricas, as métricas são visíveis para projetos que não aquele em que estão definidas. Para obter informações sobre como os âmbitos das métricas e as métricas baseadas em registos com âmbito de bucket interagem, consulte o artigo Projetos e âmbitos das métricas.
Para mais informações sobre os âmbitos das métricas, incluindo os âmbitos das métricas de vários projetos, e sobre a definição do âmbito dos projetos, consulte o seguinte:
Limitações
Não pode criar métricas baseadas em registos que contabilizem o número de entradas de registo que contêm um grupo de erros. Também não pode extrair o ID de um grupo de erros para uma etiqueta anexada a uma métrica baseada em registos.
Preços
Todas as métricas baseadas em registos definidas pelo utilizador são uma classe de métricas personalizadas do Cloud Monitoring e são cobradas. Para ver informações sobre preços, consulte a secção Preços das métricas baseadas em registos.
Quota
Para obter informações sobre as quotas e os limites associados às métricas baseadas em registos definidas pelo utilizador, consulte o artigo Quotas e limites.
Resolução de problemas
Se tiver problemas ao usar métricas baseadas em registos, consulte o artigo Resolva problemas de métricas baseadas em registos.