Visão geral das métricas baseadas em registros

Nesta página, você encontra uma visão geral conceitual das métricas com base em registros.

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

Há dois tipos de métricas com base em registros:

  • Métricas com base em registros definidas pelo sistema, fornecidas pelo Cloud Logging para uso por todos os projetos do Google Cloud.

    As métricas com base em registros definidas pelo sistema são calculadas somente a partir dos registros que foram ingeridos pelo Logging. Se um registro tiver sido explicitamente excluído do processamento pelo Logging, ele não será incluído nessas métricas.

  • Métricas com base em registros definidas pelo usuário, criadas para acompanhar no projeto do Google Cloud itens que são de seu interesse. 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.

    As métricas com base em registros definidas pelo usuário são calculadas com base em todos os registros recebidos pela API Logging para o projeto do Cloud, independentemente dos filtros de inclusão oufiltros de exclusão que pode ser aplicado ao projeto do Cloud.

As métricas com base em registros se aplicam apenas a um único projeto do Google Cloud. Não é possível criá-los para buckets do Logging ou para outros recursos do Google Cloud, como contas ou organizações de faturamento do Cloud.

Antes de começar

Para usar métricas com base em registros, você precisa ter um projeto do Cloud com o faturamento ativado:

  1. No Console do Google Cloud, acesse a página do seletor de projetos.

    Acessar o seletor de projetos

  2. Para começar a criar um projeto do Google Cloud, clique em Criar projeto.

  3. Escolha o nome do projeto. Anote o código do projeto gerado.

  4. Edite os outros campos conforme necessário.

  5. Para criar o projeto, clique em Criar.

Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

Para verificar se você tem as permissões corretas para usar métricas baseadas em registros para o projeto do Cloud, consulte Controle de acesso com métricas baseadas em registros do IAM.

Ver suas métricas com base em registros

A página Métricas com base em registros no Console do Google Cloud permite criar uma métrica com base em registros. Ela contém listas de todas as métricas com base em registros do seu projeto do Cloud.

Para visualizar uma lista de métricas com base em registros do seu projeto do Google Cloud, faça o seguinte:

  1. Acesse a página Métricas com base em registros no Console do Cloud:

    Acessar "Métricas com base em registros"

  2. Selecione um projeto do Cloud existente. As listas de métricas com base em registros serão exibidas no projeto do Cloud.

A interface de métricas com base em registros é dividida em dois painéis de tipos de métricas: Métricas do sistema e Métricas definidas pelo usuário.

Cada painel contém um resumo da tabela das métricas. Cada linha da métrica tem um menu que apresenta estas opções:

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

    É possível usar o Metrics Explorer para especificar a métrica desejada 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 pelo destino.

  • Criar alerta a partir da métrica permite criar uma política de alertas com base na 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 detalhes sobre como criar políticas de alertas para suas métricas com base em registros, leia Como criar uma política de alertas.

Painel de métricas definido pelo usuário

O painel de métricas definidas pelo usuário da interface de métricas com base em registros tem vários recursos para ajudar você a gerenciá-las no projeto do Cloud:

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

  • O painel Filtrar métricas definidas pelo usuário permite filtrar a lista de métricas por pesquisa de texto ou por Nome, Descrição e Filtro da métrica.

  • A tabela de métricas definida pelo usuário inclui colunas de Uso no mês anterior e Uso acumulado no mês (MTD). Esses dados de uso são úteis, por exemplo, se você quiser determinar quais métricas ingerem mais dados ou estimar faturas.

Ao clicar em qualquer um dos nomes de coluna, você organiza os dados em ordem crescente ou decrescente.

O menu de cada métrica no painel de métricas definido pelo usuário contém outros recursos para gerenciar suas métricas:

Opções do menu flutuante do painel de métricas com base em registros definidas pelo usuário.

  • Ver detalhes da métrica: mostra Nome, Tipo, descrição, Filtro, Unidade e Rótulos da métrica, se definidos.
  • Editar métrica: permite editar determinados campos da métrica.
  • Desativar métrica: permite que você pare de calcular a métrica. É possível reativar uma métrica desativada no mesmo menu.
  • Excluir métrica: permite excluir a métrica.
  • Visualizar registros da métrica: direciona você para o Explorador de registros, preenche o filtro da métrica no Criador de consultas e executa a consulta.

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

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

Os dados de uma métrica com base em registros são provenientes das entradas de registro recebidas após a criação de uma métrica. Uma métrica não é preenchida retroativamente com dados de entradas de registro que já estão no Logging.

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 de uma métrica com base em registros representa apenas as informações adicionais (delta) recebidas desde o ponto de dados anterior.

As métricas com base em registros definidas pelo usuário podem ser dos tipos de métricas 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.

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 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 Métricas de distribuição de gráficos.

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.

Métricas com base em registros definidas pelo usuário

As métricas com base em registros definidas pelo usuário são criadas por um usuário em um projeto do Google Cloud. Essas métricas contam o número de entradas de registro que correspondem a determinado filtro ou registram valores específicos nas entradas de registro correspondentes.

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

Métricas com base em registros do sistema

O Logging fornece um conjunto de métricas que inclui contadores. As métricas de contador registram o número de eventos de registro que ocorreram em um período específico. As métricas têm rótulos que gravam as contagens por nome do registro e nível de gravidade.

Para uma lista dessas métricas, consulte Métricas do Google Cloud: geração de registros.

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

Observe que as métricas definidas pelo usuário incluem a string user.

Preços

Métricas com base em registros definidas pelo usuário são uma classe de métricas personalizadas do Cloud Monitoring e estão sujeitas a cobrança.

Para informações sobre preços, consulte Preços do Cloud Logging: métricas com base em registros.

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.