Neste documento, descrevemos como configurar um gráfico em um painel personalizado para exibir dados de série temporal coletados pelo seu projeto. Os gráficos podem mostrar apenas com dados numéricos de série temporal. Para informações sobre como configurar o estilo de um gráfico, consulte Definir as opções de exibição do gráfico.
Selecionar os dados a serem exibidos
Para configurar quais série temporal exibir em um gráfico, faça o seguinte: crie uma consulta fazendo seleções a partir de menus ou escreva uma consulta. Ao escrever uma consulta, você seleciona a linguagem de consulta e, em seguida, usa uma editor de consultas ou uma interface baseada em texto:
As consultas da linguagem de consulta do Monitoring (MQL, na sigla em inglês) especificam a série temporal e como essas série temporal são agrupadas e alinhadas. A interface MQL oferece suporte a um editor de código com sugestões e verificação de sintaxe.
Geralmente, não é possível converter consultas MQL em formulários que pode ser usado por outras interfaces. Suas consultas não salvas estão descartadas ao alternar para ou da guia MQL.
As consultas da linguagem de consulta do Prometheus (PromQL) especificam e como essas série temporal são agrupadas e alinhadas. A interface do PromQL oferece suporte a um editor com sugestões.
Geralmente, não é possível converter consultas PromQL em formulários que pode ser usado por outras interfaces. Suas consultas não salvas estão descartadas ao alternar para ou da guia PromQL.
Consultas de filtro de monitoramento especificam a série temporal, mas não incluem instruções de agrupamento ou alinhamento.
Qualquer série temporal que o Monitoring possa criar um gráfico pode ser especificada usando um filtro do Monitoring. Por exemplo, para criar um gráfico com o número de processos em execução em uma VM, é preciso usar uma Filtro de monitoramento que especifica uma função.
Nem sempre é possível converter um filtro do Monitoring para a forma exigida por outras interfaces. Portanto, sua consulta pode serão descartados se você alternar para uma interface diferente.
As consultas normalmente especificam um tipo de métrica, um tipo de recurso e filtros:
Um tipo de métrica identifica as medidas a serem coletadas de um recurso. Ele inclui uma descrição do que está sendo medido e como as medições são interpretadas. Às vezes, um tipo de métrica é chamado de métrica. Um exemplo de métrica é "Utilização da CPU". Para informações conceituais, consulte Tipos de métricas.
Um tipo de recurso especifica de qual recurso os dados da métrica são coletados. capturado. O tipo de recurso às vezes é chamado de tipo de recurso monitorado ou o recurso. Um exemplo de é uma "instância de máquina virtual (VM)" do Compute Engine. Para informações conceituais, consulte Recursos monitorados.
As consultas MQL e PromQL incluem agrupamento e alinhamento declarações. No entanto, ao criar um filtro do Monitoring ou usar para selecionar a série temporal que será incluída no gráfico, configura o agrupamento as configurações de alinhamento usando menus.
Criar consultas usando menus
A configuração padrão é criar consultas usando menus. Normalmente, se uma métrica e um filtro e, em seguida, alterna para uma interface diferente, suas seleções serão preservadas e reformatadas para essa interface. Ou seja, uma consulta criada por menus pode ser convertida em uma consulta MQL.
Você pode retornar das outras interfaces para a interface orientada por menus selecionando tune Builder. No entanto, sua consulta será descartada. Ou seja, uma consulta MQL não pode ser convertida em um modelo formulário baseado em menus.
Para criar sua consulta usando menus, faça o seguinte:
-
No console do Google Cloud, acesse a página
Painéis:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.
Escolha uma destas opções:
- Para criar um novo painel, selecione Criar painel.
- Para atualizar um painel, localize-o na lista de painéis e, em seguida, selecione seu nome.
Na barra de ferramentas, clique em add Add widget.
Na caixa de diálogo Adicionar widget, selecione leaderboard Métrica.
Na barra de ferramentas do painel de consulta, faça o seguinte:
No elemento Métrica, expanda o menu Selecionar uma métrica.
O menu Selecionar uma métrica contém recursos que ajudam você a encontrar os tipos de métrica disponíveis:
Para encontrar um tipo de métrica específico, use o Barra de filtros filter_list. Por exemplo, se você digitar
util
, restringir o menu a mostra entradas que incluemutil
. As entradas aparecem quando são aprovadas um valor "contém" que não diferencia maiúsculas de minúsculas teste.Para mostrar todos os tipos de métrica, mesmo as que não têm dados, clique em
Ativo. Por padrão, os menus mostrar apenas tipos de métricas com dados.
Faça uma seleção no menu Recursos. os menus Categorias de métrica, Métricas e, em seguida, Clique em Aplicar.
Por exemplo, para criar um gráfico com o uso da CPU em uma Compute Engine máquina virtual, selecione Instância de VM, Instância Uso da CPU e, em seguida, clique em Aplicar.
O menu Recursos lista o recurso do qual os dados são coletados. Quando uma métrica não é gravada em um recurso, Selecione Não especificado.
Depois de concluir a etapa anterior, o gráfico vai mostrar as série temporal:
O gráfico anterior contém mais dados do que podem ser exibidos. os gráficos são limitado a 50 linhas que podem ser exibidas. O gráfico mostra um aviso de que há muitos dados para exibir. Para reduzir o volume de dados, usar os campos da Ordenar e limit. Para mais informações, consulte Mostre outliers.
Também é possível usar as opções de filtragem e agregação para reduzir a quantidade de dados em gráficos. Essas técnicas tornam os gráficos mais úteis para diagnósticos e análises e aumentam o desempenho e a capacidade de resposta da própria interface de usuário.
Opcional: adicione filtros para restringir quais série temporal são mostradas. O próximo descreve as opções de filtragem.
Opcional: configure como as série temporal são agrupadas e alinhadas. Para mais mais informações, consulte Escolher como exibir dados nos gráficos.
Para aplicar as alterações ao painel, na barra de ferramentas, Clique em Aplicar. Para descartar as mudanças, clique em Cancelar.
Filtrar dados gráficos
Os filtros garantem que apenas série temporal que atendam a algum conjunto de critérios sejam incluídas no gráfico. Ao aplicar filtros, é possível reduzir o número de linhas no gráfico, o que pode melhorar o desempenho do gráfico. Outra maneira de melhorar a capacidade de resposta de um gráfico é configurar opções de agregação e classificar e limitar o número de série temporal exibidas. Para mais informações, consulte Mostrar outliers.
Um filtro é composto por um rótulo, um comparador e um valor. Por exemplo:
para corresponder a todas série temporal com o rótulo zone
que começa com "us-central1"
,
você pode usar o filtro zone=~"us-central1.*"
, que usa uma expressão regular
para realizar a comparação. Há quatro operadores de comparação:
- igual a
=
- diferente de,
!=
- correspondência de expressão regular,
=~
- a expressão regular não corresponder,
!=~
Quando você filtra pelo ID do projeto ou pelo contêiner de recursos,
use o operador de igualdade, (=)
. Ao filtrar por
outros rótulos, use qualquer comparador compatível.
Normalmente, é possível filtrar rótulos de métricas e recursos
grupo de recursos.
Quando você fornece vários critérios de filtragem, o gráfico correspondente mostra
apenas as série temporal que atendem a todos os critérios, um AND
lógico.
Para adicionar um filtro ao usar a interface orientada por menus do console do Google Cloud, faça o seguinte:
No elemento Filtro, clique em Adicionar filtro e faça uma seleção no menu.
Para mudar a comparação, selecione um valor no menu Comparador.
No campo Valor, digite ou selecione um valor:
Para uma comparação direta,
=
ou!=
, selecione o valor nas ou insira um valor e clique em Ok. Você pode inserir valores comous-central1-a
, ou crie um filtro string que começa comstarts_with
ouends_with
. Por exemplo, para exibir dados de qualquer zonaus-central1
, digite a string de filtrostarts_with("us-central1")
. Consulte Como monitorar filtros. para mais informações sobre strings de filtro.Como as entradas de menu são derivadas da série temporal recebida, quando um recurso monitorado não estiver gerando dados para a métrica selecionada você precisa inserir um valor para o rótulo.
Para uma comparação de expressões regulares,
=~
ou!=~
, insira um RE2 expressão regular no campo Valor e clique em Ok. Por exemplo, a expressão regularus-central1-.*
corresponde a qualquer zonaus-central1
:Para corresponder a qualquer zona dos EUA que termine com "a", use a expressão regular
^us.*.a$
.Não é possível usar expressões regulares para filtrar o rótulo de recurso
project_id
.Por exemplo, para visualizar somente a série temporal de um dos
us-central1
zonas, aplique um filtrozone=~"us-central1.*"
.
Quando você adiciona vários filtros, os seguintes pontos são aplicados:
Você pode usar o mesmo marcador várias vezes, o que permite especificar um filtro para um intervalo de valores.
Todos os critérios de filtro precisam ser atendidos. elas constituem um
AND
lógico.
Para editar o valor ou comparador de um filtro, no elemento de filtro, clique em arrow_drop_down Menu, deixe seu alterações e clique em OK.
Para excluir um filtro, clique em cancel Cancelar.
Criar consultas MQL
Para inserir uma consulta MQL ou PromQL, faça o seguinte:
-
No console do Google Cloud, acesse a página
Painéis:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.
Escolha uma destas opções:
- Para criar um novo painel, selecione Criar painel.
- Para atualizar um painel existente, localize-o na lista de todos painéis e, em seguida, selecione seu nome.
Na barra de ferramentas, clique em add Add widget.
Na caixa de diálogo Adicionar widget, selecione leaderboard Métrica.
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 Idioma. A alternância de idiomas está na mesma barra de ferramentas que permite formatar sua consulta.
Opcional: desative o botão de alternância Execução automática.
Insira sua consulta no editor de consultas. Por exemplo, para criar um gráfico utilização da CPU pelas instâncias de VM no projeto do Google Cloud. 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 os documentos a seguir:
Clique em Executar consulta.
Quando o botão Executar automaticamente estiver ativado, o botão Executar consulta não será exibido.
Criar consultas PromQL
Para inserir uma consulta MQL ou PromQL, faça o seguinte:
-
No console do Google Cloud, acesse a página
Painéis:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.
Escolha uma destas opções:
- Para criar um novo painel, selecione Criar painel.
- Para atualizar um painel existente, localize-o na lista de todos painéis e, em seguida, selecione seu nome.
Na barra de ferramentas, clique em add Add widget.
Na caixa de diálogo Adicionar widget, selecione leaderboard Métrica.
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.
Opcional: desative o botão de alternância Execução automática.
Insira sua consulta no editor de consultas. Por exemplo, para criar um gráfico da média utilização da CPU das instâncias de VM no projeto do Google Cloud, use o seguinte consulta:
avg(compute_googleapis_com:instance_cpu_utilization)
Para mais informações sobre como usar PromQL, consulte PromQL no Cloud Monitoring.
Clique em Executar consulta.
Quando o botão Executar automaticamente estiver ativado, o botão Executar consulta não será exibido.
Escrever consultas de filtro de monitoramento
Quando você quiser realizar uma das seguintes ações, use o modo de filtro direto, que permite inserir Filtro de monitoramento:
- Exibir um objetivo de nível de serviço (SLO).
- Exibir o número de processos em execução em máquinas virtuais (VMs).
- Exiba uma métrica personalizada de que você ainda não tem dados.
- Filtre uma série temporal com base em um rótulo para o qual você ainda não tem dados.
Um filtro do Monitoring ou, de maneira equivalente, um
metric filter, é uma expressão que o Monitoring
usa para identificar a série temporal que será incluída no gráfico.
Por exemplo, a expressão a seguir resulta
em um gráfico que mostra uma contagem de processos com o nome nginx
:
select_process_count("monitoring.regex.full_match(\".*nginx.*\")")
resource.type="gce_instance"
Também é possível usar filtros do Monitoring para identificar série temporal
por recurso e tipo de métrica. A expressão a seguir resulta em um
gráfico que exibe o número de entradas de registro de todas o Google Cloud virtuais
instâncias de máquina na zona us-east1-b
:
metric.type="logging.googleapis.com/log_entry_count"
resource.type="gce_instance"
resource.label."zone"="us-east1-b"
Para inserir um filtro de Monitoramento, faça o seguinte:
-
No console do Google Cloud, acesse a página
Painéis:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.
Escolha uma destas opções:
- Para criar um novo painel, selecione Criar painel.
- Para atualizar um painel, localize-o na lista de painéis e, em seguida, selecione seu nome.
Na barra de ferramentas, clique em add Add widget.
Na caixa de diálogo Adicionar widget, selecione leaderboard Métrica.
Clique em help_outline Ajuda no elemento Métrica e, em seguida, selecione Modo de filtro direto.
Os elementos Metric e Filter são excluídos, e um Filtros permite que você insira texto, é criado.
Se você selecionou um tipo de recurso, métrica, antes de alternar para o modo modo de filtro direto e, em seguida, Essas configurações são mostradas no elemento Filtros.
Na área de texto do elemento Filtros, digite uma expressão de filtro do Monitoring. Para informações de sintaxe, consulte os documentos a seguir:
Quando você usa o modo de filtro direto e não há dados disponíveis que satisfaçam às filtro, um erro será exibido. Mensagens de erro comuns incluem
Chart definition invalid
eNo data is available for the selected timeframe.
Opcional: configure como as série temporal são agrupadas e alinhadas. Para mais mais informações, consulte Escolher como exibir dados nos gráficos.
Para voltar à interface com menus, clique em tune Sair do modo de filtro direto.
Escolha como exibir os dados gráficos
Após a seleção dos dados de séries temporais, o próximo passo é determinar como esses dados são exibidos. Por exemplo, você quer exibir cada série temporal ou quer combinar essas séries?
Nesta seção, explicamos como definir os campos de agregação. A agregação consiste no alinhamento de pontos de dados em uma série temporal e na combinação de diferentes séries temporais. Para uma explicação detalhada sobre agregação, consulte Filtragem e agregação: como manipular séries temporais.
- Para informações sobre as opções de exibição, consulte Definir as opções de exibição do gráfico.
- Para mais informações sobre como interagir com o gráfico, consulte Explore os dados nos gráficos.
O conteúdo desta seção não se aplica quando você seleciona os dados criar gráficos usando um MQL ou PromQL.
Combinar série temporal
É possível reduzir a quantidade de dados retornados para uma métrica combinando diferentes séries temporais. Para combinar diversas série temporal, normalmente especificar um ou mais rótulos e uma função. Séries temporais que tenham o mesmo valor para todos os rótulos especificados são agrupados, e a função que você especificou combina essas séries temporais em uma nova série temporal.
As configurações no elemento Agregação podem alterar o número de que o gráfico exibe. As configurações padrão desse elemento são determinadas pelo tipo de métrica selecionado. Para modificar a tela, siga um destes procedimentos:
Para exibir cada série temporal, no elemento Agregação, faça o seguinte: verifique se o primeiro menu está definido como Desagregado e o segundo menu como definido como None.
Para combinar série temporal, no elemento Agregação: faça o seguinte:
Expanda o primeiro menu e selecione uma função.
O gráfico é atualizado e exibe uma única série temporal. Por exemplo: Se você selecionar Média, a série temporal exibida será a média de todas série temporal.
Para combinar série temporal que têm os mesmos valores de rótulo, expanda o segundo menu e selecione um ou mais marcadores.
O gráfico é atualizado e mostra uma série temporal para cada combinação de valores de rótulo. Por exemplo, para exibir em série temporal por zona, defina o segundo menu como zone.
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.
Por exemplo, se você definir a função como Soma e selecionar o rótulo user_labels.version, então há uma série temporal para cada valor do rótulo user_labels.version. Os pontos de dados em cada série temporal são calculados a partir da soma de todos os valores para série temporal individuais de uma versão específica:
Quando você seleciona vários rótulos, série temporal que têm os mesmos os valores dos rótulos selecionados são combinados. O gráfico resultante exibe uma série temporal para cada combinação de valores dos rótulos. A ordem de especificação dos rótulos não importa. A captura de tela a seguir mostra um gráfico em que as série temporal são combinadas pelo user_labels.version e system_labels.machine_image:
Conforme mostrado, o gráfico exibe uma série temporal para cada par de valores de rótulo. O fato de ter uma série temporal para cada combinação de rótulos significa que essa técnica pode criar mais dados do que você pode colocar em uma um único gráfico.
Mostrar todas série temporal
Para mostrar todas as série temporal, no elemento Agregação, faça o seguinte: defina o primeiro menu como Não agregado e o segundo como Nenhum.
Alinhar dados
O alinhamento é o processo de conversão de dados de séries temporais recebidos pelo Monitoring em uma nova série temporal que tem pontos de dados em intervalos fixos. O processo de alinhamento consiste em coletar todos os pontos de dados recebidos em um período fixo, aplicar uma função para combinar esses pontos de dados e atribuir um carimbo de data/hora ao resultado. Essa função pode calcular a média de todas as amostras ou extrair o máximo de todas as amostras.
Definir intervalo de alinhamento
Para especificar o período fixo de combinação dos pontos, Clique em add Adicionar elemento de consulta no painel de consulta. selecione Intervalo mínimo e preencha a caixa de diálogo.
Por exemplo, considere uma métrica com um período de amostragem de um minuto. Se um gráfico
for configurado para exibir uma hora de dados, ele poderá exibir todos os 60 pontos de
dados. Se o campo Intervalo mínimo estiver definido como 10 minutes
, os
o gráfico mostra seis pontos de dados. No entanto, se você configurar o gráfico para exibir
de uma semana de dados, então haverá muitos pontos a serem exibidos no gráfico para que o
o intervalo em que os pontos são combinados é modificado automaticamente.
Neste exemplo, o intervalo modificado é de uma hora.
A captura de tela a seguir ilustra a utilização da CPU das
instâncias de VM do Compute Engine em um projeto específico do Google Cloud.
Nessa imagem, o campo Intervalo mínimo está definido como 1 minute
:
Para fins de comparação, a captura de tela a seguir ilustra o efeito de mudar
o intervalo de 1 minute
a 5 minutes
:
Ao aumentar o período, o gráfico resultante tem menos pontos, diminuindo de 60 pontos por série temporal para 10 pontos por série temporal. Ao aumentar o Intervalo mínimo, mais pontos são combinados, o que tem uma suavização nos dados plotados.
Definir função de alinhamento
Quando você seleciona a função para agregação, o Cloud Monitoring seleciona a função de alinhamento para você. O Cloud Monitoring determina função de alinhamento com base no tipo de métrica selecionado e na sua escolha para a função de agregação. No entanto, é possível especificar uma função de alinhamento e substituir a escolha feita pelo Cloud Monitoring.
Para especificar a função de alinhamento, faça o seguinte:
- No elemento Agregação, abra o primeiro menu e selecione Configure o alinhador. A função de alinhamento e Os elementos de agrupamento foram adicionados.
- Expanda o elemento de função de alinhamento e faça uma seleção.
A maioria das funções de alinhamento com suporte realiza funções matemáticas, algumas realizam ações mais complicadas:
next old: para manter apenas a amostra mais recente em um alinhamento período, selecione mais antigo. Essa função é normalmente usada com verificações de tempo de atividade e é uma boa opção quando você se preocupa apenas com os .
Esta função é válida apenas para métricas de medidor.
percentile: para exibir uma métrica de distribuição em um tipo de gráfico de linha, gráfico de área empilhadas ou gráfico de barras empilhadas, você precisa selecionar qual percentil na distribuição será exibida. Uma forma de especificar esse percentil é selecionar uma função de percentil. É possível selecionar os 5º, 50º, 95º e 99º percentis. O ponto de dados alinhado é determinado pelo cálculo do percentil especificado usando todos os pontos de dados no período de alinhamento.
Esta função é válida somente para métricas de medidor e delta quando ter um tipo de dados de distribuição.
delta: para converter uma métrica cumulativa ou uma métrica delta em uma métrica delta métrica com uma amostra por período de alinhamento, use esta função. A interpolação de dados pode ocorrer quando você usa essa função. Para conferir um exemplo, consulte Tipos, tipos e conversões.
Essa função é válida somente para métricas cumulativas e delta.
taxa: para converter uma métrica cumulativa ou delta em uma métrica de medidor, use essa função. Se você escolher essa função, poderá pensar na série temporal sendo transformado como se fosse com uma função delta e, depois, dividido o período de alinhamento. Por exemplo, se a unidade da série temporal original é MiB e a unidade do período de alinhamento é o segundo, então o gráfico tem uma unidade de MiB por segundo. Para mais informações, consulte Tipos, tipos e conversões.
Essa função é válida somente para métricas cumulativas e delta.
Para mais informações
sobre as funções de alinhamento disponíveis,
consulte Aligner
na referência da API.
Agregação secundária
Quando você tem várias séries temporais que já representam agregações, é possível reduzir todas as séries temporais no gráfico para uma única série temporal escolhendo um Agregador secundário. Por exemplo, se você agrupar os dados por zona, o gráfico mostrará uma série temporal para cada zona. Para criar um gráfico com uma única série temporal, use os campos de agregação secundários.
Para alguns tipos de métricas, você tem a opção de transformar os dados. Se esse estará disponível. Se você definir o campo Transform para um valor diferente do que None, todos os outros campos serão as configurações secundárias de agregação.
Quando os campos de agregação secundários forem configuráveis, para o seguinte:
- Clique em add Adicionar elemento de consulta. e selecione Agregação secundária.
- Configure o elemento de Agregação secundária.
A seguir
- Analisar os dados em gráficos
- Visão geral das métricas definidas pelo usuário
- Configurar o nome de uma coluna de legenda
- Definir opções de exibição do gráfico