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

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

As métricas com base em registros são métricas do Cloud 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 em políticas de alertas e gráficos do Cloud Monitoring.

As métricas do sistema (com base em registros) são predefinidas pelo Logging. Elas gravam o número de eventos de geração de registro ocorridos dentro de 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 uma determinada consulta ou rastreiam valores específicos nas entradas de registro correspondentes. Ao filtrar as entradas de registro que você quer contabilizar nas métricas, é possível usar expressões regulares.

O Logging acumula informações para métricas 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.

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

Primeiros passos

  1. Acesse a página Geração de registros do Pacote de operações do Google Cloud > Métricas com base em registros no Console do Cloud:

    Ir para a página Métricas com base em registros

  2. Selecione um dos seus projetos do Google Cloud na parte superior da página. Serão exibidas as listas de métricas com base em registros no seu projeto do Google Cloud:

A interface do usuário que mostra as listas de métricas com base em registros.

Controle de acesso

Os papéis e as permissões de gerenciamento de identidade e acesso controlam o acesso aos dados do Google Cloud. Veja a seguir um resumo dos papéis e das permissões comuns que um membro de um projeto do Google Cloud precisa ter para acessar métricas com base em registros:

  • O Logging/gravador de configurações de registros (roles/logging.configWriter) permite listar, criar, obter, atualizar e excluir métricas com base em registros.

  • O Logging/visualizador de registros (roles/logging.viewer) permite visualizar as métricas existentes. Também é possível adicionar as permissões logging.logMetrics.get e logging.logMetrics.list a um papel personalizado.

  • O visualizador do Monitoring (roles/monitoring.viewer) permite a leitura das séries de tempo que a métrica com base em registros contém. Também é possível adicionar a permissão monitoring.timeSeries.list a um papel personalizado.

  • Administrador (roles/logging.admin), editor (roles/editor) e proprietário do Logging (roles/owner) são papéis de nível amplo com permissão para criar métricas com base em registros (logging.logMetrics.create).

Para mais informações, vá até Logging: controle de acesso.

Interface das métricas com base em registros

A interface das métricas com base em registros é dividida em duas áreas de 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 que apresenta estas opções:

As listas de métricas com base em registros que mostram o menu flutuante.

  • A visualização no Metrics Explorer permite visualizar os dados de uma métrica com base em registros do sistema abrindo o Metrics Explorer do Cloud Monitoring.

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

  • Criar alerta a partir da métrica permite criar uma política de alertas baseada na sua métrica com base em registros.

    Selecionar essa opção abre o console do Cloud Monitoring, local em que é possível criar, editar e gerenciar políticas de alerta. Para mais detalhes, leia Como criar uma política de alertas.

Interface das 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 definidas pelo usuário inclui as colunas Nome, Descrição, Tipo e Filtro. Elas são especificadas quando a métrica é criada.

  • A caixa Métricas de filtro permite filtrar a lista de métricas por Nome, Descrição e Filtro de métrica ou com uma pesquisa de texto:

As listas de métricas com base em registros que mostram as opções de filtragem.

  • A tabela de métricas definidas pelo usuário inclui as colunas Uso no mês anterior e Uso (mês atual). Essas métricas de uso são úteis, por exemplo, para determinar quais métricas ingerem a maioria dos dados ou estimar suas faturas.

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

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

Para mais informações sobre como gerenciar métricas definidas pelo usuário com o Console do Cloud, leia 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 Logging: de contador e de 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 que correspondem a uma consulta de registros avançada. Por exemplo, é possível:

  • Criar uma métrica que conta 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 como esta:

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

    Ao extrair [USERNAME] e [OPERATION] e usá-los como valores para dois rótulos, é possível perguntar depois: "Quantas vezes sally chamou a operação UPDATE?", "Quantas pessoas chamaram de operação READ?", "Quantas vezes george chamou uma operação?", e assim por diante.

Para mais informações, vá até Como criar métricas de contador.

Métricas de distribuição

As métricas de distribuição acumulam dados numéricos de entradas de registro correspondentes a uma consulta. 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 mais informações, vá até 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 Logging grava 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. É possível definir seus próprios rótulos para as métricas definidas pelo usuário. Para mais informações, leia Rótulos de métricas com base em registros.

Métricas com base em registros do sistema

O Logging fornece algumas métricas de contador predefinidas que rastreiam o número e o volume das entradas de registro recebidas. As métricas têm rótulos que gravam 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 com o uso de 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 atrasadas. 1

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

1 As entradas de registro recebidas por mais de 24 horas ou com 10 minutos não estão incluídas nas métricas log_entry_count ou byte_count.

Para ver uma lista completa das métricas com base em registros do sistema, vá até Métricas do Logging.

Cloud Monitoring

É possível usar 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. Os nomes das métricas com base em registros definidos pelo usuário são prefixados por user/. Os nomes das métricas com base em registros do sistema não são.

Se você estiver usando a API Cloud Monitoring, os nomes das métricas com base em registros serão os seguintes:

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

Para mais informações, vá até Como criar gráficos e alertas.

Solução de problemas

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