Esta página foi traduzida pela API Cloud Translation.
Switch to English

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 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:

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

Primeiros passos

Para verificar se você tem as permissões corretas para usar métricas com base em registros em um projeto do Cloud, consulte Controle de acesso nesta página.

Para usar o Cloud Monitoring pela primeira vez, consulte a seção Cloud Monitoring nesta página.

Como visualizar 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 e 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 no seu projeto do Cloud aparecem.

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

Cada painel contém um resumo das tabelas. A linha de cada métrica tem um menu que apresenta as seguintes opções:

  • Visualizar 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 que você quer 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 pelo destino.

  • Criar alerta a partir da métrica permite criar uma política de alertas baseada 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 ver 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 definidas pelo usuário

O painel Métricas definidas pelo usuário da interface de métricas com base em registros tem vários recursos para ajudar você a gerenciar as métricas definidas pelo usuário em seu 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 a métrica é criada.

  • AFiltrar métricas definidas pelo usuário permite filtrar a lista de métricas por pesquisa de texto ou métrica.Nome ,a descrição; eFiltro para começar.

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

Ao clicar em qualquer um dos nomes de coluna, você organiza 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.

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

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

  • Visualizar detalhes da métrica: mostra o Nome, Tipo, Descrição, Filtro{ da métrica /1}, Unidades e Rótulos, se definidos.
  • Editar métrica: permite editar determinados campos da métrica.
  • Desativar métrica: permite impedir que a métrica seja calculada. É possível reativar uma métrica desativada no mesmo menu.
  • Excluir métrica: permite excluir a métrica.
  • Visualizar registros de métricas: leva você ao Logs Explorer e preenche o filtro da métrica no Criador de consultas e executa a consulta.

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

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

Os dados de uma métrica com base em registros são provenientes de entradas 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. O Logging grava um novo ponto de dados na série temporal da métrica à 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.

As métricas com base em registros definidas pelo usuário podem ser dos tipos de métrica de contador 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 contador contam o número de entradas de registro que correspondem a um determinado filtro. Por exemplo, é possível:

  • Contar as entradas de registro que contêm uma determinada mensagem de erro.
  • 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] ...
    

    Extraindo [USERNAME] eOPERA O e o uso como valores para doisetiquetas , é possível perguntar mais tarde: "Quantas vezessally chamar o UPDATE operação?", "Quantas pessoas chamaram a 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 das entradas de registro correspondentes a um filtro. As métricas contêm uma série temporal de objetos de distribuição, cada um com o seguinte:

  • 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 de 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 Como criar métricas de distribuição.

Rótulos

As métricas com base em registros podem ter rótulos, que permitem que várias séries temporais sejam coletadas 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 as 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

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 contabilizam o número de entradas de registro que correspondem a um 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 Como criar métricas de contador e Como criar métricas de distribuição para começar.

Métricas com base em registros do sistema

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

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

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. Para mais informações, acesse Como criar 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/<var>SYSTEM_METRIC_NAME</var>
  • Definido pelo usuário: logging.googleapis.com/user/<var>...</var>

As métricas definidas pelo usuário incluem a string user.

Configuração

Para configurar um espaço de trabalho do Cloud Monitoring para seu projeto, faça o seguinte:
  1. No Console do Cloud, selecione seu projeto do Google Cloud.
    Acessar o Console do Cloud
  2. No painel de navegação, selecione Monitoring.

Controle de acesso

Para visualizar as métricas com base em registros do projeto do Cloud, verifique se você tem o papel e as permissões corretos.

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 temporais 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 do Logging (roles/logging.admin ),Editor do projeto (roles/editor ) e Proprietário do projeto (roles/owner ) são papéis de nível amplo que contêm a permissão para criar métricas com base em registros (logging.logMetrics.create .

Para mais informações sobre permissões e papéis, consulte este guia.

Preços

As 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.