Como criar e gerenciar widgets do painel

O foco desta página é criar e editar gráficos na visualização do painel. Se você estiver interessado no Metrics Explorer, uma ferramenta alternativa para criar gráficos, consulte Como usar o Metrics Explorer.

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 conseguem criar um gráfico de dados do tipo string. A captura de tela a seguir é um exemplo de gráfico de linhas no modo de cor. Para esses gráficos, uma cor única é atribuída a cada série temporal.

Exemplo de um gráfico de linha no modo de cor.

Antes de começar

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

Como selecionar seu editor de painel

Há dois editores de painel: Visualização e Clássico.

  • Clássico: com este editor, os painéis são otimizados para gráficos de linhas e exibem gráficos em um padrão de grade. É possível converter um gráfico de um tipo de widget para outro. Por exemplo, é possível converter um gráfico de linhas em um gráfico de barras empilhadas. Você pode ver, mas não pode criar ou modificar, visões gerais, medidores ou caixas de texto.

    Para usar esse editor, selecione Clássico no painel de detalhes.

    Para mudar para o editor de visualização, clique em Clássico no painel de detalhes e selecione Visualizar novo editor do painel:

    Selecione a edição da visualização.

  • Visualização: com esse editor, os painéis têm um conjunto avançado de widgets e opções flexíveis de tamanho e posicionamento para gráficos. Com esse editor, você pode criar e editar visões gerais, medidores e caixas de texto. No entanto, não é possível converter um tipo de widget em um tipo diferente. Por exemplo, não é possível converter um gráfico de linhas em um gráfico de barras empilhadas.

    Ao adicionar widgets a um painel, você tem várias opções de configuração:

    • Para configurar rapidamente um widget, use o modo Básico. Essa opção tem opções de configuração mínimas.

    • Para ter acesso a todos os campos de configuração de widgets, use o modo Avançado. Esse modo fornece acesso à maioria dos campos de agregação.

    • Para configurar um widget usando uma linguagem de consulta, use o modo MQL.

    Para usar esse editor, selecione Visualização no painel de detalhes.

    Para mudar para o editor clássico, clique em Visualização no painel de detalhes e selecione Visualizar editor clássico do painel:

    Selecione a edição clássica.

Como adicionar um widget ao painel

O processo de criação de um painel envolve as seguintes tarefas:

  1. Determinar que tipo de informações você quer ver e 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. Os mapas de calor são recomendados para métricas do tipo de distribuição. Com esses gráficos, é possível visualizar todas as linhas percentuais de distribuição e sobreposição.

      Configure esses gráficos para exibir um limite, mostrar apenas outliers ou comparar dados atuais com dados passados.

    • 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. É possível criar e modificar esses widgets usando o editor de Visualização ou a API Cloud Monitoring.

    • Para adicionar informações sobre o painel ou o que fazer em diferentes situações, adicione uma caixa de texto. É possível criar e editar esse widget usando o editor de Visualização ou a API Cloud Monitoring.

    Para exemplos dos tipos de widgets, consulte Widgets de painel.

  2. Identificar os dados específicos a serem exibidos no gráfico. Para mais informações, consulte Como selecionar dados para o gráfico.

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

Etapas gerais para adicionar um widget a um painel

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

Editor de visualização

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 Monitoring

  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. Certifique-se de que a barra de ferramentas do painel exiba Visualização e que o botão Editar esteja na posição ativado .

  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 será exibido. No entanto, é possível modificar a configuração.

    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.

    Usando o ponteiro, é possível alterar o tamanho do widget e a posição dele no painel.

  5. Configure o widget usando o painel de configuração do widget. O painel de configuração é exibido quando o painel está no modo de edição 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. Esse modo 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 uma linguagem de consulta, use o modo MQL. Com esse modo, você tem acesso ao Editor de consultas. Se você usar o MQL, essa configuração não poderá ser representada pelos outros modos. Para informações sobre o MQL, consulte Introdução ao MQL.

  6. Clique em Salvar painel.

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

Editor clássico

Para adicionar um gráfico de linhas, de área empilhado, de barras ou de mapa de calor a um painel, faça o seguinte:

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

    Acessar Monitoring

  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 a barra de ferramentas do painel exibe Clássico.

  4. Na visualização de detalhes de um painel, clique em Adicionar gráfico. Se você tiver permissões de edição para o espaço de trabalho, este botão estará na barra de ferramentas do painel.

  5. Configurar o gráfico.

  6. Clique em Save.

Como configurar um widget do painel

Nesta seção, descrevemos como configurar os widgets do painel.

Como configurar um gráfico

Nesta seção, descrevemos como configurar um gráfico. 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.

Editor de visualização

Para configurar um gráfico de linhas, de área empilhado, de barras ou de mapa de calor, faça o seguinte:

Como configurar um gráfico com o modo Básico

  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 é determinado pela seleção do 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 àquelas 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 ativos.

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

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

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

    • 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, consulte Como selecionar dados para o gráfico.

  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 a opção Agrupado desmarcada.
    • Para agrupar séries temporais por valores de rótulos, marque Agrupados e use o menu Agrupar por para selecionar os rótulos para agrupamento. Depois de fazer suas seleções, clique em OK.

  3. Determine como combinar pontos de dados:

    • Se os botões de opção listarem somente percentis, significa que 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 listarem mean, min e max, 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 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.

Como configurar um gráfico com o modo Avançado

  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 é determinado pela seleção do 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 àquelas 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 ativos.

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

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

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

    • 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, consulte Como selecionar dados para o gráfico.

  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, a seleção é definida como Delta:

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

    A diferença entre selecionar delta e rate são as unidades. Quando rate é selecionado, os dados são transformados em uma métrica delta e, em seguida, os valores são divididos pela taxa de amostragem. Por exemplo, se as unidades y-axis forem MiB quando delta for selecionado, 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, garanta que a opção Agrupar por esteja vazia e selecione como as séries temporais são combinadas usando o menu Agrupar por função.

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

      • Verifique se a opção Agrupar por está vazia e selecione none para a opção Agrupar por função.
      • Clique no menu Agrupar por e selecione Adicionar tudo. Em seguida, 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 as séries temporais são combinadas, 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 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.

Editor clássico

Para configurar um gráfico de linhas, de área empilhado, de barras ou de mapa de calor, faça o seguinte:

  1. Especifique os dados que aparecerão no gráfico:

    1. Certifique-se de que a guia Metric esteja selecionada.

      Exibir a guia de seleção de métricas.

    2. Preencha a caixa Encontrar tipo de recurso e métrica. É possível selecionar valores nos menus ou inserir o nome.

    3. (Opcional) Selecione um subconjunto de dados usando o campo Filtro.

    4. (Opcional) Modifique as configurações padrão de agregação. Os campos de agregação definem como várias séries temporais são combinadas e como cada série temporal é processada.

      • Para agrupar séries temporais por um rótulo, use o campo Agrupar por. Selecionar um valor para esse campo seleciona automaticamente um valor para o campo Agregador.
      • Para especificar como várias séries temporais são combinadas, defina o campo Agregador.
      • Para configurar o algoritmo de processamento para séries temporais individuais, clique em Opções avançadas.

    Para informações detalhadas sobre esses campos, consulte Como selecionar dados para o gráfico.

  2. (Opcional) A opção de visualização padrão de um gráfico é um gráfico de linhas exibido no modo de cor. No entanto, é possível alterar essas duas configurações:

    • Para alterar o modo de gráfico, selecione a guia Opções de visualização e selecione no menu. As opções disponíveis são definidas dinamicamente com base no estilo de exibição do gráfico. Para mais informações sobre suas opções, consulte Opções de visualização.

    • Para alterar o estilo de exibição de um gráfico, clique em Linha para expandir o menu suspenso. Depois de fazer uma seleção, ela estará listada ao lado do menu suspenso. Para exemplos de todos os tipos de gráfico , consulte Tipos de gráfico.

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

  4. (Opcional) Atualize o Título do gráfico. Por padrão, o título do gráfico é gerado pelas seleções de métricas. É possível alterar o título de um gráfico depois de criá-lo selecionando Editar na barra de ferramentas do gráfico.

  5. Clique em Save.

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.

Editor de visualização

Para configurar um medidor ou uma visão geral, 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 é determinado pela seleção do 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 àquelas 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 ativos.

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

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

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

    • 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, consulte Como selecionar dados para o gráfico.

  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 Aviso acima e Perigo acima definidos:

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

      Um exemplo do medidor, quando a leitura é menor que os limites de alerta e danos, é mostrado abaixo:

      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.

Editor clássico

É possível ver visões gerais e medidores ao usar o editor clássico. Para criar ou modificar uma visão geral ou um medidor, use o editor de visualização ou a API Cloud Monitoring.

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.

Editor de visualização

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.

Editor clássico

É possível ver caixas de texto ao usar o editor clássico. Para criar ou modificar uma caixa de texto, você precisa usar o editor de visualização ou a API Cloud Monitoring.

Como alterar um tipo de widget

Editor de visualização

Não é possível alterar o tipo de widget. Por exemplo, se você selecionou um gráfico de linhas, não é possível convertê-lo em um gráfico de mapa de calor.

Editor clássico

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

  1. Selecione Editar na barra de ferramentas do gráfico.
  2. Selecione o tipo de plotagem desejado no menu suspenso que exibe o estilo atual do gráfico. O estilo padrão é linha.

Se escolher um tipo de gráfico incompatível com um modo de gráfico escolhido, o modo de gráfico voltará ao modo de cor. Por exemplo, se você tiver um gráfico de linhas visualizado no modo X-ray e selecionar o tipo de gráfico como barra empilhada, o modo de gráfico mudará automaticamente para o modo de cor. Para mais informações sobre os modos de gráfico, consulte Como definir opções de visualização.

Como editar um widget do painel

Editor de visualização

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

  1. Certifique-se de que a barra de ferramentas do painel exiba Visualização e que o botão Editar esteja na posição ativado .
  2. Selecione o widget a ser editado. Essa ação ativa o painel de configuração do widget. 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.
  3. Clique em Salvar painel.

Editor clássico

Para editar a configuração de um gráfico, na barra de ferramentas do gráfico, clique em Outras opções e selecione Editar.

Para detalhes sobre a barra de ferramentas e a aparência de um gráfico, consulte Como definir opções de exibição.

Como excluir um widget do painel

Editor de visualização

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

  1. Certifique-se de que a barra de ferramentas do painel exiba Visualização e que o botão Editar esteja na posição ativado .
  2. Selecione o widget que você quer excluir.
  3. Na barra de ferramentas de configuração, selecione Excluir .
  4. Clique em Salvar painel.

Editor clássico

Para excluir um gráfico, clique em Outras opções na barra de ferramentas do gráfico e selecione Excluir.

A seguir