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.

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

Antes de começar

Siga estas etapas no projeto do Google Cloud em que você quer criar e modificar painéis personalizados:

Adicionar texto a um painel

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

Exemplo de um painel com 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. Na barra de ferramentas do console do Google Cloud, selecione seu projeto. Para as configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta ativada por apps.
  3. Selecione um painel ou clique em Criar painel.
  4. Na barra de ferramentas, clique em  Adicionar widget.
  5. Na caixa de diálogo Add widget, acesse a seção Layout e selecione Text.
  6. Adicione um título.

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

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

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

    Por exemplo, você pode configurar a visibilidade do widget.

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

  10. 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 da 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 em grupo. Há três tipos de widgets de grupo: colapsáveis, suspensos e de guia. Os widgets de grupo 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, os widgets de grupo de guias e de grupo suspenso mostram apenas um membro da coleção. A diferença entre esses widgets é se você seleciona o membro a ser exibido usando um menu ou uma guia.

Para usar os widgets descritos nesta seção, o 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.

Na maioria dos widgets, é possível configurar a visibilidade. No entanto, os widgets organizacionais estão sempre visí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 barra de ferramentas do console do Google Cloud, selecione seu projeto. Para as configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta ativada por apps.
  3. Na caixa de diálogo Adicionar widget, acesse a seção Layout e selecione o widget Cabeçalho da seção.

  4. 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 widgets 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 barra de ferramentas do console do Google Cloud, selecione seu projeto. Para as configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta ativada por apps.
  3. Na caixa de diálogo Adicionar widget, acesse a seção Layout e selecione Grupo colapsável.

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

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

  6. 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 widgets de grupo de guias ou grupo suspenso

Os widgets de grupo suspenso e de grupo de guias contêm uma coleção de outros widgets, mas exibem apenas um membro da coleção. A diferença entre esses widgets é a forma como você seleciona qual membro da coleção será exibido. Os grupos de menus suspensos oferecem um menu, e os grupos de guias oferecem guias na barra de ferramentas.

Para mais informações sobre como usar a API Cloud Monitoring para criar esses widgets, consulte Painel com um widget SingleViewGroup.

Para adicionar esses widgets 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. Na barra de ferramentas do console do Google Cloud, selecione seu projeto. Para as configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta ativada por apps.
  3. Se necessário, crie os widgets que você quer adicionar ao widget do grupo.

  4. Na caixa de diálogo Adicionar widget, acesse a seção Layout e selecione Grupo de menu suspenso ou Grupo de guias.

    Um widget do tipo selecionado é adicionado ao painel.

  5. Para adicionar widgets, como um gráfico de linhas, a um widget de grupo, arraste-os para o widget de grupo ou edite o widget de grupo e realize uma operação de adição.

    Por exemplo, para adicionar widgets a um widget de grupo de guias editando o grupo, faça o seguinte:

    1. Na barra de ferramentas do widget, selecione Editar grupo de guias e Editar grupo.
    2. Opcional: insira um título para o grupo.

    3. Clique em Adicionar widget e faça uma seleção no menu Adicionar widget.

      O menu Adicionar widget lista os widgets que podem ser adicionados ao grupo.

    4. Repita a etapa anterior para cada widget que você quer adicionar ao widget do grupo de guias.

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

    6. Clique em Aplicar.

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

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

A seguir

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

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