Adicionar texto e agrupamentos a um painel

Este documento descreve como adicionar informações úteis a um painel e como agrupar widgets em um painel. Por exemplo, você pode adicionar informações sobre o painel, links para recursos relevantes ou o que fazer em diferentes situações. Quando um painel contém muitos widgets, é possível melhorar a usabilidade dele agrupando-os.

Para mais informações sobre a API Cloud Monitoring, consulte Criar e gerenciar painéis por API.

Antes de começar

• Para ter 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 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.

• É possível incluir até 40 widgets no painel.

Adicionar texto a um painel

A captura de tela a seguir ilustra um widget de texto:

As informações desta seção são para o console do Google Cloud. Para mais informações sobre como usar a API Cloud Monitoring, consulte Painel com um widget Text.

Para adicionar um widget de texto a um painel, faça o seguinte:

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

2. Selecione um painel ou clique em Criar painel.
3. Na barra de ferramentas, clique em  Adicionar widget.
4. Na caixa de diálogo Add widget, acesse a seção Layout e selecione Text.
5. Adicione um título.

6. No painel Conteúdo, digite o texto que você quer mostrar.

   Para informações sobre formatação, consulte Comandos de Markdown compatíveis.

7. Opções: use os campos no painel Exibição para personalizar o conteúdo.

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

9. Para salvar o painel modificado, clique em Salvar na barra de ferramentas.

Comandos do Markdown compatíveis

Esta seção descreve os comandos do Markdown aceitos pelo widget de texto:

• Cabeçalhos

  Uma linha que começa com um hash, #, indica um cabeçalho. É possível usar vários sinais de hash para diferentes níveis de cabeçalhos. Por exemplo, para um cabeçalho de nível superior, use um único hash, # Header. Para um cabeçalho de segundo nível, use dois hashes, ## Second-level header.

• Fontes

  • Itálico: use *italic* ou _italic_.
  • Negrito: use **bold** ou __bold__.

• Links: formate como [link text](path).

  Você pode usar qualquer valor para link text. O valor de path precisa fazer referência a uma âncora HTML no painel ou ser um URL para uma página externa.

  • Para vincular a outra seção no painel. A âncora de uma seção é o título da seção, convertido em letras minúsculas com palavras separadas por um hífen. Por exemplo, para vincular a uma seção com o título "Gráficos que usam variáveis", defina path como #charts-using-variables.

  • Para vincular a um recurso externo, defina path como o URL. Por exemplo, para vincular a example.com, defina path como https://example.com/.

• Variáveis: formate como ${VARIABLE_NAME}.

  O widget de texto renderiza apenas o valor ou os valores da variável. Por exemplo, se você tiver uma variável baseada em rótulo em que a chave é zone e o valor é us-west1, o widget de texto vai mostrar us-west1.

  Quando o valor de uma variável é o caractere curinga (*), o widget de texto mostra all.

  As variáveis não reconhecidas são mostradas como escritas e não são renderizadas.

Organizar widgets do painel

Com os painéis personalizados, você especifica a posição dos gráficos, das políticas de alerta e de outros widgets. No entanto, é possível melhorar a usabilidade de um painel com muitos widgets criando seções no painel ou agrupando widgets:

• Para criar seções indexadas no painel, use o widget de cabeçalho de seção. Quando você adiciona esse widget ao painel, uma tabela de conteúdos é criada e um divisor horizontal é adicionado ao painel. A tabela de conteúdos permite navegar até uma seção específica do painel. Cada widget de seção contém uma âncora. Ao resolver problemas, talvez você queira compartilhar o URL da seção com um colega de equipe. Para copiar o URL da seção, clique com o botão direito do mouse em Link para o título e selecione Copiar endereço do link.

• Para reduzir o tempo de carregamento de um painel, use widgets de grupo colapsáveis e de visualização única. Ambos os widgets contêm uma coleção de widgets e melhoram a performance usando dados de prioridade mais baixa para extrair membros da coleção que não são exibidos. O widget de grupo colapsável mostra todos os membros da coleção quando está aberto. Caso contrário, todos os membros ficam ocultos. Em contraste, um widget de grupo de visualização única mostra apenas um membro da coleção por vez, e você usa um menu para selecionar qual membro será exibido.

