Como criar e gerenciar widgets do painel

Nesta página, você verá como criar e configurar widgets de painel usando a visualização de painel do Console do Google Cloud. Todos os widgets do painel, exceto caixas de texto, podem exibir qualquer tipo de métrica que tenha valor numérico ou de distribuição, incluindo métricas personalizadas e métricas com base em registros. Os widgets do painel não podem criar gráficos de dados do tipo string.

Se você estiver interessado no Metrics Explorer, uma ferramenta alternativa para criar gráficos, consulte Como usar o Metrics Explorer.

Se você estiver interessado em usar a API Cloud Monitoring, consulte Como gerenciar painéis por API.

Antes de começar

Verifique se você tem um dos papéis descritos em Autorização.

Como projetar um painel

Ao selecionar widgets de painel, considere qual tipo de informação você quer visualizar e qual é a melhor forma de exibir esses dados:

  • Para visualizar dados de série temporal em um intervalo de tempo, adicione um gráfico de linhas, de área empilhadas, de barras empilhadas ou de mapa de calor. Os gráficos de barras empilhadas são recomendados para métricas com amostras pouco frequentes, como as métricas de cota que têm uma amostra por dia, enquanto os gráficos de mapa de calor são recomendados para métricas do tipo de distribuição.

    Nesta página, o termo gráfico refere-se apenas a gráficos de linhas, de áreas empilhadas, gráficos de barras e de mapa de calor. Nesse contexto, o termo gráfico não se refere a gráficos de alerta.

  • Para mostrar se o valor mais recente está em uma zona de perigo, em uma zona de aviso ou em um intervalo esperado, adicione um medidor ou uma visão geral.

  • Para adicionar informações sobre o painel ou o que fazer em diferentes situações, adicione uma caixa de texto.

  • Para visualizar um resumo de uma política de alertas de condição única em um painel, adicione um gráfico de alertas. Os gráficos de alerta exibem a série temporal que uma política de alertas monitora e um limite. Esses widgets também exibem chips que listam o número de incidentes associados à política e se ela está desativada.

Depois de selecionar o tipo de informação, a próxima etapa é selecionar os dados específicos que o widget será exibido. Nesta página, você verá informações gerais. Para mais informações, consulte Como selecionar dados para o gráfico.

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

Como adicionar um widget a um painel

Esta seção descreve como adicionar um widget a um painel. Para informações de configuração, consulte Como configurar um widget no painel.

Para modificar um painel, verifique se o papel de gerenciamento de identidade e acesso do projeto do escopo de um escopo de métricas inclui a permissão para edição. Para mais informações sobre papéis, consulte Controle de acesso.

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

  1. No Console do Cloud, selecione Monitoring ou clique no botão a seguir:

    Acessar o Monitoramento

  2. No painel de navegação do Monitoring, clique em Painéis:

    • Para criar um novo painel, clique em Criar painel.
    • Para atualizar um painel atual, clique no bloco do painel, se mostrado em Painéis recentes, ou encontre o painel na lista de todos os painéis e clique no nome dele.
  3. Verifique se o botão Edição é exibido. Se ela não for exibida, clique no menu Como visualizar e selecione Alternar para o modo de edição.

  4. Clique no widget da Biblioteca de gráficos que você quer adicionar ao painel. Também é possível arrastar o widget da biblioteca para a área do gráfico. Um widget pré-configurado do tipo selecionado é exibido.

    É possível modificar a configuração do widget, mudar o tamanho dele e mudar a posição dele no painel usando o ponteiro. Para todos os widgets, exceto os gráficos de alerta, também é possível alterar o tipo de widget. Por exemplo, é possível converter um gráfico de linhas em um gráfico de barras empilhadas.

    A captura de tela a seguir ilustra um gráfico de linhas e o painel de configuração correspondente.

    Exemplo de um gráfico de linhas adicionado a um painel.

  5. Configure o widget usando o painel de configuração do widget exibido quando o painel é editável e o widget é selecionado:

    • Para configurar rapidamente um widget, use o modo Básico. Essa opção tem opções de configuração mínimas. Uma configuração básica sempre pode ser representada nos outros modos.

    • Para ter acesso a todos os campos de configuração de widgets, use o modo Avançado. Ele fornece acesso à maioria dos campos de agregação. Esse modo não está disponível para todos os tipos de widgets. Talvez uma configuração avançada não possa ser representada no modo mais simples Básico.

    • Para configurar um widget usando MQL, use o modo MQL. Uma configuração MQL talvez não seja representada nos outros modos.

  6. (Opcional) Na barra de ferramentas do painel, clique em Adicionar gráfico para ativar a Biblioteca de gráficos e repita as etapas anteriores para cada widget que você quiser adicionar. ao painel.

