Visão geral das métricas baseadas em registros

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Esta página traz uma visão geral do conceito de métricas com base em registros.

As métricas com base em registros derivam dados de métricas do conteúdo das entradas de registro. Por exemplo, é possível usar uma métrica com base em registros para contar o número de entradas de registro que contêm uma mensagem específica ou extrair informações de latência registradas em entradas de registro. É possível usar métricas com base em registros nos gráficos do Cloud Monitoring e nas políticas de alertas.

Origens de métricas com base em registros

Utilize as métricas definidas pelo Cloud Logging para coletar informações gerais de uso e defina sua própria métrica com base em registros para capturar informações específicas do aplicativo ou da empresa.

As métricas com base em registros se aplicam apenas a um único projeto do Google Cloud. Não é possível criar métricas com base em registros para outros recursos do Google Cloud, como contas ou organizações do Cloud Billing.

Métricas definidas pelo sistema

O Logging fornece um conjunto de métricas para valores de uso, como o número de entradas de registro ingeridas no projeto ou o número de bytes exportados. Para ver uma lista completa de métricas definidas pelo sistema, consulte Métricas do Google Cloud: geração de registros.

O Logging calcula métricas com base em registros definidas pelo sistema apenas a partir de registros que foram ingeridos pelo Logging. Se um registro foi explicitamente excluído da ingestão pelo Logging, ele não será incluído nessas métricas.

Métricas definidas pelo usuário

É possível criar métricas com base em registros definidas pelo usuário para rastrear outras métricas importantes para o projeto. Por exemplo, é possível criar uma métrica com base em registros para contar o número de entradas de registro que correspondem a determinado filtro.

Por padrão, as métricas com base em registros definidas pelo usuário são calculadas sobre todos os registros recebidos pela API Logging para o projeto do Cloud, independente de filtros de inclusão ou filtros de exclusão que possam ser aplicados ao projeto do Cloud.

Visualização: também é possível criar métricas com base em registros definidas pelo usuário para um bucket de registros específico em um projeto do Cloud. As métricas com base em registros no nível do bucket são calculadas a partir de todos os registros destinados ao bucket, independentemente da origem deles. Para mais informações, consulte Métricas com base em registros em buckets de registros.

Tipos de dados para métricas com base em registros

As métricas com base em registros podem extrair dados de registros para criar métricas dos seguintes tipos:

  • Contador: essas métricas contabilizam o número de entradas de registro que correspondem a um filtro especificado em um período específico. Use os contadores quando quiser acompanhar o número de vezes que um valor ou uma string aparece nos registros.
  • Distribuição: essas métricas também contam valores, mas coletam as contagens em intervalos de valores (buckets de histograma). Use distribuições quando quiser extrair valores como latências.
  • Booleana: essas métricas capturam se uma entrada de registro corresponde ou não a um filtro especificado.

As métricas com base em registros definidas pelo usuário podem ser do tipo de métrica de contagem ou de distribuição. A maioria das métricas com base em registros definidas pelo sistema são contadores, mas algumas são do tipo booleano. As características dos contadores e distribuições são descritas em mais detalhes nas seções subsequentes.

Os dados de uma métrica com base em registros definida pelo usuário vêm apenas de entradas de registro recebidas após a criação da métrica. Uma métrica não é preenchida retroativamente com dados de entradas de registro que já estão no Logging.

As métricas com base em registros do sistema são calculadas apenas com base nos registros incluídos. As métricas com base em registros definidas pelo usuário são calculadas a partir dos registros incluídos e excluídos.

O Logging acumula informações para uma métrica com base em registros sempre que recebe uma entrada de registro correspondente. A geração de registros grava um novo ponto de dados na série temporal da métrica com a taxa de 1 ponto de dados por minuto, disponibilizando os dados ao Cloud Monitoring.

Cada ponto de dados em uma série temporal da métrica com base em registros representa apenas as informações extras (o delta) recebidas desde o ponto de dados anterior.

Nas seções a seguir, descrevemos as características das métricas de contador e de distribuição.

Métricas de contador

As métricas de contagem contam o número de entradas de registro correspondentes a determinado filtro. Por exemplo, é possível realizar estas ações:

  • Contar as entradas de registro que contêm uma mensagem de erro específica.
  • Contar o número de vezes que cada usuário invoca uma operação, procurando mensagens de registro que correspondam a esse padrão:

    ... user USERNAME called OPERATION ...

    Ao extrair USERNAME e OPERATION e usá-los como valores para dois rótulos, é possível perguntar mais tarde: "quot;Quantas vezes sally chamou a operação update? quantas pessoas chamaram a operação read, "Quantas vezes george chamou uma operação?" e assim por diante.

