Esta página foi traduzida pela API Cloud Translation.

Criar e gerenciar painéis personalizados

Este documento descreve como criar e gerenciar painéis personalizados usando o console do Google Cloud. Os painéis personalizados permitem exibir informações de seu interesse, organizadas para serem úteis. Para Por exemplo, é possível criar um painel para exibir registros, métricas de desempenho e políticas de alertas para máquinas virtuais (VM) no seu ambiente de produção. Depois de criar um painel personalizado, também é possível copiar, modificar e compartilhar. Para criar painéis, use o console do Google Cloud, a API Cloud Monitoring ou a Google Cloud CLI.

Este documento descreve como criar e gerenciar seus painéis personalizados, usando o console do Google Cloud:

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

Sobre os painéis personalizados

Os painéis personalizados oferecem suporte a vários tipos de widgets, para que você possa escolher a melhor maneira de exibir seus dados. Por padrão, os painéis exibem todos de métricas disponíveis para seu projeto do Google Cloud. Se você configure um escopo de métricas, depois seu painel pode exibir dados de métricas de vários projetos do Google Cloud.

Um painel personalizado pode exibir todos os itens a seguir:

É possível melhorar o tempo de carregamento ou a usabilidade de um painel widgets de agrupamento. Por exemplo, é possível adicionar seções a um painel. Como alternativa, você pode adicionar widgets a um contêiner que esteja expandidas ou recolhidas.

Depois de criar um painel, é possível adicionar filtros, eventos ou marcadores:

Os filtros do painel se aplicam a todos ou a alguns widgets na mais avançado. Esses filtros podem ser úteis na solução de problemas. Por exemplo, é possível usar esses filtros para exibir dados somente de uma zona específica. Para mais informações, consulte Adicione ou remova filtros.
Eventos, como a falha de um pod do Google Kubernetes Engine, pode ajudar você correlacionar dados de diferentes fontes ao solucionar um problema. Para mais informações, consulte Mostrar eventos em um painel.
Os rótulos ajudam a localizar painéis com base no tipo de conteúdo exibidos. Por exemplo, é possível adicionar o rótulo prod aos painéis que exibem informações sobre sistemas de produção. Da mesma forma, talvez você Adicione o rótulo staging para indicar que o painel exibe informações sobre sistemas de teste.

Ao visualizar os painéis, é possível selecionar um identificador para filtrar a lista os painéis que contêm o rótulo selecionado.

Antes de começar

Para ter as permissões necessárias para criar e modificar painéis personalizados usando o console do Google Cloud, faça o seguinte: peça ao administrador para conceder a você Papel do IAM Editor do Monitoring (roles/monitoring.editor) no projeto. Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

Também é possível conseguir as permissões necessárias com papéis personalizados ou outros papéis predefinidos.

Para mais informações sobre papéis, consulte Controle o acesso com o Identity and Access Management.

Adicionar um painel personalizado ao seu projeto

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

É possível criar um painel.
É possível 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, imagine que você tem vários projetos do Google Cloud querem que eles definam o mesmo painel personalizado. Para essa situação, você pode criar o painel em um projeto e depois copiá-lo a outros projetos. Também é possível faça o download da definição do painel para seu sistema local e depois instalar essa definição em outro nos projetos do Google Cloud.

Crie um novo dashboard

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

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.
Na página Painéis, clique em Criar painel personalizado.
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 uma opção para adicionar ao dashboard.
  
  Você pode selecionar um widget com base no tipo de dados a serem exibidos ou em como quer exibir os dados. Em todos os casos, um painel de configuração é aberto. Por exemplo, é possível selecionar o widget Métrica e e defina a visualização como Área empilhada. Se preferir, selecione o Área empilhada e selecione a métrica.
3. Configure o widget.
4. Para aplicar as alterações ao painel, na barra de ferramentas, Clique em Aplicar. Para descartar as mudanças, clique em Cancelar.
  
  Depois que o widget é adicionado ao painel, é possível alterar a na configuração do widget.
