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 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 Geração de registros.

  2. Selecione um projeto atual 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 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 pesquisa de texto ou Nome, Descrição e Filtro da métrica.

    • A tabela de métricas definida pelo usuário inclui colunas para 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, quando você quer determinar quais métricas ingerem mais dados ou estimar faturas.

    O menu Mais de cada métrica no painel definido pelo usuário contém recursos adicionais 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.
    • Visualizar registros da métrica: leva você à 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.

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 Geração de registros.

  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 pré-configurado para você. No entanto, talvez você queira alterar 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:

    O Metrics Explorer exibindo 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 acessar os dados de um registro específico, adicione um filtro. Por exemplo, para ver a métrica byte_count das entradas de registro gravadas pelo BigQuery, clique em Adicionar filtro, selecione registro e, em seguida, a entrada do BigQuery. O gráfico agora exibe uma única série temporal, que mostra o total de bytes de registro gravados pelo BigQuery. Se você quiser visualizar a métrica byte_count pela gravidade da entrada de registro, altere o segundo menu na entrada Agregação de Nenhuma 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 registros com valor de distribuição, 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 atual ou criar um novo.

A seguir