Como configurar um widget do painel

Nesta seção, descrevemos como configurar widgets de painel usando os seletores do Console do Google Cloud. Também é possível criar um gráfico ou alterar a configuração de um widget de painel editando a representação JSON do painel.

Como configurar um gráfico

Nesta seção, descrevemos como configurar gráficos de linha, gráficos de área empilhados, gráficos de barras e gráficos de mapa de calor. Para mais informações sobre como adicionar um gráfico ao seu painel usando o Console do Google Cloud, consulte Etapas gerais para adicionar um widget a um painel. Se você estiver interessado em usar a API Cloud Monitoring, consulte Painel com um widget XyChart.

Básico

Para configurar um gráfico de linhas, áreas empilhadas, barras ou mapa de calor usando o modo Básico, faça o seguinte:

  1. Selecione os dados da série temporal que você quer ver:

    • Para modificar o Tipo de recurso e a Métrica, selecione nos menus. O menu Tipo de recurso lista todos os recursos monitorados para dados de métricas. O menu Métrica determina as seleções para o Tipo de recurso.

      • Para encontrar uma entrada específica em um menu, use a barra de rolagem ou insira o texto na área Filtro do menu. Quando você insere texto, as entradas do menu são limitadas às entradas que incluem o texto inserido.

      • Se você quiser acessar um tipo de recurso ou uma métrica que ainda não tem dados, altere o comportamento padrão:

        • Para selecionar qualquer tipo de recurso, expanda o menu Tipo de recurso e desmarque Mostrar apenas ativo.

        • Para visualizar todas as métricas do tipo de recurso selecionado, mesmo aquelas sem dados, expanda o menu Métrica e desmarque Mostrar apenas ativas.

        • Para selecionar qualquer métrica, clique em Fechar no menu Tipo de recurso e encontre a entrada relevante. , Ao clicar em "Fechar" no tipo de recurso, o menu Métrica inclui todas as métricas.

        • Para visualizar ou editar o tipo de recurso e as configurações de métrica usadas pela API Cloud Monitoring, no menu Tipo de recurso, clique em Modo de filtro direto.

      Para mais informações sobre a seleção de métricas, consulte Como selecionar dados no gráfico.

    • Para adicionar um filtro, clique em Adicionar um filtro e selecione o rótulo e o valor dele. É possível adicionar vários filtros. Por exemplo, é possível ver os dados de uma zona aplicando um filtro. Para mais informações sobre filtros, consulte Filtrar dados gráficos.

  2. Escolha se você quer visualizar todas as séries temporais ou se quer agrupar séries temporais por valores de rótulos.

    • Para exibir todas as séries temporais, deixe Agrupado claro.
    • Para agrupar séries temporais por valores de rótulo, selecione Agrupado e use o menu Agrupar por para selecionar os rótulos para agrupamento. Depois de fazer as seleções, clique em OK.
  3. Determine como combinar pontos de dados:

    • Se os botões de opção exibirem apenas percentis, você selecionou uma métrica que tem um valor de distribuição. Use os botões de opção para selecionar o percentil da distribuição que será visualizado.

    • Se os botões de opção exibirem mean, min e max, significa que você selecionou uma métrica com um valor numérico. Use esses botões para especificar como os pontos de dados são combinados como parte do processo de criação de gráficos. Por exemplo, se um gráfico exibir 60 pontos de dados e dados forem gravados em 1 ponto por minuto, o gráfico poderá exibir uma hora de dados. Para exibir 3 horas de dados, você precisa reduzir 180 pontos para 60 segundos. Quando esse seletor é mean, cada ponto no gráfico é a média de três pontos na série temporal original.

  4. (Opcional) Para alterar o eixo Y do eixo direito para o esquerdo, clique em Eixo Y e selecione Esquerda.

    Se você configurar um gráfico para exibir várias métricas, verifique se todas as métricas mapeadas para o mesmo eixo Y têm as mesmas unidades. Para mais informações, consulte O gráfico com várias métricas exibe uma mensagem de erro.

  5. Opcional: para configurar como os dados são exibidos em um gráfico, clique em Configurações :

    Para informações sobre as legendas de gráficos, consulte Como configurar legendas.

  6. (Opcional) Você pode exibir várias métricas em um único gráfico. Se você quiser exibir outra métrica no mesmo gráfico, clique em Adicionar outra métrica e repita as etapas anteriores. Um gráfico pode exibir no máximo 10 métricas.

