Este documento descreve como analisar dados de métricas criando um gráfico temporário com o Metrics Explorer. Por exemplo, para conferir a utilização da CPU de uma máquina virtual (VM), use o Metrics Explorer para criar um gráfico que mostre os dados mais recentes. Se você quiser gráficos permanentes, crie um usando o Metrics Explorer e salve-o em um painel personalizado. Uma alternativa é criar um painel personalizado, que pode mostrar gráficos, registros, incidentes e outros conteúdos, e usar a interface do painel para adicionar gráficos a ele. Para informações sobre painéis personalizados, consulte Criar e gerenciar painéis personalizados.
É possível criar gráficos, como aqueles que representam um único tipo de métrica, e gráficos complexos, como aqueles que representam vários tipos de métricas. Depois de criar um gráfico com o Metrics Explorer, você pode descartá-lo, salvá-lo em um painel personalizado, salvar a configuração dele ou compartilhar.
A captura de tela a seguir mostra um único tipo de métrica, a utilização da CPU de uma instância de VM, em um gráfico na página Metrics Explorer:
A captura de tela anterior mostra várias linhas, e cada uma mostra a utilização média da CPU para todas as VMs em uma zona específica.
Criar um gráfico com um único tipo de métrica
Para configurar um gráfico para mostrar uma única métrica, faça o seguinte:
-
No Console do Google Cloud, acesse a página do leaderboard Metrics Explorer:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.
Especifique os dados que vão aparecer no gráfico. É possível usar uma interface orientada por menu, a linguagem de consulta do Monitoring (MQL), o PromQL ou inserir um filtro de monitoramento:
- Na barra de ferramentas do painel do criador de consultas, selecione o botão code MQL ou code PromQL.
- Verifique se MQL está selecionado na opção de ativar/desativar MQL. A alternância de idiomas está na mesma barra de ferramentas que permite formatar sua consulta.
-
Insira sua consulta no editor de consultas. Por exemplo, para listar a utilização da CPU das instâncias de VM no seu projeto do Google Cloud, use a seguinte consulta:
fetch gce_instance | metric 'compute.googleapis.com/instance/cpu/utilization' | group_by 1m, [value_utilization_mean: mean(value.utilization)] | every 1m
Para mais informações sobre o MQL, consulte estes documentos:
- Na barra de ferramentas do painel do criador de consultas, selecione o botão code MQL ou code PromQL.
- Verifique se PromQL está selecionado na opção de ativar/desativar Idioma. A alternância de idiomas está na mesma barra de ferramentas que permite formatar sua consulta.
-
Insira sua consulta no editor de consultas. Por exemplo, para listar a utilização média de CPU das instâncias de VM no seu projeto do Google Cloud, use a seguinte consulta:
avg(compute_googleapis_com:instance_cpu_utilization)
Para mais informações sobre como usar PromQL, consulte PromQL no Cloud Monitoring.
-
No elemento Métrica, clique em help_outline Help e selecione Modo de filtro direto.
Os elementos Métrica e Filtro são excluídos, e um elemento Filtros é criado, permitindo a entrada de texto.
Se você selecionou um tipo de recurso, uma métrica ou filtros antes de mudar para o Modo de filtro direto, essas configurações vão aparecer no campo do elemento Filtros.
- Insira um filtro do Monitoring no campo do elemento Filters.
Combine e alinhe série temporal:
Para mostrar todas as séries temporais, no elemento Agregação, defina o primeiro menu como Não agregado e o segundo como Nenhum.
Para combinar série temporal, no elemento Agregação, faça o seguinte:
Abra o primeiro menu e selecione uma função.
O gráfico é atualizado e mostra uma única série temporal. Por exemplo, se você selecionar Média, a série temporal exibida será a média de todas as séries temporais.
Para combinar série temporal com os mesmos valores de rótulos, abra o segundo menu e selecione um ou mais rótulos.
O gráfico é atualizado e mostra uma série temporal para cada combinação exclusiva de valores de rótulo. Por exemplo, para mostrar em séries temporais por zona, defina o segundo menu como zona.
Quando o segundo menu está definido como Nenhum, o gráfico mostra uma série temporal.
Opcional: para configurar o espaçamento entre os pontos de dados, clique em add Adicionar elemento de consulta, selecione Intervalo mínimo e insira um valor.
Para mais informações sobre agrupamento e alinhamento, consulte Escolher como exibir dados em gráficos.
Atualize as configurações do gráfico com base no tipo de métrica selecionado:
Para tipos de métricas de cota, use as seguintes configurações:
- Na barra de ferramentas, defina o controle de tempo como pelo menos uma semana. As métricas de cota geralmente informam uma amostra por dia.
- No painel Display, expanda o menu Widget type e selecione Stacked bar chart.
Para tipos de métricas com um tipo de valor
Distribution
, verifique se o menu Tipo de widget está definido como Gráfico de mapa de calor. Para mais informações, consulte Sobre as métricas de valor de distribuição.Para outros tipos de métricas, use o menu Tipo de widget para mostrar como os dados são exibidos. O menu Tipo de widget lista todos os tipos de widget disponíveis. No entanto, alguns widgets podem não estar ativados. Considere um gráfico que mostra várias série temporal e suponha que cada valor medido seja um número duplo:
- Os widgets Gráfico de linhas, Gráfico de barras empilhadas e Gráfico de áreas empilhadas são listados como Compatível. Você pode selecionar qualquer um desses tipos.
- O widget Heatmap está desativado porque só pode mostrar dados com valores de distribuição.
Opcional: para mudar a forma como um gráfico ou tabela mostra os dados selecionados, use as opções no painel Exibir:
Opções do gráfico:
- Menu Modo de análise: selecione entre gráficos de linhas, raio-x e estáticos.
- Menu Compare to Past: sobrepõe os dados atuais aos anteriores.
- Menu Threshold Line: adicione um limite de referência.
- Menu Legend Alias: configure o nome de uma coluna de legenda.
- Menus Atribuição do eixo Y, Identificadores do eixo Y e Escala do eixo Y: configure a atribuição, os identificadores ou a escala do eixo Y.
Opções da tabela:
- Menu Opção de valor: selecione entre o valor mais recente e um valor agregado.
- Menu Colunas visíveis: selecione quais colunas serão mostradas.
- Menu Formatação de colunas: configure nomes de colunas, alinhamento de dados em uma coluna, unidades e se as células têm códigos de cores.
- Menu Visualização de métrica: selecione se o valor é mostrado sozinho ou em relação a um intervalo de valores.
- Menu Legend Alias: configure o nome de uma coluna de legenda.
Criar um gráfico com vários tipos de métricas
Em algumas situações, é recomendável mostrar séries temporais de diferentes tipos de métricas no mesmo gráfico. Por exemplo, para comparar as cargas de leitura e gravação em uma VM, configure um gráfico para mostrar o número de bytes lidos e gravados.
Para criar gráficos com várias métricas, use a interface orientada por menu. As outras interfaces não têm suporte para a criação de gráficos de várias métricas.
Para mostrar várias métricas em um gráfico, faça o seguinte:
-
No Console do Google Cloud, acesse a página do leaderboard Metrics Explorer:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.
Especifique os dados que vão aparecer no gráfico.
Incompatível.
Incompatível.
Incompatível.
Criar um gráfico com uma proporção de métricas
Monitorar o número de erros informados pode ser útil, mas é mais provável que você precise monitorar a taxa de erros. Ou seja, você quer saber quantos erros ocorreram em relação ao número total de respostas. Para atender a esse requisito, configure um gráfico para mostrar a proporção de duas métricas. Para referências a exemplos e informações sobre anomalias que podem ocorrer ao criar gráficos de métricas, consulte Proporções de métricas.
Para mostrar uma proporção de métricas em um gráfico, faça o seguinte:
-
No Console do Google Cloud, acesse a página do leaderboard Metrics Explorer:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.
Especifique os dados que aparecerão no gráfico:
- Na barra de ferramentas do painel do criador de consultas, selecione o botão code MQL ou code PromQL.
- Verifique se MQL está selecionado na opção de ativar/desativar MQL. A alternância de idiomas está na mesma barra de ferramentas que permite formatar sua consulta.
-
Insira sua consulta no editor de consultas. A MQL permite calcular uma proporção de duas métricas diferentes e filtrar uma única métrica por um rótulo e, em seguida, calcular a proporção. A consulta a seguir calcula a proporção de respostas com um valor de
500
para o número total de respostas:fetch https_lb_rule::loadbalancing.googleapis.com/https/request_count | { filter response_code_class = 500 ; ident } | group_by [matched_url_path_rule] | outer_join 0 | div
Para mais informações sobre o MQL, consulte estes documentos:
- Na barra de ferramentas do painel do criador de consultas, selecione o botão code MQL ou code PromQL.
- Verifique se PromQL está selecionado na opção de ativar/desativar Idioma. A alternância de idiomas está na mesma barra de ferramentas que permite formatar sua consulta.
-
Insira sua consulta no editor de consultas. Por exemplo, para representar a proporção da latência média da métrica
my_summary_latency_seconds
, use a seguinte consulta:sum without (instance)(rate(my_summary_latency_seconds_sum[5m])) / sum without (instance)(rate(my_summary_latency_seconds_count[5m]))
Para mais informações sobre como usar PromQL, consulte PromQL no Cloud Monitoring.
Incompatível.
Salvar um gráfico para referência futura
Com o Metrics Explorer, você cria um gráfico que pode ser usado para explorar uma métrica. No entanto, os gráficos criados por essa ferramenta não são permanentes. Quando você sai da página do Metrics Explorer, o gráfico é descartado.
Para salvar um gráfico configurado com o Metrics Explorer para referência futura, adicione-o a um painel personalizado ou salve o URL dele:
Para adicionar o gráfico a um painel personalizado, siga um destes procedimentos:
Se você usa o console do Google Cloud para gerenciar os painéis personalizados, selecione Salvar gráfico na barra de ferramentas do Metrics Explorer e preencha a caixa de diálogo. É possível salvar o gráfico em um painel personalizado atual ou criar um painel.
Se você usa a API Cloud Monitoring para gerenciar seus painéis personalizados, atualize o arquivo JSON que define o painel e o conteúdo dele. Para acessar a representação JSON, clique em code Editor JSON na barra de ferramentas do gráfico.
Para informações detalhadas sobre como usar a API para gerenciar seus painéis personalizados, consulte Criar e gerenciar painéis por API.
Para manter uma referência à configuração do gráfico, salve o URL dele. Como o URL do gráfico codifica a configuração do gráfico, quando você cola esse URL em um navegador, o gráfico configurado é exibido.
Para conferir o URL do gráfico, clique em link Link na barra de ferramentas do gráfico.
Salvar a configuração de um gráfico
Ao gerenciar painéis personalizados usando a API Cloud Monitoring, você pode usar o Metrics Explorer para ajudar a construir os dados fornecidos à API:
Para gerar a representação JSON de um gráfico que você planeja adicionar a um painel, configure o gráfico com o Metrics Explorer. Em seguida, use as opções no Metrics Explorer para conferir e copiar a representação JSON do gráfico.
Para identificar a sintaxe de um filtro do Monitoring, usado com a API Cloud Monitoring, utilize a interface com menus do Metrics Explorer para configurar o gráfico. Depois de selecionar a métrica e os filtros, mude para o modo de filtro direto e confira o filtro de monitoramento equivalente.
Salvar os dados mostrados no gráfico
Para salvar os dados mostrados no gráfico no seu sistema local, clique em get_app Fazer o download do CSV.
A seguir
- Analisar os dados em gráficos
- Selecionar métricas com o Metrics Explorer
- Ver e gerenciar o uso de métricas
- Definir opções de exibição do gráfico