Criar e gerenciar painéis personalizados

Com os painéis personalizados no Cloud Monitoring, é possível organizar e visualizar as métricas, os registros, os traces, os alertas e os objetivos de nível de serviço (SLOs) mais importantes para seus aplicativos em um só lugar. Com o console do Google Cloud , é possível criar painéis do zero, importar painéis do Grafana ou copiar, modificar e compartilhar painéis entre projetos.

Para gerenciar painéis personalizados usando a API Cloud Monitoring ou a Google Cloud CLI, consulte Criar e gerenciar painéis por API. Para conferir painéis pré-configurados para serviços do Google Cloud , consulte Ver e copiar painéis do Google Cloud .

Sobre os painéis personalizados

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

Um painel personalizado pode exibir tudo o que segue:

• Gráficos e indicadores.
• Entradas de registro de vários Google Cloud projetos ou visualizações de registro.
• Alertas e gráficos para políticas de alertas.
• Objetivos de nível de serviço (SLOs).
• Texto.
• Dados de trace.

Para melhorar o tempo de carregamento ou a usabilidade de um painel, agrupe os widgets. Por exemplo, é possível adicionar seções a um painel. Também é possível adicionar widgets a um contêiner expandido ou recolhido.

Depois de criar um painel, é possível adicionar filtros, variáveis, eventos ou rótulos definidos pelo usuário:

• Os filtros de todo o painel se aplicam a todos os widgets do painel. Esses filtros podem ser úteis para resolver problemas. Por exemplo, é possível usar esses filtros para exibir dados apenas de uma zona específica. Para mais informações, consulte Adicionar ou remover filtros.

• As variáveis se aplicam aos widgets selecionados. Por exemplo, é possível usar uma variável para modificar a consulta emitida pelo widget ou para controlar a visibilidade de um widget. Para mais informações, consulte Criar e gerenciar variáveis e filtros fixados.

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

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

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

Antes de começar

No projeto do Google Cloud em que você quer criar e gerenciar painéis, faça o seguinte:

• Para receber 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 seu 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 usando papéis personalizados ou 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.
• É possível copiar ou duplicar um painel.
• É possível copiar um painel de um projeto para outro.
• É possível 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. Nessa situação, você pode criar o painel em um projeto e, em seguida, fazer o download de um modelo para o painel no sistema local. Em seguida, instale esse modelo em outros projetos doGoogle Cloud .

Crie um novo dashboard

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

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

   Acesse Painéis

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

2. Na barra de ferramentas do console Google Cloud , selecione seu projeto Google Cloud . Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.
3. Na página Painéis, clique em Criar painel personalizado.

4. 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.

      É possível selecionar um widget com base no tipo de dados a serem exibidos ou em como você quer que eles sejam exibidos. Em todos os casos, um painel de configuração é aberto. Por exemplo, é possível selecionar o widget Métrica e definir a visualização como Área empilhada. Ou selecione o widget Área empilhada e escolha 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, será possível alterar a configuração dele.

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

6. Opcional: adicione rótulos definidos pelo usuário ao painel:

   1. Na lista de painéis, localize o painel e clique em Adicionar rótulos ao painel.
   2. Siga uma destas opções:

      • Para criar um rótulo e adicioná-lo ao painel, na seção Criar um novo rótulo, insira o nome do rótulo na caixa de texto e clique em Criar e aplicar.

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

Copiar um painel

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

Para copiar um painel, faça o seguinte:

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

   Acesse Painéis

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

2. Na barra de ferramentas do console do Google Cloud , selecione seu projeto do Google Cloud . Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.
3. Na página Visão geral dos painéis, identifique o painel que você quer copiar e clique em Copiar painel.
4. Opcional: atualize o nome do painel.
5. 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 o modelo dele, não os dados que ele mostra.

Para copiar um painel de um projeto para outro, seu papel do IAM nos projetos de destino Google Cloud precisa incluir a permissão de 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 Google Cloud , acesse a página  Painéis:

   Acesse Painéis

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

2. Na barra de ferramentas do console do Google Cloud , selecione seu projeto do Google Cloud . Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.

3. Copie o JSON do painel para a área de transferência:

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

4. Cole o JSON na área de transferência em um novo painel criado em um projeto diferente:

   1. Use o seletor de projetos do console Google Cloud para selecionar o projeto em que você quer criar a cópia.
   2. Clique em Criar painel.
   3. Na barra de ferramentas do painel, clique em Configurações, clique em JSON e em 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 modelo de painel