Para salvar o dashboard modificado, clique em Salvar na barra de ferramentas.
Opcional: adicione rótulos ao seu painel:
1. Na lista de painéis, localize o painel e Clique em Selecionar.
2. Na barra de ferramentas, clique em Marcadores e siga um destes procedimentos:
  - Para criar um marcador e adicioná-lo ao seu painel: Na caixa de texto Criar um novo marcador, digite o nome dele e clique em Criar e aplicar.
    O rótulo é criado e adicionado ao painel.
  - Para definir quais rótulos serão adicionados ao painel, Clique em Selecionar marcadores para aplicar, selecione os marcadores e clique em Ok.
3. Para salvar as mudanças, clique em Confirmar.

Copiar um painel

Quando você quiser testar diferentes métricas ou agregações você pode copiar um painel e usar o novo painel para para fins de experimentação.

Para copiar um painel, faça o seguinte:

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.
Na página Visão geral dos painéis, identifique o painel que será copiado. e clique em Copiar painel.
Opcional: atualize o nome do painel.
Clique em Copiar na caixa de diálogo de confirmação.

Copiar um painel para outro projeto

Para copiar um painel de um projeto para outro, o papel do IAM para os projetos de destino do Google Cloud precisa incluem 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 seguintes:

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.
Copie a definição do painel para a área de transferência:
1. Na barra de ferramentas do painel, clique em Configurações, em seguida, JSON e, em seguida, JSON Editor.
2. Na barra de ferramentas do editor, clique em Copiar.
Cole a definição em um novo painel criado em um projeto diferente:
1. Use o seletor de projetos do console do Google Cloud para escolher o projeto para salvar a definição do painel.
2. Clique em Criar painel personalizado.
3. Na barra de ferramentas do painel, clique em Configurações, Clique em JSON e depois em Editor de JSON.
4. Cole o conteúdo da área de transferência no editor.
5. Clique em Aplicar alterações.
6. Para salvar o dashboard modificado, clique em Salvar na barra de ferramentas.

Instalar um painel

É possível fazer upload para seu projeto do Google Cloud de um painel personalizado com definição seja 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 de 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.

Após o 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 visualizar um painel

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

Para visualizar um painel, faça o seguinte:

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 da sua projeto do Google Cloud.
Para encontrar um painel, siga um destes procedimentos:
- Use a barra Filtro para pesquisar pelo nome completo ou parcial do ou filtrar por tipo de painel.
- Selecione uma categoria. Para refinar ainda mais a lista, use a barra Filtro.
- Selecione o identificador para listar apenas os painéis que o contêm. Para refinar ainda mais a lista, use a barra Filtro.
Para reduzir o número de resultados listados, use a barra Filtrar. Quando você adiciona vários filtros e não inclui o operador OR. entre dois filtros, um AND lógico une os filtros.
Depois de localizar o painel, selecione-o.

Modificar um dashboard

Depois de criar um painel, você pode determinar que ele precisa de modificação para que sejam mais úteis para você. Por exemplo, adicione ou remova widgets, alterar o layout ou a forma como um widget exibe dados. Além disso, você pode querer adicionar rótulos a um painel, seja para torná-lo mais fáceis de encontrar ou indicar o tipo de conteúdo no painel.

Adicionar ou remover rótulos

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

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.
Na lista de painéis, localize o painel e Clique em Selecionar.
Na barra de ferramentas, clique em Marcadores e siga um destes procedimentos:
- Para criar um marcador e adicioná-lo ao seu painel: Na caixa de texto Criar um novo marcador, digite o nome dele e clique em Criar e aplicar.
  O rótulo é criado e adicionado ao painel.
- Para definir quais rótulos serão adicionados ao painel, Clique em Selecionar marcadores para aplicar, selecione os marcadores e clique em Ok.
Para salvar as mudanças, clique em Confirmar.

Adicionar ou remover filtros

Depois de criar um painel, você pode adicionar filtros no painel que se aplicam a todos ou alguns widgets no painel. Esses filtros podem ser úteis durante a solução de problemas. Por exemplo, é possível usar esses filtros para exibir dados somente de uma zona específica.

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.
Localize e selecione o painel.
- Para adicionar um filtro no painel que se aplique apenas à sua campanha 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, acesse o painel na barra de ferramentas, acesse Configurações e selecione Gerenciar filtros. Para mais informações, consulte Filtros permanentes.