Avançado

Se você estiver usando o modo Avançado e selecionar o modo Básico, talvez apareçam mensagens de erro. Eles são exibidos quando a configuração selecionada no modo Avançado não pode ser representada com as opções disponíveis no modo Básico.

Para configurar um gráfico de linhas, áreas empilhadas, barras ou mapa de calor usando o modo Avançado, faça o seguinte:

  1. Selecione os dados da série temporal que você quer ver:

    • Para modificar o Tipo de recurso e a Métrica, selecione nos menus. O menu Tipo de recurso lista todos os recursos monitorados para dados de métricas. O menu Métrica determina as seleções para o Tipo de recurso.

      • Para encontrar uma entrada específica em um menu, use a barra de rolagem ou insira o texto na área Filtro do menu. Quando você insere texto, as entradas do menu são limitadas às entradas que incluem o texto inserido.

      • Se você quiser acessar um tipo de recurso ou uma métrica que ainda não tem dados, altere o comportamento padrão:

        • Para selecionar qualquer tipo de recurso, expanda o menu Tipo de recurso e desmarque Mostrar apenas ativo.

        • Para visualizar todas as métricas do tipo de recurso selecionado, mesmo aquelas sem dados, expanda o menu Métrica e desmarque Mostrar apenas ativas.

        • Para selecionar qualquer métrica, clique em Fechar no menu Tipo de recurso e encontre a entrada relevante. , Ao clicar em "Fechar" no tipo de recurso, o menu Métrica inclui todas as métricas.

        • Para visualizar ou editar o tipo de recurso e as configurações de métrica usadas pela API Cloud Monitoring, no menu Tipo de recurso, clique em Modo de filtro direto.

      Para mais informações sobre a seleção de métricas, consulte Como selecionar dados no gráfico.

    • Para adicionar um filtro, clique em Adicionar um filtro e selecione o rótulo e o valor dele. É possível adicionar vários filtros. Por exemplo, é possível ver os dados de uma zona aplicando um filtro. Para mais informações sobre filtros, consulte Filtrar dados gráficos.

  2. Selecione como as séries temporais são pré-processadas.

    As opções de pré-processamento são exibidas quando a métrica selecionada tiver um tipo de métrica de delta ou cumulativa. As opções específicas disponíveis são determinadas pelo tipo de valor do serviço.

    Em geral, essa configuração pode ser deixada com o valor padrão.

    Quando as opções de pré-processamento estiverem disponíveis, use os botões de opção para especificar como você quer que os dados brutos sejam processados antes dos dados serem alinhados. No exemplo a seguir, mostramos as opções quando as séries temporais de uma métrica DELTA são exibidas:

    Mostrar as opções de pré-processamento para uma métrica acumulativa.

    Nesse caso, se você selecionar Rate, os valores dos dados serão divididos pela taxa de amostragem. Se você selecionar No preprocessing step, os valores dos dados não serão dimensionados pela taxa de amostragem. Por exemplo, se as unidades da métrica forem MiB, selecionar rate mudará as unidades para MiB por segundo. Para mais informações e um exemplo, consulte Tipos e conversões.

  3. Selecione os parâmetros de alinhamento.

    Em geral, esses campos podem ser deixados com os valores padrão. Para mais informações, consulte Alinhamento: regularização em série.

  4. Escolha se você quer visualizar todas as séries temporais ou se quer agrupar séries temporais por valores de rótulos.

    • Para combinar todas as séries temporais em uma única série temporal, verifique se Agrupar por está vazio e selecione como as séries temporais são combinadas usando a opção Agrupar por função. .

      Você precisará usar essa opção se estiver exibindo séries temporais em um gráfico de mapa de calor. Para mais informações, consulte Como gerar gráficos de métricas de distribuição.

    • Para exibir todas as séries temporais, siga um destes procedimentos:

      • Verifique se a opção Agrupar por está vazia e selecione none em Agrupar por função.
      • Clique no menu Agrupar por, selecione Adicionar tudo e selecione no menu Agrupar por função. Para métricas que armazenam um valor numérico, a escolha da função de agrupamento pode não produzir um gráfico visivelmente diferente.
    • Para agrupar séries temporais por valores de rótulo específicos, clique em Agrupar por e selecione os rótulos para agrupamento. Para especificar como a série temporal é combinada, selecione uma função usando o menu Agrupar por função.

    Para informações gerais sobre o alinhamento e o agrupamento, consulte Como escolher como exibir os dados.

  5. (Opcional) Para alterar o eixo Y do eixo direito para o esquerdo, clique em Eixo Y e selecione Esquerda.

    Se você configurar um gráfico para exibir várias métricas, verifique se todas as métricas mapeadas para o mesmo eixo Y têm as mesmas unidades. Para mais informações, consulte O gráfico com várias métricas exibe uma mensagem de erro.

  6. Opcional: para configurar como os dados são exibidos em um gráfico, clique em Configurações :

    Para informações sobre as legendas de gráficos, consulte Como configurar legendas.

  7. (Opcional) Você pode exibir várias métricas em um único gráfico. Se você quiser exibir outra métrica no mesmo gráfico, clique em Adicionar outra métrica e repita as etapas anteriores. Um gráfico pode exibir no máximo 10 métricas.

