Criar e 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, você exibe informações do seu interesse, organizadas da maneira mais útil. Por exemplo, é possível criar um painel para exibir os registros, as métricas de desempenho e as políticas de alertas de máquinas virtuais (VM) no ambiente de produção. Depois de criar um painel personalizado, você 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 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 são compatíveis com diversos tipos de widgets. Assim, você pode escolher a melhor maneira de exibir seus dados. Por padrão, os painéis exibem todos os dados de métricas disponíveis para o 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 todos os itens a seguir:

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

Você pode 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 que é expandido ou recolhido.

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

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

• Eventos, como a falha de um pod do Google Kubernetes Engine, ajudam a correlacionar dados de diferentes fontes durante a solução de um problema. Para mais informações, consulte Mostrar eventos em um painel.

• Os rótulos ajudam a localizar os painéis com base no tipo de conteúdo que eles exibem. Por exemplo, é possível adicionar o rótulo prod a 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.

  Ao visualizar seus painéis, é possível selecionar um rótulo para filtrar a lista para os painéis que contenham 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 mais informações sobre como mudar essas configurações, consulte Desativar a atualização de dados e Desativar o salvamento automático de mudanças de configuração.

Antes de começar

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

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á 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 dashboard.
• Você pode 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. Nesse caso, é possível criar o painel em um projeto e copiar a definição do painel para outros projetos. Se preferir, faça o download da definição do painel no sistema local e instale 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:

   Acessar Painéis

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

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

3. Para adicionar widgets ao seu 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 painel.

      É possível selecionar um widget com base no tipo de dados a serem mostrados ou em como você quer mostrá-los. 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. Se preferir, selecione o widget Área empilhada e escolha a métrica.

   3. Configure o widget.

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

      Depois que o widget é adicionado ao seu painel, você pode alterar a configuração do widget.

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 Marcadores e siga um destes procedimentos:

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

        O rótulo é criado e adicionado ao painel.

      • Para configurar quais rótulos serão adicionados ao painel, clique em Selecionar rótulos a serem aplicados, selecione-os e clique em Ok.
   3. Para salvar as mudanças, clique em Confirmar.

Copiar um dashboard

Se quiser testar diferentes métricas ou opções de agregação diferentes, você pode copiar um painel e usar o novo 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:

   Acessar Painéis

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

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

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 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 do Google Cloud, acesse a página  Painéis:

   Acessar Painéis

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

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

   1. Na barra de ferramentas do painel, clique em Settings, em JSON e em JSON Editor.
   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 projetos do console do Google Cloud para escolher 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 Settings, em JSON e em JSON Editor.
   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 seu 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 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 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, acesse Importar painéis do Grafana para o Cloud Monitoring.

Encontrar e ver 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 à medida que você adiciona recursos ao projeto do Google Cloud.

Para visualizar um painel, faça o seguinte:

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

   Acessar Painéis

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

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

2. Para encontrar um painel, siga um destes procedimentos:

   • Use a barra Filtro para pesquisar o nome completo ou parcial do painel ou para filtrar por tipo de painel.

   • Selecione uma categoria. Para refinar ainda mais a lista, use a barra Filtro.

   • Selecione o rótulo 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 Filtro. Quando você adiciona vários filtros e não inclui o operador OR entre dois filtros, um AND lógico une os 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ções para ser mais útil para você. Por exemplo, você pode querer adicionar ou remover widgets, mudar o layout ou mudar 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.

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:

   Acessar Painéis

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

2. Na lista de painéis, localize o painel e clique em Selecionar.
3. Na barra de ferramentas, clique em Marcadores e siga um destes procedimentos:

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

     O rótulo é criado e adicionado ao painel.

   • Para configurar quais rótulos serão adicionados ao painel, clique em Selecionar rótulos a serem aplicados, selecione-os e clique em Ok.
4. Para salvar as mudanças, clique em Confirmar.

Adicionar ou remover filtros

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

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

   Acessar Painéis

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

2. Localize e selecione o painel.

   • Para adicionar um filtro de todo o painel que se aplique 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 Filtros permanentes.

Modificar widgets ou mudar layout

Para modificar os widgets ou o layout do painel, siga um destes procedimentos:

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

   Acessar Painéis

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

2. Localize e selecione o painel.

3. Opcional: para adicionar um widget ao painel, na barra de ferramentas do painel, clique em  Adicionar widget. Depois, selecione e configure o widget. Para aplicar as mudanças ao painel, clique em Apply 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 gráficos de alertas e incidentes
   • Exibir registros
   • Mostrar SLOs
   • Adicionar texto e agrupamentos

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

   • Posicione 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 Apply 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 dele. 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, em JSON e, em seguida, clique em Editor de JSON. Se você modificar o JSON, clique em Apply changes.

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

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

   • Se a barra de ferramentas do widget exibir 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 Apply 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 Apply 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 Apply 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 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 informações sobre como gerenciar suas políticas 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 do Google Cloud, acesse a página  Painéis:

   Acessar Painéis

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

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

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

   Acessar 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 painel, clique em Settings, em JSON e em JSON Editor.

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

   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

Quando você está investigando uma anomalia de dados, talvez queira que outra pessoa da equipe ou da organização veja os mesmos dados que você. Por exemplo, você pode encontrar uma queda ou 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.

Saiba como compartilhar um link para um painel em Compartilhar 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á ativada, ou desativada (). Para mudar o estado, clique no botão.

Ativar salvamento automático das 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 Salvamento automático até que ele esteja na posição Ativado . Quando Cloud Done for exibido, as alterações foram salvas.

A seguir

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