Modificar widgets ou layout

Para modificar os widgets em um painel ou o layout da escolha uma das seguintes opções:

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.
Localize e selecione o painel.
Opcional: para adicionar um widget ao seu painel, na barra de ferramentas do painel, Clique em Adicionar widget e selecione e configure o widget. Para aplicar as alterações ao painel, na barra de ferramentas, Clique em Aplicar. Para descartar as mudanças, clique em Cancelar.

Para mais informações, consulte as seguintes páginas:
Opcional: para modificar um widget, siga um destes procedimentos:
- Posicione o ponteiro no widget para ativar o clique em Editar widget e atualize o widget. Para aplicar as alterações ao painel, na barra de ferramentas, Clique em Aplicar. Para descartar as mudanças, clique em Cancelar.
  
  É possível alterar a maioria das configurações do widget, incluindo o tipo. Por exemplo, para alterar 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 e em JSON. e clique em Editor do JSON. Se você modificar o JSON, clique em Aplicar alterações.
  
  Você também pode acessar o JSON de um widget editar o widget na barra de ferramentas e clicar em Mostrar código.
Opcional: para excluir um widget, coloque o ponteiro sobre ele para ativá-lo na barra de ferramentas e, em seguida, siga um destes procedimentos:
- Se a barra de ferramentas do widget exibir uma Excluir e, em seguida, clique nesse botão.
- Caso contrário, clique em Mais opções e selecione Excluir widget.
Para aplicar as alterações ao painel, na barra de ferramentas, Clique em Aplicar. Para descartar as mudanças, clique em Cancelar.
Opcional: para reposicionar um widget, use o ponteiro para arrastá-lo pela cabeçalho para um novo local. Para aplicar as alterações ao painel, na barra de ferramentas, Clique em Aplicar. Para descartar as mudanças, clique em Cancelar.

Não é possível reposicionar widgets quando um dashboard está no modo de grade.
Opcional: para redimensionar um widget, use o ponteiro para reposicionar a no canto superior direito do widget. Para aplicar as alterações ao painel, na barra de ferramentas, Clique em Aplicar. Para descartar as mudanças, clique em Cancelar.

Não é possível redimensionar widgets quando um painel está no modo de grade.
Para salvar o dashboard 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 exclui as políticas de alertas com dados que 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, que você pode fazer na página Alertas do console do Google Cloud, consulte Gerenciar políticas de alertas.

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

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.
Para iniciar a ação de exclusão, encontre o painel que você quer excluir e clique em Excluir.
Na caixa de diálogo de confirmação, clique em Excluir.
Para salvar o dashboard modificado, clique em Salvar na barra de ferramentas.

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

Você pode ter criado um painel personalizado que outras pessoas da equipe ou organização querem instalar nos projetos. Quando você quiser compartilhar uma definição de painel, salve-a em seu sistema local, e mover ou copiar a definição para um local compartilhado. Por exemplo, é possível copiar a definição a um drive compartilhado ou a um repositório de código-fonte, como o GitHub. Qualquer indivíduo 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:

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.
Na barra de ferramentas do painel, clique em Configurações, Clique em JSON e depois em Editor de JSON.
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 dashboard, contém uma representação JSON do painel. Esse arquivo armazena apenas a definição do dashboard, ele não armazena dados de série temporal.

Ao investigar uma anomalia de dados, talvez você queira que outra pessoa na sua equipe ou organização vejam os mesmos dados que você está vendo. Por exemplo, você pode ver uma queda ou um pico inesperado em um métrica de desempenho e quiser consultar um colega de equipe. Nesse cenário, você quer que seu colega de equipe visualize o painel e seus dados.

Para mais informações sobre como compartilhar um link para um painel, consulte Compartilhe um painel personalizado.

Configurar atualização de dados

A barra de ferramentas do painel exibe um botão que indica se a atualização automática está ativado, ou desativado, . Para alterar o estado, clique no botão.

Ativar o salvamento automático de mudanças de configuração

Por padrão, os painéis não salvam as alterações. Para ativar o salvamento automático, Clique no botão Autosave até que a opção esteja Ativada. posição Quando Cloud Done for exibido, suas alterações foram salvas.