É possível fazer upload de um modelo de painel para o projeto do Google Cloud quando ele é armazenado em um local compartilhado. O Cloud Monitoring, por exemplo, fornece um conjunto selecionado de modelos de painel no GitHub que são específicos para vários serviços do Google Cloud . 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 um modelo de painel, é possível personalizá-lo. Por exemplo, é possível adicionar gráficos, adicionar rótulos ou configurar quais eventos serão exibidos.

Para mais informações, consulte Instalar um modelo de painel.

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 que os painéis específicos do serviço criados pelo Cloud Monitoring quando você adiciona recursos ao projeto do Google Cloud .

Para acessar um painel, faça o seguinte:

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

   Acesse Painéis

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

2. Na barra de ferramentas do console Google Cloud , selecione seu projeto Google Cloud . Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.

   A página Painéis lista todos os painéis no seu projeto doGoogle Cloud .

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

   • Use as opções Visualizados recentemente e Favoritos para restringir quais painéis são listados.

   • Use o menu Integrações para listar apenas os painéis associados a uma integração específica.

   • Use o menu Tipo para listar apenas os painéis que têm um tipo específico. Por exemplo, para listar os painéis criados automaticamente pelo Google Cloud com base no uso dos serviços doGoogle Cloud , no menu Tipo, selecione Serviços do Google. Para refinar ainda mais a lista, use a barra Filtrar.

   • Use o menu Marcadores para listar apenas os painéis que têm um marcador específico definido pelo usuário. Por exemplo, suponha que você tenha criado um rótulo chamado Staging e aplicado esse rótulo aos seus painéis que mostram informações sobre seus recursos de staging. Para listar esses painéis, selecione o rótulo Staging. Para refinar ainda mais a lista, use a barra Filtrar.

   • Adicione filtros à barra Filtro de :

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

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

       1. Selecione Pesquisar nos 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 Pesquisar nos painéis, selecione Rótulos e, em seguida, selecione (Vazio).

     Quando você adiciona vários filtros e não inclui o operador OR entre eles, um operador AND os une.

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

Ver o histórico de versões do painel

Para saber quais mudanças foram feitas em um painel, consulte o histórico de versões, que lista o usuário que fez uma mudança e quantas mudanças foram feitas. Também é possível reverter para uma versão anterior do painel ou comparar uma versão anterior com a atual visualizando as diferenças. As revisões de um painel existente são mantidas por 90 dias, mas a revisão mais recente é mantida indefinidamente.

Para ver o histórico de versões de um painel, faça o seguinte:

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

   Acesse Painéis

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

2. Na barra de ferramentas do console Google Cloud , selecione seu projeto Google Cloud . Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.

3. Na barra de ferramentas do painel, acesse Configurações e selecione Ver histórico de versões. O painel do histórico de versões é aberto.

4. Opcional: para restaurar uma versão anterior de um painel, selecione uma versão na lista e clique no botão Reverter. O painel será recarregado e vai mostrar a versão anterior.

Modificar um painel

Depois de criar um painel, talvez você determine que ele precisa de modificações para ser mais útil. Por exemplo, talvez você queira adicionar ou remover widgets, mudar o layout ou alterar a forma como um widget exibe dados. Além disso, é possível adicionar rótulos a um painel para facilitar a localização ou indicar o tipo de conteúdo nele.

Observação :se você criar um painel usando o Terraform, será possível visualizá-lo com o console do Google Cloud . No entanto, não edite o painel no console do Google Cloud . Para mais informações, consulte Solução de problemas: o painel criado pelo Terraform é redimensionado.

Adicionar ou remover marcadores

Os rótulos podem ajudar você a localizar painéis com base no tipo de conteúdo que eles exibem. Por exemplo, é possível adicionar o rótulo prod aos painéis que exibem informações sobre sistemas de produção. Da mesma forma, é possível adicionar o rótulo staging para indicar que o painel exibe informações sobre sistemas de preparo. Em seguida, ao listar os painéis, é possível selecionar um rótulo para filtrar a lista e mostrar os painéis que contêm o rótulo selecionado.

Para adicionar ou remover rótulos definidos pelo usuário em um painel, faça o seguinte:

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

   Acesse Painéis

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

2. Na barra de ferramentas do console do Google Cloud , selecione seu projeto do Google Cloud . Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.
3. Na lista de painéis, localize o painel e clique em Adicionar rótulos ao painel.
4. Siga uma destas opções:

   • Para criar um rótulo e adicioná-lo ao painel, na seção Criar um novo rótulo, insira o nome do rótulo na caixa de texto e clique em Criar e aplicar.

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

Para listar, editar e excluir seus rótulos, clique em Gerenciar rótulos.

Adicionar ou remover filtros e variáveis

