Gerenciar widgets do painel

Depois de criar um painel personalizado, talvez você queira modificá-lo. Por exemplo, talvez você queira converter um gráfico de linhas, que mostra todas as séries temporais, em um gráfico de área empilhada para que você possa ver a proporção de cada série temporal contribui para a soma.

Neste documento, descrevemos como alterar o tipo de um widget, como modificar qual série temporal ele é exibido e como excluir um widget usando o console do Google Cloud. Para informações sobre como gerenciar painéis personalizados usando a API, consulte Criar e gerenciar painéis por API.

Para informações sobre como adicionar widgets a um painel, consulte os seguintes documentos:

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.

Exibir representação JSON

A representação JSON de um painel ou widget pode ser útil quando você prefere gerenciar seus painéis usando a API Cloud Monitoring, mas você cria protótipos de seus painéis usando o console do Google Cloud.

Para visualizar ou modificar a representação JSON do 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. Selecione um painel ou clique em Criar painel.
  3. Escolha uma destas opções:

    • Para visualizar ou modificar a representação JSON do painel, na barra de ferramentas do painel, clique em Settings, clique em JSON e, em seguida, em JSON Editor.

      Agora é possível ver ou modificar a representação JSON. Se você fizer modificações, clique em Aplicar mudanças.

    • Para conferir ou modificar a representação JSON de um widget específico, coloque o ponteiro nele para ativar a barra de ferramentas, clique em  Edit widget e clique em  JSON Editor.

      Agora é possível conferir ou modificar o JSON. Se você fizer modificações, não se esqueça de clicar em Aplicar alterações.

Alterar o tipo de um widget

Quando um widget estiver exibindo os dados corretos, mas não apresentando-os da maneira mais útil, considere mudar o tipo do widget. Por exemplo, suponha que seu painel tenha um gráfico de linhas. Para ver como cada série temporal contribui para a soma, altere o gráfico de linhas para um gráfico de área empilhada.

Só é possível mudar o tipo de um widget se o widget de destino puder representar os dados mostrados pelo widget de origem. Por exemplo, sempre é possível alterar um gráfico de linhas para um de áreas empilhadas ou barras empilhadas. Da mesma forma, sempre é possível converter um medidor, que mostra uma única série temporal, em um gráfico de linhas. No entanto, talvez não seja possível converter um gráfico de linhas, que mostra várias série temporal, em um medidor.

Não é possível alterar o tipo de um gráfico que exibe dados de uma política de alertas, um painel de registros ou um grupo recolhível. Não é possível converter nenhum widget em um painel de registros ou em um widget de grupo recolhível.

Criar política de alertas com base em um gráfico de linhas

Para converter um gráfico de linhas que mostra um único tipo de métrica em um gráfico com dados de uma política de alertas, 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. Selecione um painel ou clique em Criar painel.
  3. Posicione o ponteiro no widget para ativar a barra de ferramentas, clique em Mais opções e selecione Converter para gráfico de alertas.

    Quando você faz essa seleção, a caixa de diálogo Criar política de alertas é aberta e as seleções de métrica, filtro e agrupamento do seu gráfico são aplicadas à condição de alerta. Conclua a especificação da política de alertas e clique em Criar. Para informações sobre essas etapas, consulte Criar uma política de alertas.

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

Definir o tipo de widget

Para realizar qualquer conversão que não seja a conversão de um gráfico de linhas em um gráfico que exibe dados de uma política de alertas, 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. Selecione um painel ou clique em Criar painel.
  3. No widget cujo tipo você quer mudar, coloque o ponteiro nele para ativar a barra de ferramentas e clique em  Edit widget.
  4. No painel Display, expanda o menu Tipo de widget e faça uma seleção.

    O menu Tipo de widget lista todos os tipos de widget que podem exibir o mesmo tipo de dados. No entanto, alguns widgets podem não estar ativados.

    Por exemplo, considere um gráfico que exibe várias série temporal, em que cada medida é um valor duplo:

    • O painel de registros não está listado porque não pode exibir dados de série temporal.
    • Os widgets Visão geral e Medidor estão listados sob o título Compatível com ajustes porque esses dois widgets só podem exibir uma única série temporal, e o gráfico está exibindo várias séries temporais. Antes de converter para um desses tipos, é preciso modificar a configuração do agrupamento.
    • O widget de mapa de calor está desativado porque eles só exibem dados com valores de distribuição.
    • Os widgets Área empilhada, Barra empilhada e Tabela estão listados no título Compatível. É possível selecionar um desses valores.
  5. Para aplicar as mudanças ao painel, clique em Apply na barra de ferramentas. Para descartar as mudanças, clique em Cancelar.

