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

Neste documento, descrevemos 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 para 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 painel de navegação do console do Google Cloud, selecione Logging e, em seguida, Métricas com base em registros:

    Acessar Métricas com base em registros

  2. Selecione um projeto atual do Google Cloud. A interface de 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 no gerenciamento das métricas definidas pelo usuário no seu projeto do Google Cloud:

    • A tabela de métricas definida 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 de métrica ou pesquisa de texto.

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

    O menu Mais de cada métrica no painel de métricas definidas pelo usuário contém outros recursos de gerenciamento:

    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 a Análise de registros, 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 uma métrica com base em registros corresponde aos critérios especificados. Para mais informações, consulte Alerta sobre métricas com base em registros.

Métricas com base em registros do gráfico

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

  1. No painel de navegação do console do Google Cloud, selecione Logging e, em seguida, Métricas com base em registros:

    Acessar Métricas com base em registros

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

    O Metrics Explorer é aberto e pré-configurado para você. No entanto, talvez você queira alterar algumas configurações de 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 determinado projeto do Google Cloud:

    O Metrics Explorer exibe a métrica do sistema chamada byte_count.

    A entrada Agregação 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. Portanto, o gráfico exibe várias série temporal.

    Para consultar os dados de um registro específico, adicione um filtro. Por exemplo, para visualizar a métrica byte_count para entradas de registro gravadas pelo BigQuery, clique em Adicionar filtro, selecione registro e, em seguida, selecione a entrada do BigQuery. O gráfico agora exibe uma única série temporal, que mostra o total dos bytes de registro gravados pelo BigQuery. Se você quiser visualizar a métrica byte_count de acordo com a gravidade da entrada de registro, altere o segundo menu na entrada Agregação de Nenhum para Gravidade. 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 base em registro com valor de distribuição, expanda o 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: salve o gráfico para referência futura clicando em Salvar gráfico na barra de ferramentas e preencha a caixa de diálogo. Você pode salvar o gráfico em um painel atual ou criar um novo painel.

A seguir