Esta página foi traduzida pela API Cloud Translation.

Gerenciar painéis personalizados

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

Os painéis personalizados são compatíveis com vários tipos de widget, para que você possa escolher a melhor maneira de exibir os dados da métrica. Esses painéis também permitem exibir dados de métricas de vários projetos do Google Cloud e métricas de vários serviços do Google Cloud. Além das métricas, os painéis personalizados podem exibir entradas de registro de vários projetos do Google Cloud e políticas de alerta, e é possível criar variáveis de modelo para filtrar seu painel.

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

Para informações sobre como gerenciar painéis personalizados usando a API e a Google Cloud CLI, consulte 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.

Antes de começar

Verifique se o papel do Identity and Access Management inclui as permissões necessárias:

Para receber as permissões necessárias para visualizar painéis, peça ao administrador para conceder a você o papel de Leitor do Monitoring (roles/monitoring.viewer).
Para receber as permissões necessárias para criar e editar painéis e editar painéis, peça ao administrador para conceder a você o papel de Editor do Monitoring (roles/monitoring.editor).

Para mais informações sobre papéis, consulte Controle de acesso.

Criar um painel personalizado.

No console do Google Cloud, selecione Monitoramento ou clique no botão a seguir:
Acessar o Monitoring
No painel de navegação, selecione Painéis de dados.
Na página Visão geral dos painéis, clique em Criar painel.
Faça o seguinte para cada widget que você quiser adicionar ao painel:
1. Selecione um widget da Biblioteca de gráficos ou arraste um deles para a área do gráfico.
  
  Um widget pré-configurado do tipo selecionado é exibido. O exemplo a seguir ilustra um gráfico de linhas e o painel de configuração correspondente.
2. Para alterar a série temporal mostrada pelo widget, selecione a configuração de tipo que você quer fazer e preencha o formulário. Por exemplo, para minimizar o número de campos que você precisa preencher, selecione a guia Básico e use os menus nessa guia para configurar o widget. Para informações sobre suas opções, consulte Adicionar widgets do painel.

Ver um painel personalizado

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

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

No console do Google Cloud, selecione Monitoramento ou clique no botão a seguir:
Acessar o Monitoring
No painel de navegação, selecione Painéis de dados.
Selecione o nome do painel. Para restringir a lista a painéis personalizados, adicione o filtro Tipo: Personalizado.
Se o botão Fechar editor for mostrado, clique nele.
Opcional: adicione ou modifique os filtros do painel para alterar temporariamente a série temporal mostrada pelos widgets do painel. Para mais informações, consulte Filtrar um painel.
Opcional: altere o período de exibição de todos os widgets no painel. Por padrão, o seletor de período é definido como uma hora.

Para mudar o período exibido, use o seletor de período. Por exemplo, se você quiser ver os dados da última semana, selecione Última semana no seletor de período. Você também pode especificar um horário de início e de término ou um horário para visualizar ao redor.

Para painéis que exibem dados esparsos, como métricas de cota, defina o seletor de período para pelo menos uma semana.
Opcional: altere a configuração para cada widget em um painel usando as opções de Configurações do painel. Essas opções permitem, por exemplo, mostrar ou ocultar legendas.

Modificar um painel personalizado

Modifique um painel quando quiser adicionar ou remover widgets, alterar o layout dos widgets do painel, alterar o tipo de um widget ou alterar a série temporal mostrada por um widget.

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

No console do Google Cloud, selecione Monitoramento ou clique no botão a seguir:
Acessar o Monitoring
No painel de navegação, selecione Painéis e selecione o painel que você quer visualizar ou editar.
Se o botão Editar painel for mostrado, clique nele.
Para modificar o painel, siga um destes procedimentos:
- Para adicionar um widget, clique em Add chart, selecione o widget de interesse e preencha a caixa de diálogo. Para mais informações, consulte Adicionar widgets do painel.
- Para modificar a série temporal mostrada por um widget existente, selecione-o e faça as alterações usando o painel de configuração do widget. Para informações sobre como configurar um widget, consulte Adicionar widgets do painel.
- Para modificar um widget ou o painel editando a representação JSON, clique em Editor JSON. Depois que suas alterações forem concluídas, clique em Aplicar alterações na barra de ferramentas do editor.
  
  Quando você abre o editor JSON depois de selecionar um widget, ele expande apenas a representação dele. Para ver a definição completa do painel, selecione Show more no editor JSON:
- Para alterar o tipo de um widget, clique no nome do widget atual e faça uma seleção no menu. Por exemplo, para alterar um gráfico de linhas para um gráfico de área empilhado, 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.
- Para excluir um widget, clique em Delete na barra de ferramentas do widget.
- Para redimensionar ou reposicionar um widget, use o ponteiro. Essas opções são desativadas quando um painel está no modo de grade.
- Para mudar o layout dos widgets no painel, use o seletor Grade e Mosaico. Quando você seleciona Grade, todos os widgets têm as mesmas dimensões.

Excluir um painel personalizado

A exclusão de um painel que contém gráficos de alertas não exclui as políticas de alertas que têm dados exibidos nesses gráficos de alertas. 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, na página Alertas no console do Google Cloud, consulte Gerenciar políticas.

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

No console do Google Cloud, selecione Monitoramento ou clique no botão a seguir:
Acessar o Monitoring
No painel de navegação, selecione Painéis de dados.
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.

Duplicar um painel personalizado no mesmo projeto

Quando você quiser testar diferentes métricas ou opções de agregação, uma opção é duplicar um painel e usar a cópia para fins de experimentação.

Para duplicar um painel, faça o seguinte:

No console do Google Cloud, selecione Monitoramento ou clique no botão a seguir:
Acessar o Monitoring
No painel de navegação, selecione Painéis de dados.
Na página Visão geral de painéis, identifique o painel a ser copiado e clique em Copiar.
Clique em Copiar na caixa de diálogo de confirmação.

Copiar um painel personalizado para outro projeto

Quando você tem vários projetos do Cloud e quer que eles tenham o mesmo painel personalizado, crie o painel em um projeto e o copie para outros. A cópia tem o mesmo layout e propriedades que o painel de origem. No entanto, os dados que a cópia exibe são diferentes.

Para copiar um painel de um projeto para outro, seu papel do IAM nos projetos do Cloud de destino precisa incluir a permissão de editor do Monitoring. Para mais informações sobre papéis, consulte Controle de acesso.

Para copiar uma definição de painel para outro projeto do Cloud, faça o seguinte:

No console do Google Cloud, selecione Monitoramento ou clique no botão a seguir:
Acessar o Monitoring
No painel de navegação, selecione Painéis e selecione o painel que você quer visualizar ou editar.
Copie a definição do painel para a área de transferência:
1. Se o botão Editar painel for mostrado, clique nele.
2. Na barra de ferramentas do painel, clique em Editor JSON para abrir o editor JSON.
3. 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 salvar a definição do painel.
2. Clique em Criar painel.
3. Na barra de ferramentas do painel, clique em Editor JSON para abrir o editor JSON.
4. Cole o conteúdo da área de transferência no editor.
5. Clique em Aplicar alterações.

Durante a investigação de uma anomalia de dados, talvez você queira que outra pessoa na sua equipe ou organização veja os mesmos dados que você vê. Por exemplo, talvez você veja uma queda ou um pico inesperado em uma métrica de desempenho e queira consultar um colega. Nesse cenário, você quer que seu colega de equipe visualize o painel e os dados dele.

Para saber mais sobre como compartilhar um link para um painel, consulte Compartilhar painéis.

Compartilhar uma definição de painel personalizado

Talvez você tenha criado um painel personalizado que outros membros da equipe ou da organização querem instalar nos projetos. Quando você quiser compartilhar uma definição de painel, salve-a no sistema local e depois mova ou copie a definição para um local compartilhado. Por exemplo, você pode copiar a definição em um drive compartilhado ou em um repositório de código-fonte, como o GitHub. Qualquer pessoa com acesso ao local armazenado pode instalar o painel nos projetos do 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, selecione Monitoramento ou clique no botão a seguir:
Acessar o Monitoring
No painel de navegação, selecione Painéis e selecione o painel que você quer visualizar ou editar.
Se o botão Editar painel for mostrado, clique nele.
Na barra de ferramentas do painel, clique em Editor JSON para abrir o editor JSON.
Para salvar a definição do painel em um sistema local, clique em Download do arquivo:

