Como usar painéis e gráficos

Os painéis são uma maneira de visualizar e analisar dados de métricas importantes para você.

O Cloud Monitoring fornece painéis predefinidos para os serviços do Google Cloud que você usa. Esses painéis não requerem esforço de instalação ou configuração.

Também é possível criar painéis personalizados para exibir o conteúdo selecionado. Ao projetar um painel personalizado, você tem a opção de começar com um painel vazio e adicionar apenas os widgets de interesse, ou instalar uma configuração de painel que é armazenada no GitHub e, em seguida, modificar isso de acordo com as suas necessidades. É possível criar painéis personalizados usando o Console do Google Cloud ou o endpoint Dashboard na API Cloud Monitoring.

Esta página descreve os itens a seguir:

  • O que pode ser exibido em um painel.
  • As cotas e limites aplicáveis aos painéis.
  • A autorização necessária para criar e modificar painéis.
  • Como melhorar o desempenho de gráficos e painéis.

Para informações sobre como criar e gerenciar painéis, consulte as seguintes páginas:

Widgets do painel

Nesta seção, você vê exemplos dos widgets que podem ser adicionados a um painel personalizado.

  • Se você usa a API Cloud Monitoring, pode criar e modificar todos os tipos de widgets.
  • Se você usa o Console do Google Cloud, há dois editores de painel disponíveis: Clássico e Visualizar. Os dois editores podem exibir todos os tipos de widget. Os editores podem ser usados para criar e configurar gráficos de linhas, gráficos de área, gráficos de barras e gráficos de mapa de calor. Para criar ou editar um medidor, uma visão geral ou um widget de texto, é preciso usar o editor de visualização.

    O editor clássico exibe widgets em uma grade. O editor de visualização é compatível com o layout de grade. No entanto, ele também é compatível com o layout de mosaico, que permite controlar o tamanho e o posicionamento dos widgets.

Gráfico de linhas

Para exibir sua série temporal com a maior resolução possível, use um gráfico de linhas ou de área em área empilhada. Por padrão, os gráficos de linha atribuem uma cor exclusiva a cada série temporal exibida. No entanto, é possível configurar esses gráficos para mostrar apenas outliers, exibir medidas estatísticas, como "50º percentil", ou exibir os dados no modo X-ray. Para mais informações sobre essas opções, consulte Como definir opções de exibição.

A captura de tela a seguir é um exemplo de gráfico de linhas no modo de cor:

Exemplo de um gráfico de linha no modo de cor.

Gráfico de áreas empilhadas

Para exibir a soma de todas as séries temporais, com a contribuição de cada série temporal ilustrada por uma faixa de cor exclusiva, use um gráfico de áreas empilhadas. Você pode configurar esses gráficos para exibir outliers. Ao colocar o ponteiro do mouse no gráfico, é possível ver o quanto uma série temporal específica contribui para a soma.

A captura de tela a seguir é um exemplo de gráfico de área empilhado no modo de cor.

Exemplo de um gráfico de área empilhado no modo de cor.

Gráfico de barras empilhadas

Para exibir dados com amostras pouco frequentes, como as métricas de cota que têm uma amostra por dia, use os gráficos de barras empilhadas. Esses gráficos têm resolução mais baixa do que os gráficos de linhas e de área empilhados. Por padrão, cada série temporal recebe uma cor exclusiva. No entanto, você pode configurar esses gráficos para exibir outliers.

A captura de tela a seguir é um exemplo de gráfico de barras empilhado no modo de cor:

Exemplo de um gráfico de barras empilhado no modo de cores.

Gráfico do mapa de calor

Para exibir métricas com um valor de distribuição, use gráficos de mapa de calor. Os mapas de calor usam cores para representar os valores na distribuição. Com os mapas de calor, é possível sobrepor linhas de percentil, e é possível configurar esses gráficos para exibir apenas outliers.

A imagem a seguir exibe as latências de solicitação da API Cloud Spanner em um projeto do Google Cloud:

Exemplo de um gráfico de mapa de calor.

Para ver uma discussão aprofundada sobre esses gráficos, consulte Como gerar gráficos de métricas de distribuição.

Medidores

Se você quiser visualizar a medida mais recente em comparação com um conjunto de limites codificado por cores, crie um medidor. Conforme ilustrado na captura de tela a seguir, um medidor exibe duas linhas: um arco externo fino que exibe a gama de valores possíveis e usa cores para indicar zonas de alerta e perigos, e um arco interno grosseiro que indica o valor atual:

Exemplo de um painel com um medidor.

