Criar e gerenciar painéis personalizados

Neste documento, descrevemos como criar e gerenciar painéis personalizados usando o console do Google Cloud. Os painéis personalizados permitem exibir informações do seu interesse, organizadas de maneira útil. Por exemplo, é possível criar um painel para mostrar os registros, as métricas de desempenho e as políticas de alerta de máquinas virtuais (VM) no ambiente de produção. Depois de criar um painel personalizado, você também pode copiá-lo, modificá-lo e compartilhá-lo. Para criar painéis, use o console do Google Cloud, a API Cloud Monitoring ou a Google Cloud CLI.

Neste documento, descrevemos como criar e gerenciar painéis personalizados usando o console do Google Cloud:

• Para mais informações sobre a API e a CLI do Google Cloud, consulte Criar e gerenciar painéis por API.
• Para informações sobre os painéis Google Cloud específicos do serviço, consulte Visualizar Google Cloud painéis.

Sobre os painéis personalizados

Os painéis personalizados são compatíveis com vários tipos de widgets, para que você possa escolher a melhor maneira de mostrar seus dados. Por padrão, os painéis mostram todos os dados de métricas disponíveis no projeto do Google Cloud. Se você configurar um escopo de métricas, o painel poderá mostrar dados de métricas de vários projetos do Google Cloud.

Um painel personalizado pode mostrar o seguinte:

• Gráficos e indicadores.
• Registre entradas de vários projetos ou visualizações de registro do Google Cloud.
• Gráficos para políticas de alertas.
• Incidentes.
• Objetivos de nível de serviço (SLOs).
• Texto.

É possível melhorar o tempo de carregamento ou a usabilidade de um painel agrupando widgets. Por exemplo, você pode adicionar seções a um painel. Como alternativa, você pode adicionar widgets a um contêiner expandido ou fechado.

Depois de criar um painel, você pode adicionar filtros, eventos ou rótulos:

• Os filtros em todo o painel são aplicados a todos ou alguns widgets no painel. Esses filtros podem ser úteis na solução de problemas. Por exemplo, é possível usar esses filtros para mostrar dados apenas de uma zona específica. Para mais informações, consulte Adicionar ou remover filtros.

• Os eventos, como a falha de um pod do Google Kubernetes Engine, podem ajudar a correlacionar dados de diferentes fontes ao resolver um problema. Para mais informações, consulte Mostrar eventos em um painel.

• Os rótulos ajudam a localizar dashboards com base no tipo de conteúdo que eles mostram. Por exemplo, é possível adicionar o rótulo prod a painéis que mostram informações sobre sistemas de produção. Da mesma forma, você pode adicionar o rótulo staging para indicar que o painel mostra informações sobre sistemas de preparação.

  Ao visualizar seus painéis, você pode selecionar um rótulo para filtrar a lista e mostrar apenas os painéis que contêm o rótulo selecionado.

Observação: por padrão, os painéis atualizam automaticamente a exibição quando novos dados estão disponíveis e salvam automaticamente as alterações de configuração. Para informações sobre como mudar essas configurações, consulte Desativar atualização de dados e Desativar o salvamento automático de alterações de configuração.

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 Controlar o acesso com o Identity and Access Management.

Adicionar um painel personalizado ao projeto

Há diferentes abordagens que podem ser usadas para adicionar um painel personalizado ao seu projeto do Google Cloud:

• Você pode criar um painel.
• Você pode copiar ou duplicar um painel.
• É possível copiar um painel de um projeto para outro.
• Você pode fazer upload ou instalar painéis de um local compartilhado.
• É possível importar um painel do Grafana.

Por exemplo, suponha que você tenha vários projetos do Google Cloud e queira que eles definam o mesmo painel personalizado. Para essa situação, crie o painel em um projeto e copie a definição para outros. Como alternativa, você pode fazer o download da definição do painel para seu sistema local e instalar essa definição em outros projetos do Google Cloud.

Crie um novo dashboard

Para criar um painel personalizado, faça o seguinte:

1. No console do Google Cloud, acesse a página  Painéis:

   Ir para Painéis

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

2. Na página Painéis, clique em Criar painel personalizado.

3. Para adicionar widgets ao painel, faça o seguinte:

   1. Na barra de ferramentas do painel, clique em  Adicionar widget.

   2. No painel Adicionar widget, selecione um widget para adicionar ao painel.

      Você pode selecionar um widget com base no tipo de dados a serem mostrados ou como você quer exibir os dados. Em todos os casos, um painel de configuração é aberto. Por exemplo, você pode selecionar o widget Métrica e definir a visualização como Área empilhada. Ou selecione o widget Área empilhada e, em seguida, a métrica.

   3. Configure o widget.

   4. Para aplicar as mudanças ao painel, clique em Aplicar na barra de ferramentas. Para descartar as mudanças, clique em Cancelar.

      Depois que o widget for adicionado ao painel, você poderá mudar a configuração dele.