Para usar os widgets descritos nesta seção, seu painel personalizado precisa usar o modo mosaico, que é o layout padrão. Se você mudar o layout para uma grade, esses widgets não estarão disponíveis.

O restante desta seção descreve como adicionar e configurar widgets que podem ser usados para organizar seus painéis. Para informações sobre como modificar esses widgets, consulte Modificar a configuração de um widget.

Adicionar um widget de cabeçalho de seção

Para mais informações sobre como usar a API Cloud Monitoring para criar um widget de cabeçalho de seção, consulte Painel com um widget SectionHeader.

Para adicionar um widget de cabeçalho de seção usando o console do Google Cloud, faça o seguinte:

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

2. Na caixa de diálogo Adicionar widget, acesse a seção Layout e selecione o widget Cabeçalho da seção.

3. No widget, clique em Editar seção e preencha a caixa de diálogo:

   • O valor do campo Section name é exibido na tabela de conteúdos.
   • O valor do campo Subtítulo é exibido no painel.
   • Se você selecionar *Adicionar um divisor ao índice, uma linha horizontal será adicionada após a entrada no índice.

Adicionar um widget de grupo recolhível

Para mais informações sobre como usar a API Cloud Monitoring para criar um widget de grupo colapsável, consulte Painel com um widget CollapsibleGroup.

Para adicionar um widget de grupo colapsável usando o console do Google Cloud, faça o seguinte:

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

2. Na caixa de diálogo Adicionar widget, acesse a seção Layout e selecione Grupo colapsável.

3. Para adicionar um widget ao grupo, arraste-o para o grupo.

   Depois de adicionar widgets ao grupo, use o ponteiro para redimensionar e reposicionar esses widgets.

4. Para adicionar um título descritivo ao grupo, coloque o ponteiro sobre o widget para ativar a barra de ferramentas e clique em Editar grupo.

5. Opcional: para garantir que o grupo seja fechado por padrão, coloque o ponteiro sobre o widget para ativar a barra de ferramentas e clique em Fechar grupo.

   Quando um widget de grupo colapsável é colapsado, o monitoramento recupera os dados dos widgets no grupo com uma prioridade menor do que para outros widgets. Como resultado, o painel é carregado mais rapidamente.

Adicionar um widget de grupo de visualização única

Observação: é possível adicionar até 10 gráficos a um widget de visualização única.

Para informações sobre como usar a API Cloud Monitoring para criar um widget de visualização única, consulte Painel com um widget SingleViewGroup.

Para adicionar um widget de grupo de visualização única usando o console do Google Cloud, faça o seguinte:

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

2. Se necessário, crie os widgets que você quer adicionar ao widget de visualização única.

3. Na caixa de diálogo Adicionar widget, acesse a seção Layout e selecione Grupo de visualização única.

   Um widget de grupo de visualização única é adicionado ao seu painel.

4. Adicione widgets ao widget de grupo de visualização única:

   1. No widget de grupo de visualização única, abra o menu Widget e selecione Editar grupo.

   2. Clique em Adicionar widget e selecione uma opção no menu Adicionar widget.

      Observação: nem todos os tipos de widget podem ser adicionados a um widget de grupo de visualização única. O menu Adicionar widget lista apenas os widgets compatíveis.

   3. Repita a etapa anterior para cada widget que você quer adicionar ao widget de grupo de visualização única.

   4. Use os botões Lower e Higher para ordenar os widgets no widget de grupo.

   5. Clique em Enviar.

   O painel é atualizado, e apenas um dos widgets adicionados ao widget de grupo de visualização única fica visível. A barra de ferramentas do widget exibido permite editar o widget ou realizar outras ações.

A seguir

Também é possível adicionar os seguintes widgets aos seus painéis personalizados:

• Gráficos, tabelas e indicadores
• Entradas de registro
• Gráficos de alertas e incidentes

Para saber como analisar dados em gráficos e filtrar seus painéis, consulte os seguintes documentos:

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