Listar e criar gráficos com 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 com base em registros e criar políticas de alertas. 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 exibe duas listas de tipos de métricas: 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 Nome, Descrição, colunas Type e Filter. Esses campos são especificados quando você criar 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 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. Você pode reativar uma métrica desativada no mesmo menu.
    • Excluir métrica: permite excluir a métrica.
    • Ver registros da métrica: leva você à Análise de registros e preenche o filtro da métrica no Criador de consultas e executa a consulta.
    • Ver no Metrics Explorer: permite criar um gráfico da métrica.
    • Criar alerta com base na métrica: permite configurar notificações quando um métrica com base em registros corresponde aos critérios especificados. Para mais informações, consulte Alertar sobre métricas com base em registros.

Criar gráficos com 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 consultar e selecione Ver no Metrics Explorer no menu Mais da métrica .

    O Metrics Explorer é aberto e é pré-configurada para você. No entanto, talvez você queira alterar alguns gráficos configurações.

    Por exemplo, a captura de tela abaixo 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 exibe várias série temporal.

    Para acessar 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 exibe uma única série temporal, que mostra o total de os 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 exibido 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 Salvar gráfico 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