Um medidor exibe o valor atual como um número e exibe uma linha grossa abaixo dos dois arcos. A cor do segundo plano e da linha grossa indica se o valor atual está na zona boa, de aviso ou perigo. Neste exemplo, o valor atual está na zona boa, de modo que a linha é verde e o plano de fundo é branco.

Visões gerais

Se você quiser visualizar a medição mais recente em comparação com um conjunto de limites, juntamente com um histórico de medições recentes, crie uma visão geral. Por exemplo, a captura de tela a seguir ilustra uma visão geral configurada para exibição como SPARK_LINE:

Exemplo de um painel de controle com uma visão geral.

As visões gerais exibem o valor atual como um número. Se você selecionar uma visualização SPARK_LINE, esses gráficos também incluirão uma linha fina que mostra o histórico das medições recentes e uma linha grossa. A cor do segundo plano e das duas linhas indica se o valor atual está na zona de boa, de aviso ou perigo. Neste exemplo, o valor atual está na zona boa, de modo que as linhas são verdes e o plano de fundo é branco.

Caixas de texto

As caixas de texto foram criadas para permitir que você adicione informações ao painel. O conteúdo pode ser informações sobre o painel, links para recursos relevantes ou o que fazer em diferentes situações. Por exemplo, a captura de tela a seguir ilustra uma caixa de texto.

Exemplo de um painel com um widget de texto.

As caixas de texto podem incluir links para recursos externos.

Cotas e limites

Os limites a seguir se aplicam a painéis e gráficos:

Category Valor
Painéis por espaço de trabalho 1.000
Gráficos em um painel 25
Linhas em um gráfico 300

autorização

Esta seção descreve os papéis ou permissões necessários para criar um painel ou adicionar gráficos a um painel. Para informações detalhadas sobre o gerenciamento de identidade e acesso (IAM, na sigla em inglês) do Cloud Monitoring, consulte Controle de acesso.

Cada papel do IAM tem um ID e um nome. Os IDs de papel têm o formato roles/monitoring.editor e são transmitidos como argumentos para a ferramenta de linha de comando gcloud ao configurar o controle de acesso. Para mais informações, consulte Como conceder, alterar e revogar acesso. Os nomes de papéis, como "Editor do Monitoring", são exibidos pelo Console do Cloud.

Papéis obrigatórios do Console do Cloud

Para criar um painel ou adicionar gráficos a um painel, o nome do papel do IAM para o projeto do Google Cloud precisa ser um dos seguintes:

  • Editor do Monitoring
  • Administrador do Monitoring
  • Proprietário do projeto

Para ver uma lista de papéis e as permissões associadas, consulte Papéis.

Permissões de API necessárias

Para usar a API do Cloud Monitoring para criar um painel ou adicionar gráficos a um painel, o ID do papel do IAM para o projeto do Google Cloud precisa ser um dos seguintes:

  • roles/monitoring.dashboardEditor: este ID de papel concede as permissões mínimas necessárias para criar um painel ou adicionar gráficos a um painel. Para mais detalhes sobre esse papel, consulte Papéis de painel predefinidos.
  • role/monitoring.editor
  • role/monitoring.admin
  • role/owner

Para identificar a permissão necessária para um método específico da API Cloud Monitoring, consulte Permissões da API Cloud Monitoring. Para ver uma lista de papéis e as permissões associadas, consulte Papéis.

Como determinar o papel

Para determinar o papel de um projeto usando o Console do Cloud, faça o seguinte:

  1. Abra o Console do Cloud e selecione o projeto do Google Cloud:

    Acessar o Console do Cloud

  2. Para visualizar o papel, clique em IAM e administrador. O papel está na mesma linha que o nome de usuário.

Para determinar as permissões no nível da organização, entre em contato com o administrador da organização.

Desempenho de painéis e gráficos

O desempenho de um gráfico é sensível ao número de séries temporais a serem exibidas. O número de séries temporais depende, em parte, da estrutura do tipo de métrica e do tipo de recurso monitorado associado à série temporal. Cada um desses tipos tem vários rótulos. A lista de métricas e a lista de recursos monitorados incluem os rótulos de cada métrica e tipo de recurso monitorado.

Há uma série temporal para cada combinação exclusiva de valores para o conjunto de rótulos. O número de combinações possíveis é chamado de cardinalidade. Para mais informações sobre rótulos, valores e cardinalidade, consulte Cardinalidade.

Se você encontrar problemas de desempenho ao exibir dados de métricas, geralmente será possível atenuar os problemas usando uma dessas técnicas:

  • Remover informações com a filtragem.
  • Recolher informações relacionadas combinando séries temporais.
  • Ter como foco dados incomuns com o modo outlier.
  • Reduzir a cardinalidade de uma métrica personalizada reduzindo o número de rótulos ou o intervalo de valores possíveis para um rótulo.