MQL

MQL é uma linguagem mais expressiva do que a linguagem de filtro usada pelos modos Basic e Advanced. Se você configurar um gráfico usando o MQL e selecionar um modo diferente, uma caixa de diálogo será exibida quando você perder a configuração do MQL. Essa caixa de diálogo oferece opções de cancelar ou continuar com a alteração de modos.

Ao usar o MQL para configurar gráficos de mapa de calor, configure as opções de agregação para combinar todas as séries temporais. Se o gráfico do mapa de calor exibir Your MQL Query has too many time series, modifique as configurações de agregação para combinar todas as séries temporais.

Para mais informações sobre o uso do MQL, consulte Introdução ao MQL.

Como configurar um medidor ou uma visão geral

Esta seção descreve como configurar um medidor ou uma visão geral. Para mais informações sobre como adicionar um desses widgets ao seu painel usando o Console do Google Cloud, consulte Etapas gerais para adicionar um widget a um painel. Se você estiver interessado em usar a API Cloud Monitoring, consulte Painel com um Scorecard básico.

Básico

Para configurar um medidor ou visão geral usando o modo Básico, faça o seguinte:

  1. Selecione o widget para ativar o painel de configuração.

  2. Selecione os dados da série temporal que você quer ver:

    • Para modificar o Tipo de recurso e a Métrica, selecione nos menus. O menu Tipo de recurso lista todos os recursos monitorados para dados de métricas. O menu Métrica determina as seleções para o Tipo de recurso.

      • Para encontrar uma entrada específica em um menu, use a barra de rolagem ou insira o texto na área Filtro do menu. Quando você insere texto, as entradas do menu são limitadas às entradas que incluem o texto inserido.

      • Se você quiser acessar um tipo de recurso ou uma métrica que ainda não tem dados, altere o comportamento padrão:

        • Para selecionar qualquer tipo de recurso, expanda o menu Tipo de recurso e desmarque Mostrar apenas ativo.

        • Para visualizar todas as métricas do tipo de recurso selecionado, mesmo aquelas sem dados, expanda o menu Métrica e desmarque Mostrar apenas ativas.

        • Para selecionar qualquer métrica, clique em Fechar no menu Tipo de recurso e encontre a entrada relevante. , Ao clicar em "Fechar" no tipo de recurso, o menu Métrica inclui todas as métricas.

        • Para visualizar ou editar o tipo de recurso e as configurações de métrica usadas pela API Cloud Monitoring, no menu Tipo de recurso, clique em Modo de filtro direto.

      Para mais informações sobre a seleção de métricas, consulte Como selecionar dados no gráfico.

    • Para adicionar um filtro, clique em Adicionar um filtro e selecione o rótulo e o valor dele. É possível adicionar vários filtros. Por exemplo, é possível ver os dados de uma zona aplicando um filtro. Para mais informações sobre filtros, consulte Filtrar dados gráficos.

  3. Especifica como as séries temporais selecionadas são combinadas em um único valor.

    Use os botões de opção para especificar como os dados de diferentes séries temporais são combinados. Para calcular a média dos dados, selecione mean.

  4. Configure os níveis de aviso e de limite de um medidor ou de uma visão geral:

    • Para medidores, insira os valores mínimo e máximo para a métrica. Quando o medidor exibir uma porcentagem, defina esses valores como 0 e 1, respectivamente.

    • Para uma visão geral, defina Visualização de gráfico do Spark. Todas as opções exibem as mais recentes.

      • Linha: mostra um gráfico de linhas.
      • Barra: mostra um gráfico de barras.
      • ícone: mostra um ícone verde, âmbar ou vermelho.
      • Valor: exibe apenas o valor.
    • Para medidores e visões gerais, configure os limites de alerta e de perigo:

      • Perigo acima: quando o valor estiver acima desse limite, defina como vermelho.
      • Aviso acima: quando o valor estiver acima desse limite, defina o âmbar.
      • Perigo abaixo: quando o valor for menor que esse limite, definido como vermelho.
      • Aviso abaixo: quando o valor é menor que esse limite, defina o âmbar.

      Por exemplo, a captura de tela a seguir ilustra uma configuração de um medidor com os limites de Aviso acima e de Perigo acima definidos:

      Gráfico que mostra a configuração do medidor.

      A captura de tela a seguir mostra um exemplo do medidor, quando a leitura é menor que os limites de aviso e perigo:

      Exemplo de um medidor.

      O arco externo fino exibe o intervalo de valor possível e indica as zonas de alerta e de perigo. O arco interno grosso mostra o valor atual.

