Neste documento, descrevemos como adicionar gráficos, tabelas, indicadores e scorecards a um painel personalizado usando o console do Google Cloud. Você pode mostrar dados de métricas em um intervalo de tempo adicionando um gráfico de linhas um gráfico de área empilhada, de barras ou de mapa de calor. Se você só for interessadas nas medições mais recentes, adicione uma tabela, um gráfico de pizza um medidor ou uma visão geral. Os medidores e as visões gerais mudam de cor com base na comparação do valor mais recente com os limites de alerta e de perigo.
As visualizações que você pode adicionar aos painéis coletivamente chamados de widgets. Para informações gerais sobre os diferentes tipos de widgets, consulte Visão geral dos painéis.
Gráficos, tabelas, medidores e visões gerais em painéis personalizados podem exibe qualquer tipo de métrica que tenha valor numérico ou de distribuição do Google, incluindo métricas definidas pelo usuário e métricas com base em registros. Os gráficos não podem representar dados do tipo string.
Neste documento, descrevemos como adicionar gráficos, tabelas, medidores e visões gerais a um painel personalizado que exibe dados de séries temporais. Para obter informações sobre como adicionar outros tipos de widgets aos seus painéis, consulte a documentos a seguir:
- Incidentes e políticas de alertas
- Registros e erros
- Texto descritivo
- Objetivos de nível de serviço (SLOs) para um conjunto de serviços
- Gráficos que mostram os resultados de uma consulta da Análise de dados de registros
Para mais informações sobre a API Cloud Monitoring, consulte Gerenciar painéis por API.
Antes de começar
-
Para ter as permissões necessárias para criar e modificar painéis personalizados usando o console do Google Cloud, peça ao administrador para conceder a você o papel do IAM de Editor do Monitoring (
roles/monitoring.editor
) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.
Para mais informações sobre papéis, consulte Controle o acesso com o Identity and Access Management.
É possível incluir até 40 widgets no painel.
Para adicionar um widget a um painel, você pode: selecione a visualização e configure o widget ou selecione o tipo de dados e, em seguida, configurar a visualização.
Por exemplo, para adicionar uma tabela que mostre a utilização da CPU das instâncias de VM a um painel, faça o seguinte:
- Selecione o widget Tabela e configure-o para mostrar a utilização da CPU das instâncias de VM.
- Selecione o tipo de dados Metric, configure o widget para exibir as utilização da CPU das instâncias de VM. Em seguida, altere o tipo de widget para Tabela.
As instruções nesta página presumem que você selecione o tipo de dados primeiro, e configure como esses dados são exibidos.
Adicionar gráficos e tabelas a um painel
Nesta seção, descrevemos como configurar gráficos e tabelas usando a Console do Google Cloud:
Os gráficos mostram dados ao longo do tempo e há quatro estilos disponíveis: Linha, Área empilhada, Barra empilhada e Mapa de calor. Um único gráfico pode mostrar vários tipos de métricas. Por exemplo, você pode configurar um gráfico para mostrar os bytes de disco lidos e gravados nas instâncias.
Depois de configurar um gráfico, é possível mude o tipo de widget. Para obter informações sobre por que você pode selecionar um estilo específico, consulte Gráficos que mostram dados ao longo do tempo.
Para saber como usar a API Cloud Monitoring para configurar um gráfico, consulte Painel com um widget
XyChart
.As tabelas contêm uma linha para cada combinação de valores de rótulo. Quando as tabelas mostram dados de vários tipos de métricas, cada linha contém um resultado de todas as consultas, quando essa mesclagem é possível.
Há dois estilos de tabelas. Tabela exibe um valor numérico, como "25%". O widget Lista de principais é exibido o valor e um indicador visual do valor comparado com o intervalo de valores possíveis.
É possível alterar o estilo entre tabelas e gráficos, configurar nomes de colunas da tabela e adicionar limites que alteram a cor da nas células da tabela. Para mais informações e um exemplo, consulte Exibir dados em formato tabular em um painel.
Para mais informações sobre como usar a API Cloud Monitoring para configurar uma tabela, consulte Painel com um widget
TimeSeriesTable
.
Para adicionar um gráfico ou uma tabela a um painel, 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, encontre o painel na lista de todos os painéis e selecione o nome dele.
Na barra de ferramentas, clique em add Adicionar widget.
Na caixa de diálogo Adicionar widget, selecione leaderboard Métrica.
Especifique os dados a serem exibidos 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:
Interface orientada por menus
Selecione os dados da série temporal que você quer ver:
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 a filter_list barra de filtro. Por exemplo, se você digitar
util
, restringir o menu a mostra entradas que incluemutil
. As entradas são mostradas quando passam em um teste "contains" indiferente a maiúsculas.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.
Por exemplo, você pode fazer as seguintes escolhas:
- No menu Recursos ativos, selecione Instância de VM.
- No menu Categorias de métrica ativas, selecione uptime_check.
- No menu Métricas ativas, selecione Latência da solicitação.
- Clique em Aplicar.
Opcional: para especificar um subconjunto de dados que serão exibidos, no elemento Filtro, selecione Adicionar filtro e para completar a caixa de diálogo. Por exemplo, é possível conferir os dados de uma zona aplicando um filtro. É possível adicionar vários filtros. Para mais informações, consulte Filtrar os dados do gráfico.
Para mais informações, consulte Selecionar os dados para o gráfico.
Combine e alinhe séries temporais:
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éries temporais, no elemento Agregação, faça o seguinte:
Expanda 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 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 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.
Opcional: para mostrar apenas a série temporal com os valores mais altos ou mais baixos, use o elemento Classificar e limitar.
MQL
- 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 os documentos a seguir:
PromQL
- 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 da 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.
Filtro de monitoramento
-
No elemento Métrica, clique em help_outline Ajuda e, em seguida, selecione Modo de filtro direto.
Os elementos Metric e Filter são excluídos, e um elemento Filters que permite inserir texto, é criada.
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 campo do elemento Filtros.
- Insira um filtro do Monitoring no campo do elemento Filters.
Combinar e alinhar 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éries temporais, no elemento Agregação, faça o seguinte:
Expanda 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 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 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.
Opcional: configure o gráfico ou a tabela para mostrar vários tipos de métricas.
Interface orientada por menus
Selecione Adicionar consulta. Uma nova consulta é adicionada. Por exemplo, uma consulta com o o marcador B seja adicionado.
Para a nova consulta, selecione um tipo de recurso e de métrica no elemento Métrica. Também é possível adicionar filtros, combinar séries temporais, ordenar e limitar o número de séries temporais exibidas.
A captura de tela a seguir ilustra a exibição do Metrics Explorer quando há dois tipos de métrica no gráfico:
MQL
Incompatível.
PromQL
Incompatível.
Filtro de monitoramento
Incompatível.
Opcional: configure o gráfico para mostrar uma proporção de tipos de métricas.
Interface orientada por menus
- Configure o gráfico para mostrar dois tipos de métricas com o mesmo
tipo. Por exemplo, ambas são métricas
GAUGE
. - Verifique se o valor do campo Intervalo mínimo o mesmo para os dois tipos de métricas. Para acessar esse campo, clique em add Adicionar elemento de consulta e selecione Intervalo mínimo.
-
Atualize os campos de agregação.
Recomendamos que os rótulos do tipo de métrica do denominador correspondam aos valores definidos para o tipo de métrica do numerador. Por exemplo: selecione o rótulo
zone
para o numerador e o denominador.Não é necessário usar o mesmo conjunto de rótulos para os dois tipos de métrica. No entanto, só é possível selecionar rótulos comuns aos dois tipos.
-
Na barra de ferramentas do painel de consulta, selecione Criar proporção e, em seguida, para completar a caixa de diálogo.
Depois de criar a proporção, três consultas são mostradas:
- Proporção A/B identifica a consulta de proporção.
- A identifica a consulta do numerador.
- B identifica a consulta do denominador.
O exemplo a seguir ilustra uma razão que compara a soma de o total de bytes gravados no disco por zona e no número total de bytes gravado no disco:
-
Opcional: para alternar as métricas de numerador e denominador, no elemento Ratio, abra o menu e faça uma seleção.
MQL
- 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 os documentos a seguir:
PromQL
- 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.
Filtro de monitoramento
Incompatível.
- Configure o gráfico para mostrar dois tipos de métricas com o mesmo
tipo. Por exemplo, ambas são métricas
Opcional: para mudar a visualização, no painel Exibição, faça o seguinte: Clique em arrow_drop_down Tipo de widget e faça uma seleção.
O menu Tipo de widget lista todos os tipos de widget que podem exibir a mesmo tipo de dados. No entanto, alguns widgets podem não estar ativados. Por exemplo, considere um gráfico em um painel configurado para mostrar um tipo de métrica. O gráfico de linhas mostra várias séries temporais, e cada valor medido é um número duplo:
Tabela, Gráfico de pizza, Gráfico de linhas, Gráfico de barras empilhadas e Os widgets do gráfico de área empilhada são listados como Compatível. Você pode selecionar qualquer um desses tipos.
Os widgets Visão geral e Medidor são listados como Compatível com ajustes porque podem exibir apenas uma série temporal. Para ativar esses tipos de widgets, modifique a configuração de agrupamento.
O widget Heatmap está desativado porque só pode mostrar dados com valor de distribuição.
O painel de registros não está listado porque o painel de registros não pode exibir dados de série temporal.
Opcional: para mudar a forma como um gráfico ou tabela mostra os dados selecionados, use as opções no painel Exibir:
Opções de gráfico:
- Menu Modo de análise: Selecione entre gráficos de linhas, raio-x e estática.
- Menu Compare to Past: sobrepõe os dados atuais aos dados anteriores.
- Menu Linha de limite: adicionar um limite de referência.
- Menu Alias da legenda: 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 de tabela:
- Menu Opção de valor: selecione entre o valor mais recente e um valor agregado.
- Menu Colunas visíveis: Selecione as colunas que serão exibidas.
- Menu Formatação de colunas: Configurar nomes de colunas, alinhamento de dados em uma coluna, unidades e se as células são codificadas por cores.
- Menu Visualização de métrica: Selecione se o valor será mostrado sozinho ou em relação a um intervalo de valores.
- Menu Alias da legenda: configure o nome de uma coluna de legenda.
Para aplicar as alterações ao painel, na barra de ferramentas, Clique em Aplicar. Para descartar as mudanças, clique em Cancelar.
Para salvar seu painel modificado, clique em Salvar na barra de ferramentas.
Mostrar apenas os dados mais recentes
O Monitoring oferece várias maneiras de visualizar apenas as medições mais recentes, em vez de visualizar o histórico de medições:
Para exibir graficamente o valor mais recente de cada série temporal, em que cada valor é mostrado como uma fração da soma de todos os valores, adicionar um gráfico de pizza. É possível configurar esses gráficos para mostrar o valor total.
Para exibir o valor mais recente de cada série temporal em uma tabela, adicionar uma tabela. É possível limitar o número de linhas em uma tabela e configurar as linhas de uma tabela para mostrar um valor em comparação com um intervalo de valores.
Obter uma indicação verde, âmbar ou vermelha do valor mais recente em comparação a um conjunto de limites, adicione um medidor ou uma visão geral ao painel.
Representar graficamente os dados mais recentes com um gráfico de pizza
Para visualizar os dados mais recentes como uma fração do total, adicione um gráfico de pizza. Assim como as tabelas, um gráfico de pizza pode mostrar qualquer tipo de métrica que tenha um valor numérico e pode mostrar percentis para métricas de valor de distribuição. Cada série temporal contribui uma fatia à torta.
A captura de tela a seguir ilustra um painel que exibe a utilização de CPU das instâncias de máquina virtual de um widget de gráfico de pizza:
Para saber como adicionar gráficos de pizza a um painel, consulte estes documentos:
Console do Google Cloud: consulte a seção chamada Adicione gráficos e tabelas a este documento.
- Depois de selecionar os dados para o gráfico, no painel Exibição, defina o campo Tipo de widget como Gráfico de pizza.
- Para mostrar o valor total, defina o campo Tipo de gráfico como Donut.
API Cloud Monitoring: consulte Painel com um widget
PieChart
.
Exibir os dados mais recentes em forma de tabela
Para conferir os dados mais recentes em formato tabular, adicione uma tabela. As tabelas podem mostrar dados numéricos. Por exemplo, eles podem mostrar um ou mais tipos de métrica ou percentis para métricas de valor de distribuição.
Quando uma tabela mostra um tipo de métrica, cada linha na tabela corresponde a uma série temporal. Uma coluna de tabela que mostra um valor numérico, que é o valor mais recente ou um valor agregado. As outras colunas exibir os rótulos na série temporal. Quando uma tabela exibir vários tipos de métrica, os dados de ambos os tipos serão mostrados na mesma linha, quando possível. Para mais informações, consulte Como as tabelas mesclam vários tipos de métrica.
Há dois widgets que mostram dados em forma tabular: Lista principal e Tabela. A principal diferença entre esses dois widgets é que o widget Top List classifica a ordem das linhas e mostra o valor com um indicador visual do valor em comparação com o intervalo de valores possíveis. Como o widget Lista de itens principais fornece uma representação visual do valor, não é possível atribuir um código de cores à célula com base na comparação do valor com um limite.
Para informações sobre como configurar tabelas, consulte as seguintes seções:
Para informações gerais sobre como selecionar métricas e definir a agregação , consulte as seção Adicionar gráficos e tabelas neste documento.
Depois de selecionar os dados para o gráfico, no painel Exibição, defina o campo Tipo de widget como Tabela ou Lista de itens.
Para opções de configuração, consulte as seguintes seções deste documento:
Para saber como classificar e filtrar sua tabela, consulte a seção Classificar e filtrar tabelas deste documento.
Para mais informações sobre como usar a API para configurar uma tabela, consulte Painel com um widget
TimeSeriesTable
.
A captura de tela a seguir ilustra duas tabelas. A primeira tabela mostra dois tipos de métrica: o número de bytes lidos das instâncias e o número de bytes gravados nas instâncias. Um valor agregado é mostrado junto com uma barra de referência. A segunda tabela mostra o último valor de um tipo de métrica, e a coluna de valor foi configurada para codificar a célula por cores com base em como o valor se compara a um limite:
Mostrar o valor mais recente ou agregado
Por padrão, as tabelas mostram o valor mais recente. No entanto, uma tabela pode mostrar um valor calculado no período selecionado para o painel.
Para selecionar entre o valor mais recente e o valor agregado, use o campo Opção de valor.
Se você mostrar o valor agregado, para cada série temporal, os dados no período selecionado pelo seu painel serão combinados pela função de alinhamento. A função de alinhamento é uma das opções de agregação e não é mostrada por padrão. Para conferir a função de alinhamento, expanda o elemento Agregação e, no primeiro elemento, selecione Configurar alinhador. Depois que você fizer essa seleção, o elemento de Agregação será substituído por um elemento Grouping e um menu chamado Alignment function.
Selecione as colunas a serem exibidas
Por padrão, uma coluna na tabela mostra um valor numérico. Todos os outros correspondem a um rótulo na série temporal. Para colunas baseadas em rótulos, o nome da coluna é derivado do rótulo.
Para configurar as colunas mostradas pela tabela, expanda a seção Colunas visíveis e faça suas seleções.
Configurar o formato da coluna
Para configurar uma coluna individual, no elemento Colunas, abra o menu Modificar coluna, selecione a coluna a ser modificada e faça uma das seguintes ações:
- Para definir o nome da coluna, use o campo Nome de exibição.
- Para definir o alinhamento dos dados na coluna, use o método format_align_left Alinhar à esquerda, format_align_center Alinhar ao centro e format_align_right Botões de alinhamento à direita.
- Para atribuir um código de cores à célula com base na comparação do valor numérico com um limite, defina os limites de alerta e de perigo.
- Se você criar consultas em PromQL, use o menu Unidade para definir as de unidades mostradas com os dados. As unidades são configuradas automaticamente quando você configura a consulta usando as seleções de menu.
Mostrar valor de referência
As tabelas podem exibir somente um valor ou podem exibir um valor relativo ao o intervalo de valores. Quando a opção de intervalo é selecionada, o valor é mostrado junto com uma barra azul, o comprimento da barra é proporcional à mostrado.
Para configurar se um valor referencial será mostrado, use a Visualização de métricas. .
Classificar e filtrar tabelas
É possível alterar a ordem das linhas na exibição da tabela e também filtrar o conteúdo da tabela para mostrar apenas linhas específicas. Essas configurações não são persistentes. Quando você sai da página do painel ou recarrega o painel, as opções de classificação e filtragem aplicadas são descartadas.
Você tem as seguintes opções de classificação e filtragem:
Para classificar a tabela por coluna, clique no cabeçalho da coluna.
Para alterar as colunas da tabela, clique em view_column Visualizar colunas, faça as modificações e clique em OK.
Para listar apenas linhas específicas, adicione um ou mais filtros. É possível adicionar vários filtros. Quando você não especifica o operador OR entre dois filtros, um AND lógico se une a esses filtros.
Para adicionar um filtro, clique em
Enter property name or value
, selecione uma propriedade no menu e insira um valor ou selecione-o no menu de valores. Por exemplo, se você filtrar a propriedadeName
e inserir o valordemo
, a tabela vai listar apenas as linhas em que o campoName
inclui o valordemo
.
Mostrar os dados mais recentes com indicação de aviso ou erro
Para conferir a medição mais recente em comparação com um conjunto de limites codificado por cores, adicione um medidor ou uma visão geral. Os medidores mostram apenas a medição mais recente, enquanto as visões gerais também mostram um histórico de medições recentes. A cor de fundo desses widgets também é codificada por cores. Quando o valor mais recente está dentro dos intervalos esperados, a cor do widget é branca. Quando o valor está em um intervalo de aviso, o widget fica âmbar. Da mesma forma, quando valor estiver em um intervalo de perigo, o widget ficará vermelho.
Os dois widgets mostram uma única série temporal. A captura de tela a seguir mostra um exemplo de um medidor quando a medição mais recente é menor que os limites de aviso e perigo:
O restante das informações nesta seção é destinado ao
console do Google Cloud. Para informações sobre como usar a API Cloud Monitoring,
consulte Painel com um Scorecard
básico.
Para adicionar um medidor ou visão geral a um painel, 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, encontre o painel na lista de todos os painéis e selecione o nome dele.
Na barra de ferramentas, clique em add Adicionar widget.
Na caixa de diálogo Adicionar widget, selecione leaderboard Métrica.
Especifique os dados a serem exibidos 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:
Interface orientada por menus
Selecione os dados da série temporal que você quer ver:
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 a filter_list barra de filtro. Por exemplo, se você digitar
util
, restringir o menu a mostra entradas que incluemutil
. As entradas são mostradas quando passam em um teste "contains" indiferente a maiúsculas.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.
Por exemplo, você pode fazer as seguintes escolhas:
- No menu Recursos ativos, selecione Instância de VM.
- No menu Categorias de métrica ativas, selecione uptime_check.
- No menu Métricas ativas, selecione Latência da solicitação.
- Clique em Aplicar.
Opcional: para especificar um subconjunto de dados que serão exibidos, no elemento Filtro, selecione Adicionar filtro e para completar a caixa de diálogo. Por exemplo, você pode exibir dados para uma zona por aplicando um filtro. É possível adicionar vários filtros. Para mais informações, consulte Filtrar dados com gráfico.
Para mais informações, consulte Selecione os dados para o gráfico.
Combine as série temporal usando os campos de agregação:
- Abra o primeiro menu e selecione a função que combina a série temporal.
- Expanda o segundo menu e verifique se nenhum rótulo está selecionado.
MQL
- 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. Você precisa garantir que a agregação são configurados para combinar todas série temporal. Por exemplo, para criar um gráfico utilização da CPU das instâncias de VM no projeto do Google Cloud, use o seguinte consulta:
fetch gce_instance | metric 'compute.googleapis.com/instance/cpu/utilization' | group_by 1m, [value_utilization_mean: mean(value.utilization)] | every 1m | group_by [], [value_utilization_mean_mean: mean(value_utilization_mean)]
Para mais informações sobre o MQL, consulte estes documentos:
PromQL
- 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 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.
Filtro de monitoramento
-
No elemento Métrica, clique em help_outline Ajuda e, em seguida, selecione Modo de filtro direto.
Os elementos Metric e Filter são excluídos, e um elemento Filters que permite inserir texto, é criada.
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 campo do elemento Filtros.
- Insira um filtro do Monitoring.
Combine as séries temporais usando os campos Agregação:
- Abra o primeiro menu e selecione a função que combina a série temporal.
- Expanda o segundo menu e verifique se nenhum rótulo está selecionado.
No painel Exibição, configure o medidor ou a visão geral:
Clique em arrow_drop_down Tipo de widget. e selecione Medidor ou Quadro de visão geral.
Para widgets de medidor, clique em arrow_drop_down Intervalo do medidor, e definir os valores mínimo e máximo. Quando um medidor mostrar uma porcentagem, defina esses valores como 0 e 1, respectivamente.
Clique em arrow_drop_down Limite do medidor e defina os limites de alerta e de perigo. Os campos de limite que estão vazios não são usados.
Para o medidor mostrado anteriormente, dois limites foram definidos. Valores maiores que 0,9 estão no intervalo de perigo. Valores maiores que 0,7, mas não no intervalo de perigo, estão no intervalo de aviso.
Para visões gerais, clique em arrow_drop_down Visualização do gráfico Spark. Expanda o menu de opções e selecione o estilo de exibição.
Para aplicar as alterações ao painel, na barra de ferramentas, Clique em Aplicar. Para descartar as mudanças, clique em Cancelar.
Para salvar seu painel modificado, clique em Salvar na barra de ferramentas.
Como as tabelas mesclam dados de vários tipos de métricas
Se uma tabela consultar vários tipos de métricas, o console do Google Cloud vai realizar uma operação de mesclagem examinando os rótulos anexados aos dados agregados para os dois tipos de métrica. Quando os rótulos comuns às duas consultas permitem que o monitoramento determine um identificador de linha exclusivo, uma única linha na tabela mostra o valor mais recente de cada consulta. Caso contrário, haverá uma linha para cada série temporal.
Por exemplo, suponha que uma tabela consulte dois tipos de métricas diferentes. Vamos ligar
essas consultas A
e B
. Confira a seguir como os resultados da consulta
são mesclados:
Se o resultado de ambas as consultas tiver o mesmo conjunto de rótulos, a mesclagem será sempre dá certo. Cada linha contém o valor mais recente de cada consulta. Se uma consulta não retornar um valor para uma combinação específica de identificadores, a célula da tabela vai ficar vazia.
Por exemplo, suponha que as duas consultas tenham um rótulo
zone
. A tabela contém uma linha para cada zona informada pelas consultasA
eB
. No entanto, se a consultaA
retornar uma série temporal com a zonaus-central1-a
, mas a consultaB
não retornar uma série temporal com esse valor, o valor mais recente da consultaB
será mostrado como uma célula vazia.Se os rótulos dos resultados de uma consulta forem um subconjunto dos rótulos dos resultados da outra consulta, os resultados serão mesclados.
Por exemplo, suponha que os resultados das duas consultas incluam rótulos para
location
ecluster_name
, mas que os resultados da consultaA
também incluam um rótulo paramemory_type
. Nesse caso, cada linha corresponde em uma série temporal com valores exclusivos para os três rótulos.Em qualquer linha, o valor mostrado para a consulta
B
é o valor da série temporal que corresponde aos dois rótulos comuns,location
ecluster_name
, e o terceiro é ignorado.Se os resultados das duas consultas não compartilharem nenhum rótulo ou se compartilham alguns rótulos, mas não o suficiente para formar um identificador de linha exclusivo, os resultados não poderão ser mesclados. A tabela lista uma linha para cada série temporal retornada pela consulta
A
ou pela consultaB
, e algumas células da tabela estão vazias.Por exemplo, suponha que os rótulos da consulta
A
sejamlocation
ememory_type
, e que os rótulos da consultaB
sejamlocation
ecluster_name
. Embora o rótulolocation
seja comum, ele não é suficiente para criar um identificador de linha exclusivo.Conforme descrito na próxima seção, talvez seja possível resolver uma mesclagem falha.
Resolver falha de mesclagem
Ao criar gráficos com várias métricas, pode ocorrer uma falha na mesclagem
porque as métricas usam nomes de rótulos diferentes para o mesmo campo.
Uma maneira de resolver essa falha é converter uma consulta em PromQL
e, em seguida, usar a função label_replace()
para
converter os nomes de rótulo usados por um tipo de métrica para corresponder aos do
outro tipo de métrica.
Por exemplo, considere uma tabela configurada com duas consultas:
A
: consulta oPrometheus/kube_pod_container_status_ready/gauge
tipo de métrica. As opções de agregação são definidas para somar séries temporais depois de agrupar os dados pelo rótulocluster
.B
: consulta okubernetes.io/container/memory/request_bytes
tipo de métrica. As opções de agregação são definidas para somar séries temporais depois de agrupar os dados pelo rótulocluster_name
.
A tabela não pode mesclar os resultados porque os resultados das consultas A
e B
têm rótulos diferentes.
Para resolver a falha, converta a consulta A
em PromQL e substitua cluster
por cluster_name
. O exemplo a seguir ilustra a consulta modificada:
sum by (cluster_name)(
label_replace(
avg_over_time(kube_pod_container_status_ready[${__interval}]),
"cluster_name", "$1", "cluster", "(.*)"
)
)
Com as alterações, ambas as consultas produzirão o mesmo conjunto de rótulos.
Portanto, cada linha na tabela lista um nome de cluster, o valor da consulta A
e o valor da consulta B
.
Para mais informações sobre como usar PromQL, consulte PromQL no Cloud Monitoring.
A seguir
Também é possível adicionar os seguintes widgets aos seus painéis personalizados:
- Mostrar políticas de alertas e incidentes
- Entradas de registro
- Texto descritivo
- Objetivos de nível de serviço (SLOs) para um conjunto de serviços
Para saber como analisar dados em gráficos e filtrar seus painéis, consulte os seguintes documentos: