Visão geral das métricas com base em registros

As métricas com base em registros são métricas do Stackdriver Monitoring que se baseiam no conteúdo das entradas de registro. Por exemplo, as métricas podem registrar o número de entradas que contêm mensagens específicas ou podem extrair informações de latência relatadas nas entradas. É possível usar métricas com base em registros nas tabelas do Stackdriver Monitoring e em políticas de alertas.

As métricas do sistema (com base em registros) são predefinidas pelo Stackdriver Logging. Essas métricas registram o número de eventos de geração de registro que ocorrem em um período de tempo específico.

Métricas definidas pelo usuário (com base em registros) são criadas por um usuário de um projeto. Elas contam o número de entradas de registro que correspondem a um determinado filtro ou rastreiam determinados valores nas entradas de registro correspondentes.

O Stackdriver Logging acumula informações de métricas com base em registros sempre que uma entrada de registro correspondente é recebida. Com uma programação regular, o Stackdriver Logging grava um novo ponto de dados na série temporal da métrica na taxa de um ponto de dados por minuto, disponibilizando os dados para o Stackdriver Monitoring.

Os dados de métricas com base em registros são provenientes de entradas recebidas após a criação das métricas. Elas não são preenchidas com dados de entradas que já estão no Stackdriver Logging.

Primeiros passos

  1. Acesse a página Stackdriver Logging > Métricas com base em registros no Console do GCP:

    Acessar a página Métricas com base em registros:

  2. Selecione um projeto atual do GCP na parte superior da página. A lista de métricas com base em registros aparece no seu projeto do GCP:

IU de métricas com base em registros

Interface de métricas com base em registros

A interface de métricas com base em registros é dividida em duas áreas do tipo de métrica: Métricas do sistema e Métricas definidas pelo usuário.

As duas áreas têm uma tabela com um resumo das métricas. Cada linha da tabela tem um menu flutuante no canto direito e apresenta as seguintes opções:

IU de métricas com base em registros

  • Ver no Metrics Explorer permite ver os dados de uma métrica com base em registros do sistema abrindo o Metrics Explorer do Stackdriver Monitoring.

    É possível usar o Metrics Explorer para especificar uma métrica de destino para uma política de alertas. Com o gráfico ao lado da região Destino, você tem um feedback visual sobre os dados capturados pela métrica de destino.

  • Com a opção Criar alerta a partir da métrica, é possível criar uma política de alertas com base na sua métrica baseada em registros. Observe que essa opção só está disponível se a métrica for uma métrica de contador.

    Quando essa opção é selecionada, é aberto o console do Stackdriver Monitoring para criar, editar e gerenciar políticas de alertas. Para mais detalhes, consulte Como criar uma política de alertas.

Interface de métricas definidas pelo usuário

A área Métricas definidas pelo usuário da interface de métricas com base em registros tem vários recursos extras para ajudar no gerenciamento das métricas definidas pelo usuário em um projeto:

  • A tabela de métricas definida pelo usuário inclui as colunas Nome, Descrição, Tipo e Filtro. Elas são especificadas quando a métrica é criada.

  • A caixa Filtrar métricas, acima da tabela de métricas definida pelo usuário. Com ela é possível filtrar a lista de métricas por pesquisa de texto ou por Nome, Descrição e Filtro da métrica:

IU de métricas com base em registros

  • A tabela de métricas definida pelo usuário inclui colunas de Uso no mês passado e Uso (mês atual). Essas métricas de uso são úteis, por exemplo, para ver quais métricas ingerem mais dados ou para estimar faturas.

  • É possível Editar métricas e Excluir métricas usando os menus flutuantes no final de uma linha da tabela.

Além disso, clicar em qualquer um dos nomes das colunas permite classificar os dados em ordem crescente ou decrescente. Na parte inferior da tabela, também é possível selecionar o número de linhas que você quer que sejam exibidas.

Para mais informações sobre como gerenciar suas métricas definidas pelo usuário usando o Console do GCP, consulte Como criar métricas de contador e Como criar métricas de distribuição.

Visão geral dos tipos de métrica com base em registros

Há dois tipos de métricas com base em registros do Stackdriver Logging: de contador ou distribuição. Todas as métricas com base em registros do sistema são de contador. As métricas com base em registros definidas pelo usuário podem ser de contador ou de distribuição.

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 contador contam o número de entradas de registro correspondentes a um filtro de registro avançado. Por exemplo, será possível fazer as seguintes tarefas:

  • Criar uma métrica que conta entradas de registro contendo uma mensagem de erro específica.
  • Contar o número de vezes que cada usuário invoca uma operação, procurando mensagens de registro como

    ... user [USERNAME] called  [OPERATION] ...
    

    Ao extrair [USERNAME] e [OPERATION] e usá-los como valores para dois rótulos, é possível perguntar mais tarde: "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 Como criar 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 ao quadrado: Sumi=1..n(xi–mean)2
  • um conjunto de intervalos de histograma com a contagem de valores em cada intervalo. É possível usar o layout padrão do intervalo 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 Stackdriver Monitoring.

Para mais informações, consulte Como criar métricas de distribuição.

Rótulos

As métricas com base em registros podem opcionalmente ter rótulos, o que permite que uma única métrica tenha várias séries temporais. Os valores dos rótulos são extraídos dos campos nas entradas de registro correspondentes. O Stackdriver Logging registra séries temporais separadas para cada valor diferente do rótulo.

As métricas com base em registros do sistema têm rótulos predefinidos. Você pode definir seus próprios rótulos para as métricas que você estabelecer. Para mais informações, consulte Rótulos para métricas com base em registros.

Métricas com base em registros do sistema