Avançado

Se você estiver usando o modo Avançado e selecionar o modo Básico, talvez apareçam mensagens de erro. Eles são exibidos quando o modo Básico não representa as configurações do modo Avançado.

Para configurar um medidor ou visão geral usando o modo Avançado, faça o seguinte:

  1. Selecione os dados da série temporal que você quer ver:

    • Para modificar o Tipo de recurso e a Métrica, selecione nos menus. O menu Tipo de recurso lista todos os recursos monitorados para dados de métricas. O menu Métrica determina as seleções para o Tipo de recurso.

      • Para encontrar uma entrada específica em um menu, use a barra de rolagem ou insira o texto na área Filtro do menu. Quando você insere texto, as entradas do menu são limitadas às entradas que incluem o texto inserido.

      • Se você quiser acessar um tipo de recurso ou uma métrica que ainda não tem dados, altere o comportamento padrão:

        • Para selecionar qualquer tipo de recurso, expanda o menu Tipo de recurso e desmarque Mostrar apenas ativo.

        • Para visualizar todas as métricas do tipo de recurso selecionado, mesmo aquelas sem dados, expanda o menu Métrica e desmarque Mostrar apenas ativas.

        • Para selecionar qualquer métrica, clique em Fechar no menu Tipo de recurso e encontre a entrada relevante. , Ao clicar em "Fechar" no tipo de recurso, o menu Métrica inclui todas as métricas.

        • Para visualizar ou editar o tipo de recurso e as configurações de métrica usadas pela API Cloud Monitoring, no menu Tipo de recurso, clique em Modo de filtro direto.

      Para mais informações sobre a seleção de métricas, consulte Como selecionar dados no gráfico.

    • Para adicionar um filtro, clique em Adicionar um filtro e selecione o rótulo e o valor dele. É possível adicionar vários filtros. Por exemplo, é possível ver os dados de uma zona aplicando um filtro. Para mais informações sobre filtros, consulte Filtrar dados gráficos.

  2. Selecione os parâmetros de alinhamento.

    Em geral, esses campos podem ser deixados com os valores padrão. Para mais informações, consulte Alinhamento: regularização em série.

  3. Selecione a função agrupar por. Essa função combina todas as séries temporais juntas.

  4. Configure os níveis de aviso e de limite de um medidor ou de uma visão geral:

    • Para medidores, insira os valores mínimo e máximo para a métrica. Quando o medidor exibir uma porcentagem, defina esses valores como 0 e 1, respectivamente.

    • Para uma visão geral, defina Visualização de gráfico do Spark. Todas as opções exibem as mais recentes.

      • Linha: mostra um gráfico de linhas.
      • Barra: mostra um gráfico de barras.
      • ícone: mostra um ícone verde, âmbar ou vermelho.
      • Valor: exibe apenas o valor.
    • Para medidores e visões gerais, configure os limites de alerta e de perigo:

      • Perigo acima: quando o valor estiver acima desse limite, defina como vermelho.
      • Aviso acima: quando o valor estiver acima desse limite, defina o âmbar.
      • Perigo abaixo: quando o valor for menor que esse limite, definido como vermelho.
      • Aviso abaixo: quando o valor é menor que esse limite, defina o âmbar.

      Por exemplo, a captura de tela a seguir ilustra uma configuração de um medidor com os limites de Aviso acima e de Perigo acima definidos:

      Gráfico que mostra a configuração do medidor.

      A captura de tela a seguir mostra um exemplo do medidor, quando a leitura é menor que os limites de aviso e perigo:

      Exemplo de um medidor.

      O arco externo fino exibe o intervalo de valor possível e indica as zonas de alerta e de perigo. O arco interno grosso mostra o valor atual.

