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 informações sobre a API Cloud Monitoring, consulte Criar e gerenciar painéis por API.

Esse recurso é compatível apenas com Google Cloud projetos. Para App Hub configurações, selecione o projeto host do App Hub ou o projeto de gerenciamento.

Antes de começar

Conclua as etapas a seguir no Google Cloud projeto 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 nesta seção são para o Google Cloud console. 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 Google Cloud console, acesse a página  Painéis:

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

  7. No painel Conteúdo, insira o texto que você quer exibir.

    Para informações de formatação, consulte Sintaxe de Markdown.

  8. Opções: use os campos no painel Exibir para personalizar seu 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, na barra de ferramentas, clique em Salvar.

Sintaxe de Markdown

Esta seção descreve a maior parte da sintaxe de Markdown compatível com o widget de texto. As tags HTML não são compatíveis.

  • 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çalho. 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.

  • Parágrafos

    Para criar um novo parágrafo, use uma linha em branco.

  • Ênfase

    • Itálico: use *italic* ou _italic_.
    • Negrito: use **bold** ou __bold__.
    • Negrito e itálico: use ***bold and italic***.
    • Fonte fixa: use acentos graves, `fixed font`.

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

    É possível usar qualquer valor para o link text. O valor de path precisa referenciar uma âncora HTML no painel ou ser um URL para uma página externa.

    • Para criar um link para 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 criar um link para uma seção com o título "Gráficos usando variáveis", defina o path como #charts-using-variables.

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

  • Listas: é possível criar listas ordenadas ou não ordenadas e aninhar listas.

    • Para listas ordenadas, prefixe cada item da lista com 1.. Quando o texto é renderizado, os elementos são numerados sequencialmente. Por exemplo:

      1. Ordered list item 1
1. Ordered list item 2

    • Para listas não ordenadas, prefixe cada item da lista com um sinal de mais (+), um traço (-) ou um asterisco (*). Por exemplo:

      + Unordered list item 1
+ Unordered list item 2

    • Para aninhar listas, indente a lista aninhada. Por exemplo:

      1.  Item 1
    + Nested unordered-list item 1
    + Nested unordered-list item 2
1.  Item 2
    1. Nested ordered-list item 1
    1. Nested ordered-list item 2

  • Variáveis: formato 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 seja zone e o valor seja us-west1, o widget de texto vai exibir us-west1.

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

    Variáveis não reconhecidas são exibidas conforme escritas e não são renderizadas.

  • Como usar caracteres de escape

    Alguns caracteres, como sinais de mais (+), são convertidos em elementos de lista. Se você quiser exibir esses tipos de caracteres literalmente, use uma barra invertida para escapar do caractere, \+.

Organizar widgets do painel

Os painéis personalizados permitem especificar a posição dos gráficos, políticas de alertas e outros widgets. No entanto, é possível melhorar a usabilidade de um painel com muitos widgets criando seções 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, um sumário é criado e um divisor horizontal é adicionado ao painel. O sumário permite navegar até uma seção específica do painel. Cada widget de seção contém uma âncora. Ao solucionar 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 cabeçalho, e selecione Copiar endereço do link.

  • Para reduzir o tempo de carregamento de um painel, use widgets de grupo. Há três tipos de widgets de grupo: recolhível, suspenso e de guia. Os widgets de grupo contêm uma coleção de widgets e melhoram o desempenho usando dados de prioridade mais baixa para recuperar membros da coleção que não são exibidos. O widget de grupo recolhível mostra todos os membros da coleção quando ela é expandida. Caso contrário, todos os membros ficam ocultos. Em contraste, os widgets de menu suspenso e de grupo de guias 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 de mosaico, que é o layout padrão. Se você mudar o layout para uma grade, esses widgets não estarão disponíveis.

Para a 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 informações sobre como usar a API Cloud Monitoring para criar um widget de cabeçalho de seção, consulte Painel com um SectionHeader widget.

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

  1. No Google Cloud console, acesse a página  Painéis:

    Acesse 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 Google Cloud console, selecione seu Google Cloud projeto. Para App Hub configurações, selecione o projeto host do App Hub ou o projeto de gerenciamento.
  3. Na caixa de diálogo Adicionar widget , acesse a seção Layout e selecione o widget Cabeçalho de seção.

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

    • O valor do campo Nome da seção é mostrado na tabela de conteúdo.
    • O valor do campo Subtítulo é mostrado no painel.
    • Se você selecionar *Adicionar um divisor ao sumário, então uma linha horizontal será adicionada após a entrada no sumário.

Adicionar widgets de grupo recolhível

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

Para adicionar um widget de grupo recolhível usando o Google Cloud console, faça o seguinte:

  1. No Google Cloud console, acesse a página  Painéis:

    Acesse 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 Google Cloud console, selecione seu Google Cloud projeto. Para App Hub configurações, selecione o projeto host do App Hub ou o projeto de gerenciamento.
  3. Na caixa de diálogo Adicionar widget , acesse a seção Layout e selecione Grupo recolhível.

  4. Para adicionar um widget ao grupo, arraste o widget para o grupo.

    Depois de adicionar widgets ao grupo, é possível usar o ponteiro para redimensionar e reposicionar esses widgets.

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

  6. Opcional: para forçar o grupo a ser recolhido por padrão, posicione o ponteiro no widget para ativar a barra de ferramentas e, em seguida, clique em Recolher grupo.

    Quando um widget de grupo recolhível é recolhido, o Monitoring 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 menu suspenso ou de grupo de guias

Os widgets de menu suspenso e de grupo de guias contêm uma coleção de outros widgets, mas mostram apenas um membro da coleção. A diferença entre esses widgets é como você seleciona qual membro da coleção é mostrado. Os grupos suspensos fornecem um menu, enquanto os grupos de guia fornecem guias na barra de ferramentas.

Para 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 Google Cloud console, acesse a página  Painéis:

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

  4. Na caixa de diálogo Adicionar widget , acesse a seção Layout e selecione Grupo 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 execute uma operação de adição.

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

    1. Na barra de ferramentas do widget, selecione Editar grupo de guias, e em seguida, selecione 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 de grupo de guia.

    5. Use os botões Inferior e Superior 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 mostrado permite editar o widget mostrado ou executar outras ações.

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

A seguir

Também é possível adicionar widgets aos painéis personalizados que mostram o seguinte:

Para informações sobre como analisar dados em gráficos e filtrar seus painéis, consulte os seguintes documentos: