Esta página traz uma visão geral do conceito de métricas com base em registros.
As métricas com base em registros podem ajudar a observar tendências e padrões em um grande volume de entradas de registro. Essas métricas são derivadas das entradas de registro que originam no seu projeto do Google Cloud ou que são roteadas para o projeto do Google Cloud por um coletor em outro projeto. Por exemplo, é possível usar uma métrica com base em registros contar o número de entradas de registro que contêm uma mensagem específica ou e extrair as informações de latência registradas nas entradas de registro. É possível mostrar métricas com base em registros nos gráficos do Cloud Monitoring, e as políticas de alertas podem monitorar essas métricas.
Se você planeja criar uma política de alertas para monitorar uma métrica com base em registros, entenda as limitações dessa abordagem. Confira Solução de problemas: faltam dados de registros na métrica.
Origens das métricas com base em registros
É possível usar as métricas definidas pelo Cloud Logging para coletar informações gerais de uso e definir sua própria métrica com base em registros para capturar informações específicas do seu aplicativo ou negócio.
As métricas com base em registros podem ser aplicadas a um único projeto do Google Cloud ou a um registro 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.
Para saber mais sobre as diferenças entre métricas com base em registros baseadas em projetos e métricas com base em registros baseadas em bucket, consulte Métricas com base em registros no escopo do bucket.
Métricas definidas pelo sistema
O registro fornece um conjunto de métricas para valores de uso, como o número de entradas de registro armazenadas em buckets de registro no seu projeto ou o número de bytes exportados. Para uma lista completa de métricas definidas pelo sistema, consulte Métricas do Google Cloud: geração de registros.
Métricas definidas pelo usuário
É possível criar métricas com base em registros definidas pelo usuário para acompanhar 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 com base em todos os registros recebidos pela API Logging no projeto do Google Cloud, independentemente dos filtros de inclusão ou filtros de exclusão que possam ser aplicados ao projeto do Google Cloud.
Também é possível criar métricas com base em registros definidas pelo usuário para um bucket de registro específico em um projeto do Google Cloud. As métricas com base em registros no escopo 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 registro.
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 do seguintes tipos:
- Contador: essas métricas contam o número de entradas de registro que correspondem a um filtro especificado em um período específico. Use os contadores quando quiser manter rastrear o número de vezes que um valor ou 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.
- Booleano: essas métricas capturam se uma entrada de registro corresponde ou não a um filtro.
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 é de contadores, mas algumas são do tipo booleano. As características dos contadores e das distribuições são descritas com mais detalhes nas seções a seguir.
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 é retroativa preenchida com dados de entradas 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. Definido pelo usuário as métricas com base em registros são calculadas a partir de 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 depois: "Quantas vezes
sallychamou a operaçãoupdate?", "Quantas pessoas chamaram a operaçãoread?", "Quantas vezesgeorgechamou 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 Métricas de distribuição de gráficos.
Para informações sobre como criar métricas de distribuição com base em registros, consulte Configurar métricas de distribuição.
Tipos de recurso
Recomendamos que suas métricas com base em registros especifiquem um único tipo de recurso. Essa especificação garante que os dados de série temporal gerados para sua métrica baseada em registros correspondam ao modelo de dados esperado pelo Cloud Monitoring. Ele também simplifica o processo de criação de gráficos e políticas de alertas, pois não há ambiguidade em relação a quais dados de série temporal são mapeados ou monitorados.
Considere uma métrica com base em registros com o seguinte filtro:
severity>="ERROR"
resource.type="gce_instance"
O Cloud Monitoring reconhece que esses dados são de uma instância de VM do Compute Engine. Portanto, quando você cria um gráfico para uma instância de VM, a métrica com base em registros é listada como uma opção nos menus. Quando você criar um gráfico para um tipo diferente de recurso, sua métrica com base em registros não estiver listada como uma opção.
Se você criar uma métrica com base em registros sem especificar um tipo de recurso, o monitoramento vai listar a métrica como uma opção para vários tipos de recurso, mesmo que você não conte as entradas desses recursos.
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.
Todas as métricas com base em registros fornecem um rótulo log padrão.
Esse rótulo contém o valor da parte LOG_ID do
campo logName na entrada de registro, por exemplo,
cloudresourcemanager.googleapis.com%2Factivity.
As métricas com base em registros do sistema têm configurações predefinidas rótulos que não podem ser alterados. No entanto, é possível personalizar rótulos para métricas definidas pelo usuário. Por exemplo, é possível usar rótulos na métrica com base em registros para registrar organização que originou uma entrada de registro, mesmo que com escopo de bucket não é possível criar métricas com base em registros para pastas ou organizações. Para mais Para mais informações, consulte Rótulos de métricas com base em registros.
Gráficos e políticas de 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 mais informações, consulte Métricas com base em registros em listas e gráficos e Alertar sobre métricas com base em registros.
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 escopos de métricas do Monitoring
As métricas com base em registros são ingeridas pelo Cloud Monitoring, e a visibilidade de dados de métricas para um projeto do Google Cloud é determinado por um escopo de métricas. Um escopo de métricas é uma lista de projetos monitorados pelo projeto que hospeda o escopo de métricas. Esse projeto é chamado de projeto de escopo.
Por padrão, cada projeto hospeda um escopo de métricas que inclui apenas ela mesma, ou seja, um projeto é um projeto de escopo para si mesmo. Portanto, suas métricas, incluindo as com base em registros, só ficam visíveis para seu projeto do Google Cloud.
Você também pode criar um escopo de métricas de vários projetos para o do projeto do escopo. Com um escopo de métricas de vários projetos, o projeto de escopo pode acessar as métricas de todos os projetos no escopo de métricas. O que fica visível para os projetos individuais 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 escopo de métricas de vários projetos não significa que cada projeto tenha acesso a os dados de métrica ou configuração no outro projeto.
Um único projeto também pode aparecer em vários escopos de métricas. As métricas desse projeto são visíveis os projetos de cada um desses escopos de métricas.
As métricas, incluindo as com base em registros, são definidas em um projeto específico. Quando esse projeto aparece em vários escopos de métricas, as métricas sejam visíveis para projetos diferentes daquele em que estão definido. Saiba mais sobre como os escopos de métricas e com base em registros no escopo do bucket que as métricas interagem, consulte Projetos e escopos de métricas.
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 faturáveis. Para informações sobre preços, consulte Preços do Cloud Logging: métricas com base em registros.
Cota
Para saber mais sobre as cotas e os limites associados aos papéis métricas baseadas em registros, 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.