MQL

MQL é uma linguagem mais expressiva do que a linguagem de filtro usada pelos modos Basic e Advanced. Se você configurar um gráfico usando o MQL e selecionar um modo diferente, uma caixa de diálogo será exibida quando você perder a configuração do MQL. Essa caixa de diálogo oferece opções de cancelar ou continuar com a alteração de modos. Para mais informações, consulte Introdução ao MQL.

Ao usar o MQL para configurar medidores e visões gerais, não se esqueça de configurar as opções de agregação para combinar todas as séries temporais. Se o widget exibir Your MQL Query has too many time series, modifique as configurações de agregação para combinar todas as séries temporais.

Por exemplo, veja a consulta sobre a utilização da CPU de uma instância de VM. Essa consulta agrupa os dados por zona e, em seguida, calcula a média dos dados em cada zona.

fetch gce_instance
 | metric 'compute.googleapis.com/instance/cpu/utilization'
 | group_by [zone], mean(val())

Quando todas as instâncias de VM estiverem na mesma zona, um medidor ou uma visão geral poderão exibir os dados solicitados. No entanto, se as instâncias de VM estiverem em várias zonas, esses widgets exibirão a mensagem de erro Your MQL Query has too many time series.

Para resolver essa condição de erro, verifique se a última cláusula group_by combina todas as séries temporais:

fetch gce_instance
 | metric 'compute.googleapis.com/instance/cpu/utilization'
 | group_by [zone], mean(val())
 | every 1m
 | group_by [], max(val())

Na última cláusula group_by, o primeiro argumento, [], especifica que todas as séries temporais devem ser combinadas e o segundo argumento, max(val()), define como as séries temporais serão a combinação. Após a conclusão da operação de agrupamento, haverá uma série temporal.

Como configurar uma caixa de texto

Esta seção descreve como configurar uma caixa de texto. Para mais informações sobre como adicionar uma caixa de texto ao seu painel usando o Console do Google Cloud, consulte Etapas gerais para adicionar um widget a um painel. Se você estiver interessado em usar a API Cloud Monitoring, consulte Painel com um widget Text.