4. Para salvar o painel modificado, clique em Salvar na barra de ferramentas.

5. Opcional: adicione rótulos ao painel:

   1. Na lista de painéis, localize o painel e clique em Selecionar.
   2. Na barra de ferramentas, clique em Rótulos e faça uma das seguintes ações:

      • Para criar um marcador e adicioná-lo ao seu painel, na caixa de texto Criar um novo marcador, digite o nome do marcador e clique em Criar e aplicar.

        O rótulo é criado e adicionado ao painel.

      • Para configurar quais rótulos são adicionados ao seu painel, clique em Selecionar rótulos para aplicar, selecione os rótulos e clique em Ok.
   3. Para salvar as mudanças, clique em Confirmar.

Copiar um painel

Quando você quiser testar diferentes métricas ou opções de agregação, copie um painel e use o novo painel para fins de experimentação.

Para copiar um painel, faça o seguinte:

1. No console do Google Cloud, acesse a página  Painéis:

   Ir para Painéis

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

2. Na página Visão geral dos painéis, identifique o painel a ser copiado e clique em Copiar painel.
3. Opcional: atualize o nome do painel.
4. Clique em Copiar na caixa de diálogo de confirmação.

Copiar um painel para outro projeto

Observação: ao copiar um painel, você copia a definição dele, não os dados que ele exibe.

Para copiar um painel de um projeto para outro, seu papel do IAM para os projetos de destino do Google Cloud precisa incluir a permissão do editor do Monitoring. Para mais informações sobre papéis, consulte Controlar o acesso com o Identity and Access Management.

Para copiar um painel para outro projeto do Google Cloud, faça o seguinte:

1. No console do Google Cloud, acesse a página  Painéis:

   Ir para Painéis

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

2. Copie a definição do painel para a área de transferência:

   1. Na barra de ferramentas do painel, clique em Configurações, JSON e Editor JSON.
   2. Na barra de ferramentas do editor, clique em Copiar.

3. Cole a definição em um novo painel criado em um projeto diferente:

   1. Use o seletor de projeto do console do Google Cloud para selecionar o projeto em que você quer salvar a definição do painel.
   2. Clique em Criar painel personalizado.
   3. Na barra de ferramentas do painel, clique em Configurações, JSON e Editor JSON.
   4. Cole o conteúdo da área de transferência no editor.
   5. Clique em Aplicar alterações.
   6. Para salvar o painel modificado, clique em Salvar na barra de ferramentas.

Instalar um painel

É possível fazer upload de um painel personalizado no projeto do Google Cloud, com a definição armazenada em um local compartilhado. O Cloud Monitoring, por exemplo, fornece um conjunto selecionado de definições de painel no GitHub que são específicas para vários Google Cloud serviços. Os gráficos nesses painéis apresentam uma seleção de métricas relevantes para um serviço específico.

Depois de fazer upload de uma definição de painel, é possível modificá-la para mostrar os dados que você quer visualizar.

Para mais informações, consulte Instalar painéis de amostra.

Importar um painel do Grafana

O Cloud Monitoring fornece um importador que pode ser usado para importar arquivos de painel no formato JSON do Grafana para o Cloud Monitoring. Para mais informações, consulte Importar painéis do Grafana para o Cloud Monitoring.

Encontrar e acessar um painel

Os painéis personalizados são exibidos na mesma lista dos painéis específicos do serviço que o Cloud Monitoring cria quando você adiciona recursos ao projeto do Google Cloud.

Para acessar um painel, faça o seguinte:

1. No console do Google Cloud, acesse a página  Painéis:

   Ir para Painéis

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

   A página Meus painéis lista todos os painéis no seu projeto do Google Cloud.

