Listar e criar gráficos de métricas com base em registros

Este documento descreve como listar e criar gráficos de métricas com base em registros usando o console do Google Cloud. Para informações sobre como criar métricas com base em registros, consulte Configurar métricas de contador e Configurar métricas de distribuição.

Antes de começar

Verifique se o papel do Identity and Access Management inclui as permissões necessárias para criar e visualizar métricas baseadas em registros e criar políticas de alerta. Para mais detalhes, consulte Permissões para métricas com base em registros.

Listar métricas com base em registros

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

  1. No console do Google Cloud, acesse a página Métricas com base em registros.

    Acessar Métricas com base em registros

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Logging.

  2. Selecione um projeto do Google Cloud. A interface das métricas com base em registros mostra duas listas de tipos de métrica: Métricas do sistema e 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 no projeto do Google Cloud:

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

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

    • A tabela de métricas definidas 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.

    O menu Mais de cada métrica no painel de métricas definidas 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.
    • Visualizar no Metrics Explorer: permite criar gráficos da métrica.
    • Criar alerta com base em métrica: permite configurar notificações quando uma métrica com base em registros corresponde aos critérios especificados. Para mais informações, consulte Alertar sobre métricas com base em registros.

Mostrar métricas com base em registros

Para criar um gráfico de uma métrica com base em registros, faça o seguinte:

  1. No console do Google Cloud, acesse a página Métricas com base em registros.

    Acessar Métricas com base em registros

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Logging.

  2. Encontre a métrica que você quer visualizar e selecione Ver no Metrics Explorer no menu Mais da métrica.

    O Metrics Explorer é aberto e preconfigured para você. No entanto, talvez você queira mudar algumas configurações do gráfico.

    Por exemplo, a captura de tela a seguir mostra um gráfico da métrica do sistema com o nome byte_count para um projeto específico do Google Cloud:

    Metrics Explorer mostrando a métrica do sistema chamada byte_count.

    A entrada Aggregation mostra que cada série temporal no gráfico é uma soma dos bytes gravados em um registro específico. No exemplo anterior, o projeto contém vários registros, então o gráfico mostra várias série temporal.

    Para conferir os dados de um registro específico, adicione um filtro. Por exemplo, para conferir a métrica byte_count das entradas de registro gravadas pelo BigQuery, clique em Adicionar filtro, selecione registro e a entrada do BigQuery. O gráfico agora mostra uma única série temporal, que mostra o total de bytes de registro gravados pelo BigQuery. Se você quiser conferir a métrica byte_count pela gravidade da entrada de registro, mude o segundo menu na entrada Aggregation de None para Severity. O gráfico a seguir mostra a métrica byte_count exibida por nível de gravidade para registros gravados pelo BigQuery:

    Metrics Explorer mostrando a métrica byte_count por gravidade para instâncias do BigQuery

  3. Para métricas com valores de distribuição e baseadas em registros, expanda Gráfico de linhas e selecione Gráfico de mapa de calor.

    Para mais informações sobre métricas com valor de distribuição, consulte Métricas de distribuição e Percentis e métricas com valor de distribuição.

  4. Opcional: para salvar o gráfico para referência futura, clique em Save chart na barra de ferramentas e preencha a caixa de diálogo. É possível salvar o gráfico em um painel existente ou criar um novo.

A seguir