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, é 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, as métricas de desempenho e as políticas de alertas para máquinas virtuais (VM, na sigla em inglês) 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 widgets, para que você possa escolher a melhor maneira de exibir os dados de métricas. 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 alertas, e você pode 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:

Antes de começar

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 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 outros papéis predefinidos.

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

Criar um painel

  1. No console do Google Cloud, selecione Monitoring e selecione Painéis ou clique no botão a seguir:

    Ir para "Painéis"

  2. Na página Visão geral dos painéis, clique em Criar painel.
  3. Para adicionar um widget ao seu painel, clique em  Adicionar widget na barra de ferramentas do painel.

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

    Você pode selecionar um widget com base no tipo de dados a ser exibido ou como quer exibir os dados. Em ambos os casos, um painel de configuração é aberto. Por exemplo, selecione o widget Métrica e defina a visualização como Área empilhada. Também é possível selecionar Área empilhada e depois a métrica.

  5. Configure o widget selecionado.

  6. Para salvar as alterações, clique em Aplicar. Para descartar as alterações, clique em Cancelar.

Depois de adicionar um widget a um painel, é possível editá-lo. Também é possível alterar o tipo de visualização. Por exemplo, é possível converter um gráfico de linhas em um gráfico de área empilhado. Para mais informações, consulte Alterar o tipo de um widget.

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

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

  1. No console do Google Cloud, selecione Monitoring e selecione Painéis ou clique no botão a seguir:

    Ir para "Painéis"

  2. Opcional: no painel Categorias, selecione a categoria de painel:

    • G C P: listar os painéis do Google Cloud.
    • Integrações: lista de painéis de terceiros.
    • Personalizada: listar painéis personalizados.

  3. Opcional: adicione filtros à barra de filtros. Quando você adiciona vários filtros e não inclui o operador OR entre dois filtros, um AND lógico faz a junção.

  4. Selecione o nome do painel.

Para saber como filtrar painéis personalizados, consulte Filtrar um painel personalizado.

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:

  1. No console do Google Cloud, selecione Monitoring e selecione Painéis ou clique no botão a seguir:

    Ir para "Painéis"

  2. Para modificar o painel, siga um destes procedimentos:

    • Para adicionar um widget ao seu painel, clique em  Adicionar widget na barra de ferramentas, selecione e configure o widget. Para mais informações, consulte as seguintes páginas:

    • Para modificar um widget, coloque o ponteiro no widget para ativar a barra de ferramentas, clique em  Editar widget e use a caixa de diálogo Configurar widget. Para salvar as alterações, clique em Aplicar. Para descartar as alterações, clique em Cancelar.

      Você pode alterar a maioria das configurações do widget, incluindo seu tipo. Por exemplo, para alterar um gráfico de linhas para um gráfico de áreas empilhadas, clique em Gráfico de linhas e selecione Gráfico de áreas empilhadas no menu. Para mais informações, consulte Alterar o tipo de um widget.

    • Para modificar um widget ou o painel editando a representação JSON, na barra de ferramentas do painel, clique em Configurações, clique em JSON e em Editor JSON. Se você fizer modificações, 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.

    • Para excluir um widget, coloque o ponteiro no widget para ativar a barra de ferramentas e, em seguida, siga um destes procedimentos:

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

    • Para reposicionar um widget, use o ponteiro para arrastá-lo pelo cabeçalho para um novo local. Esta opção é desativada quando um painel está em modo de grade.

    • Para redimensionar um widget, use o ponteiro para reposicionar o canto direito do widget. Esta opção é desativada quando um painel está em modo de grade.

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, acesse a página Alertas no Console do Google Cloud em Gerenciar políticas.

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

  1. No console do Google Cloud, selecione Monitoring e selecione Painéis ou clique no botão a seguir:

    Ir para "Painéis"

  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.

Duplicar um painel

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

Para duplicar um painel, faça o seguinte:

  1. No console do Google Cloud, selecione Monitoring e selecione Painéis ou clique no botão a seguir:

    Ir para "Painéis"

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

Compartilhar um painel

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 ver uma queda ou um aumento inesperado em uma métrica de desempenho e quer consultar um colega de equipe. Neste cenário, você quer que seu colega de equipe visualize o painel e os dados dele.

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

Copiar uma definição de painel para outro projeto

Quando você tem vários projetos do Google Cloud e quer que eles tenham o mesmo painel personalizado, crie o painel em um projeto e copie a definição para outros projetos. Você também pode fazer o download da definição para seu sistema local e compartilhá-la com os colegas. A cópia tem o mesmo layout e as mesmas propriedades do painel de origem. No entanto, os dados exibidos são diferentes.

Copiar uma definição de painel para outro projeto

Para copiar uma definição de 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 uma definição de painel para outro projeto do Google Cloud, faça o seguinte:

  1. No console do Google Cloud, selecione Monitoring e selecione Painéis ou clique no botão a seguir:

    Ir para "Painéis"

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

    1. Na barra de ferramentas do painel, clique em Configurações, em JSON e em Editor de 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 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.
    3. Na barra de ferramentas do painel, clique em Configurações, em JSON e em Editor de JSON.
    4. Cole o conteúdo da área de transferência no editor.
    5. Clique em Aplicar alterações.

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

Talvez você tenha criado um painel personalizado que outras pessoas na sua equipe ou organização querem instalar nos 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, 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 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, selecione Monitoring e selecione Painéis ou clique no botão a seguir:

    Ir para "Painéis"

  2. Na barra de ferramentas do painel, clique em Configurações, em JSON e em Editor de 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 só armazena a definição do painel, e não os de série temporal.

Instalar uma definição de painel

Para usar ou personalizar um painel criado por outra pessoa, instale a definição desse painel no seu projeto do Google 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 Google Cloud como painéis personalizados e modificá-las para mostrar os dados que você quer visualizar.

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

Configurar a 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 alterar o estado, clique no botão.

Ativar salvamento automático de alterações 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 Salvar automaticamente até que ele fique na posição Ativado. Quando Concluído for exibido, as alterações foram salvas.

A seguir