O widget de caixa de texto é compatível com um conjunto limitado de comandos do Markdown:

  • Para criar um cabeçalho, use #. É possível usar vários sinais de hash para diferentes níveis de cabeçalho:

      # Header
      ## Second heading
      ### Third heading
    
  • Para exibir a fonte em itálico, use *italic* ou _italic_.

  • Para exibir a fonte em negrito, use **bold** ou __bold__.

  • Para adicionar um link, use [link text](absolute URL). Você pode usar qualquer valor para link text, mas precisa usar o URL absoluto.

    Por exemplo, é possível escrever [cloud.google.com](https://cloud.google.com/) para vincular a cloud.google.com.

Como configurar um gráfico de alertas

Para configurar um gráfico de alertas, associe-o a uma política de alertas de condição única. Para mais informações sobre como adicionar um gráfico de alertas ao painel usando o Console do Google Cloud, consulte Etapas gerais para adicionar um widget a um painel. Se você quiser usar a API Cloud Monitoring, consulte Painel com um widget AlertChart.

Para associar um gráfico de alertas a uma política de alertas, no painel de configuração do widget Gráfico de alertas, use o menu Política de alertas para selecionar um alerta. Se uma política de alertas não puder ser selecionada no menu, um gráfico de alerta não poderá representar essa política.

Depois de selecionar uma política de alertas, serão exibidos dados de série temporal, um limite e ícones que mostram o número de incidentes em aberto e se a política está desativada. A captura de tela a seguir ilustra um gráfico de alerta:

Exemplo de um gráfico de alertas.

A captura de tela anterior ilustra um gráfico de alerta para uma política de alertas que está monitorando o uso da CPU de duas máquinas virtuais diferentes. A linha vermelha tracejada mostra o limite de condição, que é definido como 50%. O ícone verde com o rótulo No incidents indica que não há incidentes abertos para a política de alertas.

Para ver informações sobre a política de alertas exibida em um gráfico de alertas, siga um destes procedimentos:

  • Para ativar uma dica que exibe os detalhes do alerta, coloque o ponteiro em uma entrada no menu Política de alertas.
  • Para acessar a página de detalhes da política de alertas, clique no ícone de incidentes e selecione Ver política de alertas.

Para ver detalhes sobre a configuração do gráfico de alertas, clique em Mais opções e selecione Visualizar no Metrics Explorer. No Metrics Explorer, é exibido um gráfico de linhas com a mesma configuração de métrica e filtro que o gráfico de alerta. Se você modificar o gráfico exibido no Metrics Explorer, não será possível aplicar essas alterações à política de alertas ou ao gráfico de alertas exibido em um painel.

Se você usar a API Cloud Monitoring e quiser a representação JSON de um gráfico de alertas, clique em Editor JSON na barra de ferramentas do painel.

Como alterar um tipo de widget

As restrições a seguir se aplicam à alteração dos tipos de widget:

  • Os widgets do gráfico de alertas não podem ser convertidos em outro tipo.
  • Não é possível converter widgets de gráfico de alerta em um widget de gráfico de alerta.
  • Os gráficos de linhas configurados para usar o eixo Y esquerdo só podem ser convertidos em gráficos de barras empilhadas ou gráficos de área empilhadas.

Para alterar o tipo de um widget, faça o seguinte:

  1. Verifique se o botão Edição é exibido. Se ela não for exibida, clique no menu Como visualizar e selecione Alternar para o modo de edição.
  2. Selecione o widget.
  3. No painel de configuração, selecione o tipo de widget atual. Por exemplo, se você estiver vendo um gráfico de linhas, no painel de configuração, selecione Gráfico de linhas.

  4. Selecione o novo tipo de widget no menu.

    O menu de opções lista todos os tipos de widget que podem representar graficamente os dados da métrica. No entanto, um tipo de widget é desativado quando não é possível exibir os dados selecionados. Por exemplo, se a métrica selecionada não tiver valor de distribuição, a opção de mapa de calor será desativada. Da mesma forma, se o widget atual estiver exibindo mais de uma série temporal, as opções de medidor e de visão geral serão desativadas.

Se um tipo de widget estiver desativado no menu, você poderá alterar para esse tipo de widget depois de modificar a configuração do widget atual. Por exemplo, se você tiver um gráfico de linhas com séries temporais agrupadas por zona, para visualizar esses dados com um medidor, remova o rótulo de agrupamento e selecione uma função de agrupamento antes de alterar o tipo de widget.

Como editar um widget do painel

Para editar um widget, siga estas instruções:

  1. Verifique se o botão Edição é exibido. Se ela não for exibida, clique no menu Como visualizar e selecione Alternar para o modo de edição.

  2. Selecione o widget para ativar o painel de configuração dele.

  3. (Opcional). Se você quiser editar o widget usando o editor de JSON, clique em Editor de JSON para abrir esse editor.

  4. Modifique o widget usando o painel de configuração dele ou o editor JSON:

    • Se você usar o painel de configuração, suas alterações serão salvas automaticamente, a menos que você desative o salvamento automático. Se você estiver modificando um gráfico, consulte Como definir opções de exibição para saber como configurar a aparência de um gráfico.
    • Se você usar o editor JSON, clique em Aplicar alterações para salvá-las. Por padrão, somente a seção específica do gráfico do JSON é expandida. Para ver toda a definição do painel, clique em Mostrar mais:

      Ilustração do botão de expansão no editor JSON.

Como excluir um widget do painel

Para excluir um modelo, siga estas instruções:

  1. Verifique se o botão Edição é exibido. Se ela não for exibida, clique no menu Como visualizar e selecione Alternar para o modo de edição.
  2. Selecione o widget que você quer excluir.
  3. Na barra de ferramentas do gráfico, selecione Excluir .

A seguir