2. Para encontrar um painel, faça o seguinte:

   • Selecione uma categoria. Por exemplo, para listar os painéis criados automaticamente pelo Google Cloud com base no uso dos serviçosGoogle Cloud , selecione G​C​P. Para refinar ainda mais a lista, use a barra Filtrar.

   • Selecione um rótulo definido pelo usuário. Por exemplo, suponha que você tenha criado um rótulo chamado Staging e o aplicado aos seus painéis que mostram informações sobre seus recursos de preparação. Para listar esses painéis, selecione o rótulo Staging. Para refinar ainda mais a lista, use a barra Filtrar.

   • Adicione filtros à barra Filtro:

     • Para listar painéis cujo nome ou descrição contém um texto específico, insira esse texto na barra Filtrar.

     • Para listar os painéis depois de filtrar pelo valor do campo, faça o seguinte:

       1. Selecione Filtrar painéis e escolha um campo para filtrar. É possível filtrar pelos seguintes campos do painel: nome, descrição, tipo e rótulo definido pelo usuário.

       2. Insira um valor para o filtro ou faça uma seleção no menu.

     • Para listar painéis que não têm gráficos, selecione Filtrar painéis, Rótulos e (Vazio).

     Quando você adiciona vários filtros e não inclui o operador OR entre dois filtros, um operador AND é adicionado aos filtros.

3. Depois de localizar o painel, selecione-o.

Modificar um painel

Depois de criar um painel, você pode determinar que ele precisa de modificação para ser mais útil. Por exemplo, você pode adicionar ou remover widgets, mudar o layout ou alterar a forma como um widget exibe dados. Além disso, você pode adicionar rótulos a um painel para facilitar a busca ou indicar o tipo de conteúdo.

Observação: se você criar um painel usando o Terraform, poderá acessá-lo no console do Google Cloud. No entanto, não edite o painel no console do Google Cloud. Para mais informações, consulte Resolver problemas: o painel criado pelo Terraform é redimensionado.

Adicionar ou remover rótulos

Para adicionar ou remover rótulos, faça o seguinte:

1. No console do Google Cloud, acesse a página  Painéis:

   Ir para Painéis

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

2. Na lista de painéis, localize o painel e clique em Selecionar.
3. Na barra de ferramentas, clique em Rótulos e faça uma das seguintes ações:

   • Para criar um marcador e adicioná-lo ao seu painel, na caixa de texto Criar um novo marcador, digite o nome do marcador e clique em Criar e aplicar.

     O rótulo é criado e adicionado ao painel.

   • Para configurar quais rótulos são adicionados ao seu painel, clique em Selecionar rótulos para aplicar, selecione os rótulos e clique em Ok.
4. Para salvar as mudanças, clique em Confirmar.

Adicionar ou remover filtros e variáveis

Depois de criar um painel, você pode adicionar filtros e variáveis. Os filtros são aplicados a todos os widgets em um painel. As variáveis são aplicadas a alguns widgets no painel. Os filtros e as variáveis podem ser úteis na solução de problemas. Por exemplo, é possível usar um filtro para que o painel mostre dados apenas de uma zona específica.

1. No console do Google Cloud, acesse a página  Painéis:

   Ir para Painéis

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

2. Localize e selecione o painel.

   • Para adicionar um filtro em todo o painel que se aplica apenas à sua sessão atual, use a barra de filtro do painel. Para mais informações, consulte Filtros temporários.

   • Para adicionar um filtro permanente em todo o painel, na barra de ferramentas do painel, acesse Configurações e selecione Gerenciar filtros. Para mais informações, consulte Criar e gerenciar variáveis e filtros fixados.

Modificar widgets ou mudar o layout

Para modificar os widgets ou o layout de um painel, faça o seguinte:

1. No console do Google Cloud, acesse a página  Painéis:

   Ir para Painéis

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

2. Localize e selecione o painel.

3. Opcional: para adicionar um widget ao painel, na barra de ferramentas do painel, clique em  Adicionar widget, selecione e configure o widget. Para aplicar as mudanças ao painel, clique em Aplicar na barra de ferramentas. Para descartar as mudanças, clique em Cancelar.

   Para mais informações, consulte as seguintes páginas:

   • Adicionar gráficos e tabelas
   • Mostrar políticas de alertas e incidentes
   • Mostrar registros
   • Mostrar SLOs
   • Adicionar texto e agrupamentos

4. Opcional: para modificar um widget, faça o seguinte:

   • Posicione o ponteiro sobre o widget para ativar a barra de ferramentas, clique em  Editar widget e atualize o widget. Para aplicar as mudanças ao painel, clique em Aplicar na barra de ferramentas. Para descartar as mudanças, clique em Cancelar.

     É possível mudar a maioria das configurações do widget, incluindo o tipo. Por exemplo, para mudar um gráfico de linhas para um gráfico de área empilhada, clique em Gráfico de linhas e selecione Gráfico de área empilhada no menu. Para mais informações, consulte Alterar o tipo de um widget.

   • Clique em Configurações, JSON e Editor JSON. Se você modificar o JSON, clique em Aplicar alterações.

     Também é possível acessar o JSON de um widget editando-o na barra de ferramentas e clicando em  Ver código.