O arquivo criado, nomeado para o painel, contém uma representação JSON do painel. Esse arquivo armazena apenas a definição do painel, não armazena dados de série temporal.

Instalar uma definição de painel personalizada

Para usar ou personalizar um painel criado por outra pessoa, instale a definição dele no seu projeto do Cloud. O Cloud Monitoring, por exemplo, fornece um conjunto selecionado de definições de painel no GitHub que são específicas 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. É possível instalar essas definições no projeto do Cloud como painéis personalizados e modificá-las para mostrar os dados que você quer visualizar.

Para informações sobre como instalar um painel usando a API Cloud Monitoring ou a Google Cloud CLI, consulte Instalar painéis de amostra.

Para instalar uma definição de painel usando o console do Google Cloud, faça o seguinte:

No console do Google Cloud, selecione Monitoramento ou clique no botão a seguir:
Acessar o Monitoring
No painel de navegação, selecione Painéis e, em seguida, siga um destes procedimentos:
- Para instalar um painel a partir da biblioteca de amostra, faça o seguinte:
  1. Clique na guia Biblioteca de exemplo.
  2. Selecione os painéis que você quer instalar.
  3. (Opcional) Para ver detalhes sobre um painel ou o conteúdo, clique em Visualizar.
  4. (Opcional) Para visualizar a representação JSON de um painel, clique em Visualizar e em JSON.
  5. Clique em Importar.
- Para instalar um painel fazendo upload de um arquivo JSON, faça o seguinte:
  1. (Opcional) Para instalar uma definição de painel selecionada, faça o download do repositório do GitHub:
```
git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples.git
```
    Observação: algumas das definições de painéis armazenadas no repositório do GitHub exibem dados de métricas personalizadas. Para instalar esses painéis com sucesso, crie as métricas personalizadas necessárias. Para mais informações, consulte a documentação por serviço no repositório.
  2. Clique em Criar painel.
  3. Na barra de ferramentas do painel, clique em Editor JSON.
    
    O código exibido para um novo painel é semelhante ao seguinte:
```
{
  "category": "CUSTOM",
  "displayName": "New Dashboard",
  "mosaicLayout": {
    "columns": 12
  },
}
```
  4. Na barra de ferramentas do editor, clique em Upload de arquivo.
  5. Selecione o arquivo que contém a definição do painel e clique em Abrir.
    
    Depois do upload do arquivo, o JSON do painel é atualizado.
    
    Caso você veja a mensagem "Não foi possível salvar o painel: o campo mosaicLayout.tiles[0] tem um valor inválido", selecione Grid na barra de ferramentas do painel.
  6. (Opcional) Personalize o painel. Por exemplo, você pode atualizar o título, adicionar uma caixa de texto que indique a origem do painel, excluir gráficos indesejados ou adicionar gráficos.

Desativar atualização de dados

Quando uma anomalia de dados for exibida em um gráfico, talvez você preserve a visualização atual enquanto investiga a anomalia. Por padrão, os painéis atualizam automaticamente a tela conforme novos dados são disponíveis.

Para interromper a atualização automática do painel, clique no botão de atualização automática até que ele exiba Desativado.

Para ativar a atualização automática do painel, clique no botão de atualização automática até que ele exiba Ativado.

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

Por padrão, os painéis são configurados para salvar as alterações à medida que são feitas. No entanto, quando você quer testar ou configurar um painel editando a representação JSON, convém usar um processo manual para salvar as alterações.

Para salvar manualmente as alterações feitas, faça o seguinte:

Clique no botão Salvar automaticamente até que o botão Salvar seja exibido.
Faça as modificações no painel.
Para manter suas alterações, clique em Salvar.

Para ativar o salvamento automático das suas alterações de configuração, verifique se a opção Autosave está ativada. Quando Concluído for exibido, suas alterações serão salvas.