Gerenciar widgets do painel

Para refinar a forma como os painéis personalizados no Cloud Monitoring apresentam a telemetria, é possível modificar, converter ou excluir widgets de painel usando o Google Cloud console. Por exemplo, você pode mudar um gráfico de linhas para um gráfico de áreas empilhadas para ver como cada série temporal contribui para o total, atualizar quais séries temporais um widget mostra ou editar a representação JSON de um widget.

Para gerenciar widgets de painel de forma programática, consulte Criar e gerenciar painéis por API. Para adicionar novos widgets a um painel, consulte os documentos de gráficos, tabelas e indicadores, alertas, entradas de registro, widgets de texto e grupo, e objetivos de nível de serviço (SLOs).

Antes de começar

Conclua o seguinte no Google Cloud projeto em que você quer gerenciar seus painéis:

Conferir a 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 Google Cloud console.

Para conferir ou modificar a representação JSON do 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. Escolha uma destas opções:

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

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

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

      Agora é possível conferir ou modificar o JSON. Se você fizer modificações, clique em Implementar 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 do widget. 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 esse gráfico de linhas para um gráfico de áreas empilhadas.

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 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 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 mostra dados de uma política de alertas, 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. Posicione o ponteiro no widget para ativar a barra de ferramentas, clique em Mais opções e selecione Converter em 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 realizar conversões que não sejam a conversão de um gráfico de linhas em um gráfico que mostra dados de uma política de alertas, 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. No widget cujo tipo você quer mudar, posicione o ponteiro nele para ativar a barra de ferramentas e, em seguida, clique em  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éries temporais.
    • Os widgets Visão geral e Medidor estão listados no cabeçalho Compatível com ajustes porque esses dois widgets só podem mostrar uma única série temporal, e o gráfico está mostrando várias séries temporais. Antes de converter para um desses tipos, é necessário modificar a configuração de agrupamento.
    • O widget Mapa de calor está desativado porque esses widgets só mostram 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 desses 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 quais série temporal um widget mostra ou como essas séries temporais 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 do gráfico agrupando série temporal por um ou mais rótulos.

Para modificar a configuração de um widget, 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. Edite o widget:

    • Para todos os widgets, exceto o widget de visualização única e o widget de grupo recolhível, posicione o ponteiro no widget para ativar a barra de ferramentas e clique em  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 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 os widgets 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 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 Excluir widget.
        2. Para remover um widget do grupo e movê-lo para o painel, clique em 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 rapidez com que um painel mostra os dados depende do número de widgets que o painel mostra e do número de série temporal que cada widget mostra. 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 para 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 exclui a política de alertas cujos dados foram mostrados no gráfico. Para excluir uma política de alertas, acesse a página Alertas no Google Cloud console. 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 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. Exclua o widget:

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

    • Para o widget de grupo recolhível, posicione o ponteiro nele para ativar a barra de ferramentas e faça o seguinte:

      • Para excluir o widget de grupo recolhível e os widgets que ele contém, clique em Remover grupo e os filhos.
      • Para excluir um widget de grupo recolhível e mover os widgets 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 faça o seguinte:

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

  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