Modificar a configuração de um widget

Para alterar a série temporal que o widget exibe ou a forma como essas séries temporais são combinadas, modifique a configuração do widget. Por exemplo, quando um gráfico exibe muitas série temporal, é possível agrupar as série temporal por um ou mais rótulos para melhorar o desempenho e a clareza visual dele.

Para modificar a configuração de um widget, 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. Selecione um painel ou clique em Criar painel.
  3. Edite o widget:

    • Para todos os widgets, exceto o de visualização única e o de grupo recolhível, coloque o ponteiro no widget para ativar a barra de ferramentas e clique em  Editar widget.

      A página de configuração do widget será aberta.

    • Para o widget de grupo recolhível, siga um destes procedimentos:

      • Para editar o nome do grupo, clique em Editar grupo e preencha a caixa de diálogo.
      • Para adicionar widgets ao grupo, arraste os widgets do painel para o grupo.
      • Para remover widgets do grupo, exclua ou arraste widgets para o espaço não utilizado no painel.
    • Para o widget de visualização única, expanda o menu Widget, clique em Editar grupo e siga um destes procedimentos:

      • Para adicionar um widget ao grupo, clique em Adicionar widget e preencha a caixa de diálogo.
      • Para remover um widget do grupo, siga um destes procedimentos:

        1. Para excluir um widget, clique em Excluir widget.
        2. Para remover um widget do grupo e movê-lo para o painel, clique em Remover do grupo.
  4. Para aplicar as mudanças ao painel, clique em Apply na barra de ferramentas. Para descartar as mudanças, clique em Cancelar.

Excluir um widget

A rapidez com que um painel exibe dados depende do número de widgets que o painel exibe e do número de série temporal que cada widget exibe. Para melhorar a performance de um painel, uma opção é colocar widgets raramente usados em um widget de grupo que pode ser recolhido e recolher o grupo. Os dados de widgets em um grupo recolhido são carregados em uma prioridade mais baixa do que para outros widgets de painel. Uma alternativa ao uso do widget de grupo recolhível é excluir os widgets que não são usados.

Excluir um gráfico associado a uma política de alertas não remove a política de alertas com dados exibidos no gráfico. Para excluir uma política de alertas, acesse a página Alertas no console do Google Cloud. Para informações sobre como excluir uma política, consulte Gerenciar políticas de alertas. Não é possível excluir uma política de alertas de um painel personalizado.

Para excluir um widget em 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. Selecione um painel ou clique em Criar painel.
  3. Exclua o widget:

    • Para todos os widgets, exceto o de visualização única e o de grupo recolhível, coloque o ponteiro no widget para ativar a barra de ferramentas, clique em Mais opções e selecione Excluir widget.

    • No widget de grupo que pode ser recolhido, coloque o ponteiro nele para ativar a barra de ferramentas e siga um destes procedimentos:

      • Para excluir o widget de grupo recolhível e os widgets que ele contém, clique em Remover grupo e filhos.
      • Para excluir um widget de grupo recolhível e movê-los para o painel, clique em Remover o grupo, mas manter os filhos.
    • Para o widget de visualização única, expanda o menu Widget, clique em Editar grupo e siga um destes procedimentos:

      • Para excluir o widget de grupo de visualização única e os widgets que ele contém, clique em Excluir grupo.
      • Para excluir o grupo de visualização única e mover os widgets que ele contém para o painel, clique em Desagrupar.
  4. Para aplicar as mudanças ao painel, clique em Apply na barra de ferramentas. Para descartar as mudanças, clique em Cancelar.

A seguir