Para mais informações, consulte Configurar métricas de contador.

Métricas de distribuição

As métricas de distribuição acumulam dados numéricos das entradas de registro correspondentes a um filtro. As métricas contêm uma série temporal de objetos de distribuição e cada um deles contém:

  • uma contagem do número de valores na distribuição;
  • a média dos valores;
  • a soma dos desvios quadrados: Somai=1..n(xi–média)2
  • um conjunto de buckets de histograma com a contagem de valores em cada bucket. É possível usar o layout padrão do bucket ou escolher um próprio.

Um uso comum para as métricas de distribuição é rastrear as latências. À medida que cada entrada de registro é recebida, um valor de latência é extraído de algum lugar na entrada de registro e é adicionado à distribuição. Em intervalos regulares, a distribuição acumulada é gravada no Cloud Monitoring.

Para informações sobre distribuições, incluindo o formato delas em uma série temporal e como elas são visualizadas, consulte Como criar gráficos de métricas de distribuição.

Para informações sobre como criar métricas com base em registros de distribuição, consulte Configurar métricas de distribuição.

Rótulos

As métricas com base em registros podem ter rótulos que permitem a coleta de várias séries temporais para a métrica. Os valores dos rótulos são extraídos dos campos nas entradas de registro correspondentes. O Logging grava séries temporais separadas para cada combinação de valores de rótulo.

As métricas com base em registros do sistema têm rótulos predefinidos. É possível definir os rótulos para métricas definidas pelo usuário. Para mais informações, consulte Rótulos de métricas com base em registros.

Gráficos e alertas no Cloud Monitoring

Use as métricas com base em registros definidas pelo usuário e pelo sistema no Cloud Monitoring para criar gráficos e políticas de alerta. Para mais informações, consulte Configurar gráficos e alertas.

No Cloud Monitoring, as métricas com base em registros usam os seguintes padrões de nomenclatura:

  • Sistema: logging.googleapis.com/SYSTEM_METRIC_NAME
  • Definido pelo usuário: logging.googleapis.com/user/USER_METRIC_NAME

As métricas com base em registros definidas pelo usuário incluem a string user.

Visibilidade para os escopos das métricas do Monitoring

As métricas com base em registros são ingeridas pelo Cloud Monitoring, e a visibilidade dos dados de métricas para um projeto do Cloud é determinada por um escopo de métricas. O escopo de métricas é uma lista de projetos monitorados pelo projeto que hospeda o escopo delas. O projeto host é chamado de projeto de escopo.

Por padrão, cada projeto hospeda um escopo de métricas que inclui somente ele mesmo, portanto, um projeto é de escopo limitado. Portanto, as métricas, incluindo as baseadas em registros, são visíveis somente para o projeto do Cloud.

Também é possível criar um escopo de métricas de vários projetos para o projeto de escopo. Com um escopo de métricas de vários projetos, o projeto de escopo pode ver as métricas de todos os projetos no escopo das métricas. O que é visível para cada projeto em um escopo de métricas de vários projetos é determinado pelo escopo de métricas hospedado por cada um desses projetos. O fato de dois projetos estarem em um escopo de métricas de vários projetos não significa que cada projeto tem acesso aos dados de métricas ou configurações do outro projeto.

Um único projeto também pode aparecer em vários escopos de métricas. As métricas de um projeto são visíveis para os projetos de escopo de cada um desses escopos.

As métricas, incluindo as baseadas em registros, são definidas em um projeto específico. Quando esse projeto aparece em vários escopos, as métricas são visíveis para projetos diferentes do que está definido.

Para mais informações sobre escopos de métricas, incluindo escopos de várias projetos, e sobre projetos de escopo, consulte:

Preços

Todas as métricas com base em registros definidas pelo usuário são uma classe de métricas personalizadas do Cloud Monitoring e são cobradas. Para informações sobre preços, consulte Preços do Cloud Logging: métricas com base em registros.

Cota

Para informações sobre as cotas e os limites associados às métricas com base em registros definidas pelo usuário, consulte Cotas e limites.

Solução de problemas

Se você encontrar problemas ao usar métricas com base em registros, consulte Solução de problemas de métricas com base em registros.