Gerenciar widgets do painel

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

Este documento descreve como mudar o tipo de um widget, modificar qual série temporal ele mostra e excluir um widget usando o console doGoogle 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:

• Adicionar gráficos, tabelas e indicadores
• Mostrar políticas de alertas e incidentes
• Mostrar entradas de registro
• Adicionar texto e agrupar widgets
• Mostrar objetivos de nível de serviço (SLOs)

Esse recurso só é compatível com projetos Google Cloud . Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.

Antes de começar

Conclua as etapas a seguir no projeto do Google Cloud em que você quer gerenciar seus painéis:

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

  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.

Ver 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 cria protótipos de painéis usando o console Google Cloud .

Para visualizar ou modificar a representação JSON do painel, faça o seguinte:

1. No console 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 Monitoring.

2. Na barra de ferramentas do console Google Cloud , selecione seu projeto Google Cloud . Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.
3. Selecione um painel ou clique em Criar painel.

4. Escolha uma destas opções:

   • Para visualizar ou modificar a representação JSON do painel, na barra de ferramentas do painel, clique em settings Configurações, clique em JSON e em Editor JSON.

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

   • Para ver ou modificar a representação JSON de um widget específico, posicione o ponteiro sobre ele para ativar a barra de ferramentas, clique em edit Editar widget e, em seguida, clique em code Editor JSON.

     Agora você pode ver ou modificar o JSON. Se você fizer modificações, clique em Aplicar mudanças.

Mudar o tipo de um widget

Quando um widget mostra os dados corretos, mas não os apresenta da maneira mais útil, considere mudar o tipo dele. Por exemplo, suponha que você tenha um gráfico de linhas no painel. Para ver como cada série temporal contribui para a soma, mude o gráfico de linhas para um de área empilhada.

É possível mudar o tipo de um widget somente se o 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 pode mostrar várias série temporal, em um medidor.

Não é possível mudar o tipo de um gráfico que mostra 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 uma 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 que exibe dados de uma política de alertas, faça o seguinte:

1. No console 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 Monitoring.

2. Na barra de ferramentas do console Google Cloud , selecione seu projeto Google Cloud . Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.
3. Selecione um painel ou clique em Criar painel.

4. Coloque o ponteiro no widget para ativar a barra de ferramentas, clique em more_vert 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 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.

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

Definir o tipo de widget

Para fazer outras conversões além de transformar um gráfico de linhas em um gráfico que mostra dados de uma política de alertas, faça o seguinte:

1. No console 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 Monitoring.

2. Na barra de ferramentas do console Google Cloud , selecione seu projeto Google Cloud . Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.
3. Selecione um painel ou clique em Criar painel.
4. No widget cujo tipo você quer mudar, posicione o ponteiro nele para ativar a barra de ferramentas e clique em edit Editar widget.

5. No painel Mostrar, 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 mostrar o mesmo tipo de dados. No entanto, alguns widgets podem não estar ativados.

   Por exemplo, considere um gráfico que mostra várias série temporal, em que cada medição é um número de ponto flutuante de precisão dupla:

   • O painel de registros não está listado porque não pode mostrar dados de série temporal.
   • Os widgets Visão geral e Medidor estão listados no cabeçalho Compatível com ajustes porque eles só podem mostrar uma única série temporal, e o gráfico está exibindo várias séries. Antes de converter para um desses tipos, modifique a configuração de agrupamento.
   • O widget Mapa de calor está desativado porque ele só mostra dados com valor de distribuição.
   • Os widgets Área empilhada, Barra empilhada e Tabela estão listados no cabeçalho Compatível. É possível selecionar um destes valores.

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

Modificar a configuração de um widget

Para mudar a série temporal que um widget mostra ou como elas são combinadas, modifique a configuração do widget. Por exemplo, quando um gráfico mostra muitas série temporal, é possível melhorar a performance e a clareza visual agrupando-série temporal por um ou mais rótulos.

Para modificar a configuração de um widget, faça o seguinte:

1. No console 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 Monitoring.

2. Na barra de ferramentas do console Google Cloud , selecione seu projeto Google Cloud . Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.
3. Selecione um painel ou clique em Criar painel.

4. Edite o widget:

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

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

   • Para o widget de grupo recolhível, faça o seguinte:

     • Para editar o nome do grupo, clique em edit Editar grupo e conclua a caixa de diálogo.
     • Para adicionar widgets ao grupo, arraste-os do painel para o grupo.
     • Para remover widgets do grupo, exclua ou arraste-os para um espaço não utilizado no painel.

   • Para o widget de visualização única, expanda o menu Widget, clique em edit Editar grupo e faça o seguinte:

     • Para adicionar um widget ao grupo, clique em Adicionar widget e preencha a caixa de diálogo.

     • Para remover um widget do grupo, faça o seguinte:

       1. Para excluir um widget, clique em delete Excluir widget.
       2. Para remover um widget do grupo e movê-lo para o painel, clique em cancel Remover do grupo.

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

Excluir um widget

A velocidade com que um painel mostra os dados depende do número de widgets e de série temporal que ele exibe. Para melhorar a performance de um painel, uma opção é colocar widgets raramente usados em um widget de grupo recolhível e recolher o grupo. Os dados dos widgets em um grupo recolhido são carregados com uma prioridade menor do que os de outros widgets do painel. Uma alternativa ao uso do widget de grupo recolhível é excluir os widgets que você não usa.

A exclusão de um gráfico associado a uma política de alertas não remove a política de alertas cujos dados foram exibidos no gráfico. Para excluir uma política de alertas, acesse a página Alertas no consoleGoogle 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 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 Monitoring.

2. Na barra de ferramentas do console Google Cloud , selecione seu projeto Google Cloud . Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.
3. Selecione um painel ou clique em Criar painel.

4. Exclua o widget:

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

   • Para o widget de grupo recolhível, coloque o ponteiro sobre ele para ativar a barra de ferramentas e faça uma destas ações:

     • Para excluir o widget de grupo recolhível e os widgets que ele contém, clique em delete Remover grupo e filhos.
     • Para excluir um widget de grupo recolhível e mover os widgets para o painel, clique em cancel Remover o grupo, mas manter os filhos.

   • Para o widget de visualização única, expanda o menu Widget, clique em edit Editar grupo e faça uma destas ações:

     • Para excluir o widget de grupo de visualização única e os widgets que ele contém, clique em delete Excluir grupo.
     • Para excluir o grupo de visualização única e mover os widgets que ele contém para o painel, clique em cancel Desagrupar.

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

A seguir

• Analisar os dados em gráficos
• Configurar legendas
• Filtrar um painel:
  • Adicionar filtros temporários a um painel personalizado
  • Adicionar filtros permanentes a um painel personalizado