Depois de criar um painel, é possível adicionar filtros e variáveis. Os filtros são aplicados a todos os widgets em um painel. As variáveis se aplicam a alguns widgets no painel. Filtros e variáveis podem ser úteis ao solucionar problemas. Por exemplo, é possível usar um filtro para que o painel mostre dados apenas de uma zona específica.

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

   Acesse Painéis

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

2. Na barra de ferramentas do console Google Cloud , selecione seu projeto Google Cloud . Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.

3. Localize e selecione o painel.

   • Para adicionar um filtro que se aplica a todo o painel apenas na 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, 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 em um painel ou o layout dele, faça o seguinte:

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

   Acesse Painéis

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

2. Na barra de ferramentas do console do Google Cloud , selecione seu projeto do Google Cloud . Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.
3. Localize e selecione o painel.

4. 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 alertas e gráficos para políticas de alertas
   • Mostrar registros
   • Mostrar SLOs
   • Adicionar texto e agrupamentos

5. Opcional: para modificar um widget, siga um destes procedimentos:

   • Coloque o ponteiro no 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 empilhado, clique em Gráfico de linhas e selecione Gráfico de área empilhado no menu. Para mais informações, consulte Alterar o tipo de um widget.

   • Clique em Configurações, em JSON e em Editor JSON. Se você modificar o JSON, clique em Implementar mudanças.

     Você também pode acessar o JSON de um widget editando-o e clicando em  Ver código na barra de ferramentas do widget.

6. Opcional: para excluir um widget, coloque o ponteiro nele para ativar a barra de ferramentas e siga um destes procedimentos:

   • Se a barra de ferramentas do widget mostrar um botão Excluir, 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.

7. 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.

8. 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.

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

Excluir um painel

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

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

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

   Acesse Painéis

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

2. Na barra de ferramentas do console do Google Cloud , selecione seu projeto do Google Cloud . Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.
3. Para iniciar a ação de exclusão, encontre o painel que você quer excluir e clique em Excluir.
4. Na caixa de diálogo de confirmação, clique em Excluir.
5. Para salvar o painel modificado, clique em Salvar na barra de ferramentas.

Salvar um painel como modelo em um sistema local

Talvez você tenha criado um painel personalizado que outras pessoas da sua equipe ou organização queiram instalar nos projetos delas. Para compartilhar um modelo de painel, salve-o no sistema local e mova ou copie o modelo para um local compartilhado. Por exemplo, você pode copiar o modelo para uma unidade compartilhada 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 um modelo de painel personalizado em um arquivo formatado em JSON armazenado no seu sistema local, faça o seguinte:

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

   Acesse Painéis

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

2. Na barra de ferramentas do console do Google Cloud , selecione seu projeto do Google Cloud . Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.
3. Na barra de ferramentas do painel, clique em Configurações, em JSON e em Editor JSON.

4. Clique em download Download de arquivo:

   O arquivo criado, que tem o mesmo nome do painel, contém uma representação JSON dele. Esse arquivo é apenas um modelo e não armazena 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 veja os mesmos dados que você. Por exemplo, você pode notar uma queda ou um aumento inesperado em uma métrica de performance e quer consultar um colega de equipe. Nesse cenário, você quer que seu colega de equipe veja 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 uma alternância, sync_disabled, que indica esse estado.

Para ativar a atualização automática na 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 Desativar atualização automática.

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.

Configurar o salvamento automático das mudanças de configuração

Para cada projeto do Google Cloud , o Monitoring oferece uma configuração por usuário que controla se as modificações nos painéis personalizados são salvas automaticamente. Por padrão, o Monitoring salva as modificações automaticamente. Ou seja, conforme você edita um painel personalizado, o Monitoring salva periodicamente as alterações no painel. Se você quiser descartar as mudanças, restaure o painel original usando o histórico de versões.

É possível configurar o Cloud Monitoring para que, ao editar um painel, você precise selecionar a opção Salvar antes que as alterações sejam aplicadas ao painel. Até que você salve as alterações, as modificações serão aplicadas apenas ao estado na memória. Com essa configuração, é possível modificar painéis personalizados e depois manter ou descartar essas modificações.

Para desativar o recurso de salvamento automático, faça o seguinte:

1. Abra qualquer painel personalizado no seu projeto do Google Cloud .
2. Na barra de ferramentas, clique no botão Salvar automaticamente até que ele esteja na posição Desativado.

Para ativar o recurso de salvamento automático, faça o seguinte:

1. Abra qualquer painel personalizado no seu projeto do Google Cloud .

2. Na barra de ferramentas, clique no botão Salvar automaticamente até que ele esteja na posição Ativado.

   O ícone Cloud Done indica que o Monitoring salvou as alterações.

A seguir

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