5. Opcional: para excluir um widget, coloque o ponteiro nele para ativar a barra de ferramentas e faça uma das seguintes ações:

   • Se a barra de ferramentas do widget mostrar um botão Delete, clique nele.
   • Caso contrário, clique em Mais opções e selecione Excluir widget.

   Para aplicar as mudanças ao painel, clique em Aplicar na barra de ferramentas. Para descartar as mudanças, clique em Cancelar.

6. Opcional: para reposicionar um widget, use o ponteiro para arrastá-lo pelo cabeçalho para um novo local. Para aplicar as mudanças ao painel, clique em Aplicar na barra de ferramentas. Para descartar as mudanças, clique em Cancelar.

   Não é possível reposicionar widgets quando um painel está no modo de grade.

7. Opcional: para redimensionar um widget, use o ponteiro para reposicionar o canto direito dele. Para aplicar as mudanças ao painel, clique em Aplicar na barra de ferramentas. Para descartar as mudanças, clique em Cancelar.

   Não é possível redimensionar widgets quando um painel está no modo de grade.

8. Para salvar o painel modificado, clique em Salvar na barra de ferramentas.

Excluir um painel

A exclusão de um painel que contém um gráfico de uma política de alertas não remove as políticas de alertas que têm dados exibidos nesses gráficos. Portanto, você pode receber notificações dessas políticas depois que o painel for excluído. Para mais informações sobre como gerenciar suas políticas, que você faz na página Alertas no console do Google Cloud, consulte Gerenciar políticas de alertas.

Para excluir um painel personalizado, faça o seguinte:

1. No console do Google Cloud, acesse a página  Painéis:

   Ir para Painéis

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

2. Para iniciar a ação de exclusão, encontre o painel que você quer excluir e clique em Excluir.
3. Na caixa de diálogo de confirmação, clique em Excluir.
4. Para salvar o painel modificado, clique em Salvar na barra de ferramentas.

Salvar uma definição de painel em um sistema local

Talvez você tenha criado um painel personalizado que outras pessoas da sua equipe ou organização querem instalar nos projetos delas. Quando quiser compartilhar uma definição de painel, salve-a no seu sistema local e mova ou copie a definição para um local compartilhado. Por exemplo, você pode copiar a definição para um drive compartilhado ou para um repositório de código-fonte, como o GitHub. Qualquer pessoa com acesso ao local armazenado pode instalar o painel nos projetos do Google Cloud.

Para salvar a definição de um painel personalizado em um arquivo formatado em JSON armazenado no sistema local, faça o seguinte:

1. No console do Google Cloud, acesse a página  Painéis:

   Ir para Painéis

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

2. Na barra de ferramentas do painel, clique em Configurações, JSON e Editor JSON.

3. Para salvar a definição do painel em um sistema local, clique em Download do arquivo:

   O arquivo criado, que tem o mesmo nome do painel, contém uma representação JSON do painel. Esse arquivo armazena apenas a definição do painel, não dados de séries temporais.

Compartilhar um dashboard

Ao investigar uma anomalia de dados, talvez você queira que outra pessoa da sua equipe ou organização acesse os mesmos dados que você. Por exemplo, você pode notar uma queda ou um pico inesperado em uma métrica de desempenho e querer consultar um colega de equipe. Nesse cenário, você quer que seu colega de equipe visualize o painel e os dados dele.

Para saber como compartilhar um link para um painel, consulte Compartilhar um painel personalizado.

Configurar a atualização de dados

Quando você abre um painel, ele é configurado com a atualização automática desativada. A barra de ferramentas mostra um botão, sync_disabled, que indica esse estado.

Para ativar a atualização automática na sua sessão atual, acesse a barra de ferramentas e selecione sync_disabled Ativar atualização automática.

Para desativar a atualização automática depois de ativá-la, acesse a barra de ferramentas e selecione sync Disabled auto refresh.

Observação: não é possível configurar um painel para abrir com a atualização automática ativada. É possível ativar a atualização automática apenas para a sessão atual. Quando você recarrega o painel, a atualização automática é desativada.

Ativar o salvamento automático de alterações de configuração

Por padrão, os painéis não salvam suas alterações. Para ativar o salvamento automático, clique no botão Salvar automaticamente até que ele esteja na posição Ativado. Quando Concluído for exibido, suas alterações serão salvas.

A seguir

• Adicionar gráficos e tabelas
• Analisar os dados em gráficos
• Configurar um escopo de métricas para vários projetos