O Stackdriver Logging fornece algumas métricas de contagem predefinidas que acompanham o número e o volume de entradas de registro recebidas. As métricas têm rótulos que registram as contagens por nome do registro e nível de gravidade. A tabela a seguir lista as métricas:

Nome e descrição da métrica Tipo Valor Rótulos
logging.googleapis.com/log_entry_count

O número total de entradas de registro recebidas.

delta int64 log: o nome do registro. Exemplo: "appengine.googleapis.com/request_log".

severity: a gravidade das entradas de registro. Exemplo: "ERROR".

logging.googleapis.com/byte_count

O número total de bytes recebidos nas entradas de registro.

delta int64 log: o nome do registro. Exemplo: "appengine.googleapis.com/request_log".
logging.googleapis.com/excluded_log_entry_count

O número total de entradas de registro excluídas.

delta int64
logging.googleapis.com/excluded_byte_count

O número total de bytes nas entradas de registro que foram excluídas.

delta int64
logging.googleapis.com/exports/log_entry_count

O número total de entradas de registro exportadas com o uso de coletores.

delta int64
logging.googleapis.com/exports/byte_count

O número total de bytes nas entradas de log que foram exportadas usando coletores.

delta int64
logging.googleapis.com/exports/error_count

O número total de entradas de registro que não foram exportadas devido a erros na configuração de exportação.

delta int64
logging.googleapis.com/logs_based_metrics_error_count

O número de entradas de registro tardias.1

delta int64 log: o nome do registro. Exemplo: "appengine.googleapis.com/request_log".

1 As entradas de registro tardias não estão incluídas nas métricas log_entry_count ou byte_count.

Consulte Métricas de registro para ver uma lista completa das métricas baseadas em registros do sistema.

Stackdriver Monitoring

Você pode usar métricas com base em registros definidas pelo usuário e do sistema no Stackdriver Monitoring para criar gráficos e políticas de alertas. Os nomes de métricas baseadas em registros definidas pelo usuário são prefixados por user/. As métricas com base em registros do sistema não seguem essa regra.

Se você estiver usando a API Stackdriver Monitoring, os nomes das métricas com base em registros são exibidos abaixo:

logging.googleapis.com/user/[USER_METRIC_NAME]
logging.googleapis.com/[SYSTEM_METRIC_NAME]

Para mais informações, consulte Como criar gráficos e alertas.

Como solucionar problemas

Faltam dados de registros na métrica

Existem várias razões possíveis para a falta de dados nas métricas baseadas em registros:

  • Novas entradas de registro podem não corresponder ao filtro de registros da sua métrica. Uma métrica com base em registros aceita os dados das entradas de registro correspondentes recebidas após a criação da métrica. O Stackdriver Logging não preenche as métricas de entradas de registro anteriores.

  • As novas entradas de registro podem não conter o campo correto ou os dados podem não estar no formato correto para extração pela sua métrica de distribuição. Verifique se os nomes dos campos e as expressões regulares estão corretos.

  • As contagens de métricas podem estar atrasadas. Mesmo que você veja entradas de registro contáveis no Visualizador de registros, leva até um minuto para atualizar as métricas com base em registros no Stackdriver Monitoring.

  • As entradas de registro que você vê podem ser contadas com atraso ou podem não ser contadas, já que recebem o carimbo de data/hora muito cedo ou muito tarde. Se uma entrada de registro for recebida mais de 10 minutos no passado ou no futuro, a entrada de registro não será contada na métrica com base em registros.

    O número de entradas tardias é salvo para cada registro na métrica com base em registros do sistema, logging.googleapis.com/logs_based_metrics_error_count.

    Exemplo: uma entrada de registro que corresponde a uma métrica com base em registros chega atrasada. Ela tem um timestamp com o horário 14h30 e um receivedTimestamp com o horário 14h45. Essa entrada não será contada na métrica com base em registros.

A métrica tem muitas séries temporais

Você pode ter um rótulo definido pelo usuário em uma métrica com base em registros que tenha uma grande quantidade de valores exclusivos. O número de séries temporais em uma métrica depende do número de diferentes combinações de valores de rótulo. Quando a cardinalidade dos valores do rótulo é muito alta, a métrica pode ser acelerada e alguns pontos de dados podem não ser gravados na métrica. A métrica pode demorar a ser carregada nos gráficos devido ao grande número de séries temporais que ela precisa processar. Também pode haver uma cobrança pelas chamadas de API para consultar dados de séries temporais. Consulte os custos do Stackdriver Monitoring para ver mais detalhes.

Para evitar a criação de métricas de cardinalidade altas:

  • verifique se os campos de rótulo e as expressões regulares do extrator correspondem a valores que têm uma cardinalidade limitada;

  • evite extrair mensagens de texto longas que podem mudar, sem limites, como valores de rótulo;

  • evite extrair valores numéricos com cardinalidade ilimitada;

  • extraia apenas valores de rótulos de cardinalidade conhecida. Por exemplo, códigos de status com um conjunto de valores conhecidos.

O nome da métrica é inválido

Ao criar uma métrica de contador ou de distribuição, escolha um nome de métrica que seja único entre as métricas baseadas em registros em seu projeto.

As strings de nome de métrica não podem exceder 100 caracteres e podem incluir apenas os seguintes caracteres:

  • A-Z
  • a-z
  • 0-9
  • Os caracteres especiais _-.,+!*',()%\/.

    O caractere de barra / denota uma hierarquia de partes dentro do nome da métrica e não pode ser o primeiro caractere do nome.

Os valores de rótulo estão truncados

Os valores de rótulos definidos pelo usuário não podem exceder 1.024 bytes.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Stackdriver Logging
Precisa de ajuda? Acesse nossa página de suporte.