Adicionar widgets de painel

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Neste documento, descrevemos como adicionar widgets a um painel personalizado usando o Console do Google Cloud. Os painéis personalizados podem exibir dados de métricas, políticas de alertas, texto descritivo e entradas de registro. Esses painéis também podem exibir objetivos de nível de serviço (SLOs) para um conjunto de serviços.

Em geral, os widgets do painel podem exibir qualquer tipo de métrica que tenha um 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.

Ao adicionar widgets que exibem dados de métricas, você pode exibir esses dados em um intervalo de tempo ou mostrar apenas os dados mais recentes. Por exemplo, para exibir uma métrica em um intervalo de tempo, adicione um gráfico de linha, um gráfico de área empilhada, um gráfico de barras ou um mapa de calor. Para exibir somente os dados mais recentes, adicione uma tabela ou um indicador. Os indicadores mudam de cor com base na comparação entre os dados e os limites de aviso e perigo. Para informações gerais sobre os diferentes tipos de widget, consulte Painéis e gráficos.

É possível colocar até 40 widgets em um painel e organizá-los em grupos nomeados.

Para mais informações sobre a API Cloud Monitoring, consulte Gerenciar painéis por API.

Antes de começar

Antes de criar ou modificar um painel, verifique se você tem um dos seguintes papéis do Identity and Access Management:

  • roles/monitoring.dashboardEditor
  • roles/monitoring.editor
  • roles/monitoring.admin
  • roles/owner

Para mais informações sobre papéis, consulte Controle de acesso.

Adicionar gráficos e tabelas a um painel

Nesta seção, descrevemos como configurar gráficos e tabelas usando o Console do Google Cloud:

  • Os gráficos mostram dados ao longo do tempo, e há quatro estilos disponíveis: Linha, Área empilhada, Barra empilhada e Mapa de calor. Depois que um gráfico é configurado, você pode alterar o tipo de widget. Para mais informações sobre por que você pode selecionar um estilo específico, consulte Gráficos que mostram dados ao longo do tempo.

    Para informações sobre como usar a API Cloud Monitoring para configurar um gráfico, consulte Painel com um widget XyChart.

  • As tabelas contêm uma linha para cada série temporal monitorada e mostram apenas o valor mais recente. Existem dois estilos de tabelas. O widget Tabela exibe um valor numérico, como "quot;25%" O widget Lista superior exibe o valor e um indicador visual do valor em comparação com o intervalo de valores possíveis. É possível alternar entre esses tipos de widget. Para mais informações e um exemplo, consulte Exibir dados em formato de tabela em um painel.

    Para informações sobre como usar a API Cloud Monitoring para configurar uma tabela, consulte Painel com um widget TimeSeriesTable.

Para adicionar um gráfico ou tabela a um painel, faça o seguinte:

  1. No Console do Google Cloud, selecione Monitoring ou clique no seguinte botão:
    Acessar o Monitoring
  2. No painel de navegação, selecione Painéis e selecione o painel que você quer visualizar ou editar.
  3. Se o botão Editar painel for mostrado, clique nele.
  4. Selecione um widget de gráfico ou de tabela na Biblioteca de gráficos ou arraste um desses widgets da biblioteca para a área do gráfico.

  5. Especifique os dados mostrados pelo widget:

    • Para configurar rapidamente o widget, use o modo Básico. Esse modo oferece opções mínimas de configuração. Você pode mudar de uma configuração básica para outro modo a qualquer momento.
    • Para ter acesso a todos os campos configuráveis ou inserir um filtro do Monitoring, use o modo Avançado. Talvez não seja possível mudar para um modo de configuração diferente.
    • Para usar a Monitoring Query Language (MQL), selecione a guia MQL. Ao usar o MQL, não é possível alternar para um modo de configuração diferente e manter a consulta.

    A tabela a seguir descreve as opções de cada modo:

Basic

Para configurar o widget, siga estas etapas:

  1. Selecione os dados de série temporal que você quer ver.
  2. (Opcional) Série temporal de grupo.
  3. (Opcional) Configure as opções de visualização do gráfico.
  4. (Opcional) Crie um gráfico com vários tipos de métrica.

Selecione os dados de série temporal que você quer ver

Para selecionar as séries temporais no gráfico, siga um destes procedimentos:

  • Para exibir um tipo de métrica, como a utilização de CPU de uma VM, use os menus para fazer suas seleções:

    1. Clique em Selecionar uma métrica e use os menus para selecionar um tipo de recurso e um de métrica.

      Para reduzir o número de opções de menu, insira o nome de um recurso ou um tipo de métrica na Barra de filtro . Por exemplo, para gerar um gráfico da utilização de CPU de uma instância de VM, insira utilization na barra de filtro.

      Para listar todos os tipos de métricas e recursos, defina a opção Mostrar apenas recursos ativos e métricas como desativada. Por padrão, esse botão é definido como ativado para que somente métricas e recursos com dados sejam exibidos nos menus.

    2. (Opcional) Para especificar um subconjunto de dados a serem exibidos, adicione um filtro ou aplique variáveis de modelo. Por exemplo, é possível ver os dados de uma zona aplicando um filtro. É possível adicionar vários filtros. Para mais informações sobre os filtros, consulte Filtrar os dados exibidos no gráfico. Para informações sobre variáveis de modelo, consulte Filtrar um painel.

      Para adicionar um filtro, clique em Adicionar um filtro e selecione o rótulo e o valor dele. Por exemplo, para mostrar séries temporais apenas para a zona us-east1-b, insira o filtro zone = us-east1-b.

      Para aplicar uma variável de modelo, use o menu.

  • Para exibir um objetivo de nível de serviço ou a contagem de processos em execução em VMs, insira um filtro do Monitoring:

    1. Clique em Ajuda no menu Selecionar uma métrica.
    2. Selecione Modo de filtro direto.
    3. Insira o filtro do Monitoring na caixa de texto.

Para mais informações sobre essas opções, consulte Selecionar métricas para gráficos em painéis.

Série temporal do grupo

  1. 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 Agrupado e use o menu Agrupar por para selecionar os rótulos que serão agrupados. Depois de fazer suas seleções, clique em OK.

    Essa opção não está disponível para gráficos de mapa de calor, porque eles só podem exibir uma única série temporal.

  2. Para especificar como combinar pontos de dados em uma série temporal, use os botões de opção.

    Por exemplo, se um gráfico pode exibir 60 pontos de dados e os dados são gravados em 1 ponto por minuto, o gráfico pode exibir 1 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.

Configurar as opções de visualização do gráfico

Esses campos não estão disponíveis para tabelas.

(Opcional) Crie um gráfico com vários tipos de métrica

Esta opção não está disponível para tabelas.

Para exibir outro tipo de métrica no gráfico, clique em Adicionar outra métrica e repita as etapas anteriores. Um gráfico pode exibir no máximo 10 tipos de métricas.

Na primeira vez que você clicar em Adicionar outra métrica, as seleções feitas anteriormente serão exibidas no painel Série temporal A. Além disso, o painel Série temporal B é aberto. Esse painel contém os campos de configuração preenchidos para gerar um gráfico do segundo tipo de métrica.

A captura de tela abaixo ilustra esse comportamento:

Exemplo de configuração do Metrics Explorer com duas métricas.

Avançado

Para configurar o widget, siga estas etapas:

  1. Selecione os dados de série temporal que você quer ver.
  2. Selecione como as séries temporais são pré-processadas.
  3. (Opcional) Série temporal de grupo.
  4. (Opcional) Configure as opções de visualização do gráfico.
  5. (Opcional) Crie um gráfico com vários tipos de métrica.
  6. (Opcional) Crie um gráfico com uma proporção de tipos de métricas.

Selecione os dados de série temporal que você quer ver

Para selecionar as séries temporais no gráfico, siga um destes procedimentos:

  • Para exibir um tipo de métrica, como a utilização de CPU de uma VM, use os menus para fazer suas seleções:

    1. Clique em Selecionar uma métrica e use os menus para selecionar um tipo de recurso e um de métrica.

      Para reduzir o número de opções de menu, insira o nome de um recurso ou um tipo de métrica na Barra de filtro . Por exemplo, para gerar um gráfico da utilização de CPU de uma instância de VM, insira utilization na barra de filtro.

      Para listar todos os tipos de métricas e recursos, defina a opção Mostrar apenas recursos ativos e métricas como desativada. Por padrão, esse botão é definido como ativado para que somente métricas e recursos com dados sejam exibidos nos menus.

    2. (Opcional) Para especificar um subconjunto de dados a serem exibidos, adicione um filtro ou aplique variáveis de modelo. Por exemplo, é possível ver os dados de uma zona aplicando um filtro. É possível adicionar vários filtros. Para mais informações sobre os filtros, consulte Filtrar os dados exibidos no gráfico. Para informações sobre variáveis de modelo, consulte Filtrar um painel.

      Para adicionar um filtro, clique em Adicionar um filtro e selecione o rótulo e o valor dele. Por exemplo, para mostrar séries temporais apenas para a zona us-east1-b, insira o filtro zone = us-east1-b.

      Para aplicar uma variável de modelo, use o menu.

  • Para exibir um objetivo de nível de serviço ou a contagem de processos em execução em VMs, insira um filtro do Monitoring:

    1. Clique em Ajuda no menu Selecionar uma métrica.
    2. Selecione Modo de filtro direto.
    3. Insira o filtro do Monitoring na caixa de texto.

Para mais informações sobre essas opções, consulte Selecionar métricas para gráficos em painéis.

Selecione como a série temporal é pré-processada

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

As opções de pré-processamento são exibidas quando a métrica selecionada é um tipo delta ou cumulativo. O tipo de valor da métrica determina as opções específicas disponíveis.

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 do alinhamento dos dados. O exemplo a seguir mostra as opções quando a série temporal de uma métrica DELTA é selecionada:

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

Para métricas DELTA, quando Rate é selecionado, os valores de dados são divididos pela taxa de amostragem. Quando No preprocessing step é selecionado, a taxa de amostragem não dimensiona os valores de dados. Por exemplo, quando as unidades da métrica são MiB, a seleção de rate muda para a unidade de MiB por segundo. Para mais informações e um exemplo, consulte Tipos, tipos e conversões.

Série temporal do grupo

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

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

    • Para combinar as séries temporais em uma única série temporal, garanta que o campo Agrupar por esteja vazia e selecione como as séries temporais são combinadas usando o menu Agrupar por função.

      Ao exibir séries temporais em um mapa de calor, é necessário combinar as séries temporais usando essa abordagem. Os mapas de calor só podem exibir uma única série temporal. Para mais informações, consulte Métricas de distribuição.

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

      • Verifique se o campo Agrupar por está vazio e selecione none em Agrupar por função.
      • Expanda o menu Agrupar por, selecione Adicionar tudo e, em seguida, selecione o menu Agrupar por função.
    • 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.

Configurar as opções de visualização do gráfico

Esses campos não estão disponíveis para tabelas.

(Opcional) Crie um gráfico com vários tipos de métrica

Esta opção não está disponível para tabelas.

Para exibir outro tipo de métrica no gráfico, clique em Adicionar outra métrica e repita as etapas anteriores. Um gráfico pode exibir no máximo 10 tipos de métricas.

Na primeira vez que você clicar em Adicionar outra métrica, as seleções feitas anteriormente serão exibidas no painel Série temporal A. Além disso, o painel Série temporal B é aberto. Esse painel contém os campos de configuração preenchidos para gerar um gráfico do segundo tipo de métrica.

A captura de tela abaixo ilustra esse comportamento:

Exemplo de configuração do Metrics Explorer com duas métricas.

(Opcional) Crie um gráfico com uma proporção de tipos de métricas

Esta opção não está disponível para tabelas.

Quando você tem interesse, por exemplo, na taxa de erros em vez do número absoluto de erros, é necessário traçar um índice de tipos de métricas. Um gráfico que mostra uma proporção de tipos de métrica pode mostrar anomalias devido a diferenças de amostragem e alinhamento. Para ver referências a exemplos e mais informações, consulte Proporções de métricas.

As etapas a seguir presumem que você concluiu as etapas para criar um tipo de métrica. Nas etapas a seguir, você seleciona um segundo tipo de métrica e, em seguida, converte o gráfico para mostrar uma proporção:

  1. Selecione Adicionar outra métrica.

    Ao clicar em Adicionar outra métrica, as seleções feitas anteriormente são exibidas no painel Série temporal A. Além disso, o painel Série temporal B é aberto.

  2. Selecione o tipo de métrica para a Série temporal B.

    Os dois tipos de métrica precisam ter o mesmo tipo de métrica. Por exemplo, se Time Series-A for uma métrica GAUGE, selecione um tipo de métrica que tenha um tipo de métrica GAGA.

  3. Verifique se o valor do campo Período de alinhamento mínimo é igual aos dois tipos de métrica.

  4. Defina os parâmetros de agrupamento para o segundo tipo de métrica.

    Recomendamos que os campos de agrupamento do segundo tipo de métrica correspondam aos valores da Time Series-A. Por exemplo, é possível agrupar os dois tipos de métrica pelo rótulo zone.

    Não é necessário usar o mesmo agrupamento para o numerador e o denominador. No entanto, só é possível agrupar por rótulos comuns a ambos os campos.

  5. Ative a opção Exibir métricas como proporção.

    Quando você fizer essa seleção, o rótulo Time Series-A será renomeado como Numerator, e o rótulo Time Series-B será renomeado como Denominator.

  6. (Opcional) Para mudar o tipo de métrica, use o numerador e clique em Trocar numerador.

  7. (Opcional) Expanda Mostrar opções de proporção para configurar as opções de agregação secundárias.

MQL

Para adicionar um gráfico ou tabela a um painel usando o modo MQL, insira uma consulta MQL.

Por exemplo, a consulta a seguir exibe a utilização média da CPU de cada instância de máquina virtual (VM) do Compute Engine:

fetch gce_instance
| metric 'compute.googleapis.com/instance/cpu/utilization'
| group_by 1m, [value_utilization_mean: mean(value.utilization)]
| every 1m

Ao selecionar um widget de mapa de calor, verifique se as opções de agregação combinam a série temporal em uma única série temporal. Se um gráfico de mapa de calor exibir Your MQL Query has too many time series, modifique as configurações de agregação para combinar a série temporal.

Para informações sobre proporções de computação com MQL, consulte Proporções de computação.

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

Para informações sobre como adicionar filtros de modelo ao usar o MQL, consulte Filtros do painel.

PromQL

Para adicionar um gráfico ou tabela a um painel usando o modo PromQL, insira uma consulta PromQL.

A consulta a seguir mostra a utilização média da CPU da instância de máquina virtual (VM) do Compute Engine:

avg(compute_googleapis_com:instance_cpu_utilization)

Ao selecionar um widget de mapa de calor, verifique se as opções de agregação combinam a série temporal em uma única série temporal. Se um gráfico de calor exibir Your Query has too many time series, modifique a consulta para combinar as séries temporais.

Para mais informações sobre o uso de PromQL, consulte PromQL no Cloud Monitoring.

Os filtros no nível da página nos painéis personalizados não são compatíveis com os gráficos do PromQL nesses painéis.

Adicionar indicadores a um painel

Para ver a medida mais recente em comparação com um conjunto de limites codificado por cores, adicione um medidor ou uma visão geral. Os medidores exibem somente a medição mais recente, enquanto os visões gerais também mostram um histórico das medições recentes. A cor de fundo desses widgets também é codificada por cores. Quando o valor mais recente estiver dentro dos intervalos esperados, a cor do widget será branca. Quando o valor está em um intervalo de alertas, o widget fica âmbar. Da mesma forma, quando o valor está em um intervalo de perigo, o widget fica vermelho.

Os dois widgets exibem uma única série temporal. A captura de tela abaixo mostra um exemplo de medidor quando a medição mais recente é menor que os limites de aviso e perigo:

Exemplo de um medidor.

O restante das informações nesta seção é para o Console do Google Cloud. Para informações sobre como usar a API Cloud Monitoring, consulte Painel com um Scorecard básico.

Para adicionar um medidor ou visão geral a um painel, faça o seguinte:

  1. No Console do Google Cloud, selecione Monitoring ou clique no seguinte botão:
    Acessar o Monitoring
  2. No painel de navegação, selecione Painéis e selecione o painel que você quer visualizar ou editar.
  3. Se o botão Editar painel for mostrado, clique nele.
  4. Selecione um widget de medidor ou visão geral na Biblioteca de gráficos ou arraste um desses widgets da biblioteca para a área do gráfico.
  5. Especifique os dados mostrados pelo widget:
    • Para configurar rapidamente o widget, use o modo Básico. Esse modo oferece opções mínimas de configuração. Você pode mudar de uma configuração básica para outro modo a qualquer momento.
    • Para ter acesso a todos os campos configuráveis ou inserir um filtro do Monitoring, use o modo Avançado. Talvez não seja possível mudar para um modo de configuração diferente.
    • Para usar a Monitoring Query Language (MQL), selecione a guia MQL. Ao usar o MQL, não é possível alternar para um modo de configuração diferente e manter a consulta.

    A tabela a seguir descreve as opções de cada modo:

Basic

Para configurar o widget, siga estas etapas:

  1. Selecione os dados de série temporal que você quer ver.
  2. Combine as séries temporais em uma única série temporal.
  3. Configure os níveis de aviso e limite.

Selecione os dados de série temporal que você quer ver

Para selecionar as séries temporais no gráfico, siga um destes procedimentos:

  • Para exibir um tipo de métrica, como a utilização de CPU de uma VM, use os menus para fazer suas seleções:

    1. Clique em Selecionar uma métrica e use os menus para selecionar um tipo de recurso e um de métrica.

      Para reduzir o número de opções de menu, insira o nome de um recurso ou um tipo de métrica na Barra de filtro . Por exemplo, para gerar um gráfico da utilização de CPU de uma instância de VM, insira utilization na barra de filtro.

      Para listar todos os tipos de métricas e recursos, defina a opção Mostrar apenas recursos ativos e métricas como desativada. Por padrão, esse botão é definido como ativado para que somente métricas e recursos com dados sejam exibidos nos menus.

    2. (Opcional) Para especificar um subconjunto de dados a serem exibidos, adicione um filtro ou aplique variáveis de modelo. Por exemplo, é possível ver os dados de uma zona aplicando um filtro. É possível adicionar vários filtros. Para mais informações sobre os filtros, consulte Filtrar os dados exibidos no gráfico. Para informações sobre variáveis de modelo, consulte Filtrar um painel.

      Para adicionar um filtro, clique em Adicionar um filtro e selecione o rótulo e o valor dele. Por exemplo, para mostrar séries temporais apenas para a zona us-east1-b, insira o filtro zone = us-east1-b.

      Para aplicar uma variável de modelo, use o menu.

  • Para exibir um objetivo de nível de serviço ou a contagem de processos em execução em VMs, insira um filtro do Monitoring:

    1. Clique em Ajuda no menu Selecionar uma métrica.
    2. Selecione Modo de filtro direto.
    3. Insira o filtro do Monitoring na caixa de texto.

Para mais informações sobre essas opções, consulte Selecionar métricas para gráficos em painéis.

Combinar as séries temporais em uma única série temporal

Use os botões de opção para especificar como os dados de diferentes séries temporais são combinados. Por exemplo, para média de série temporal, selecione mean.

Configurar os níveis de aviso e limite

Escolha uma destas opções:

  • Para medidores, faça o seguinte:

    1. 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.
    2. Configure os limites de aviso e perigo.

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

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

  • Para visões gerais, faça o seguinte:

    1. Defina a visualização do gráfico do Spark. A visualização determina como os dados passados são mostrados. Por exemplo, se você selecionar Linha, uma linha será exibida.
    2. Configure os limites de aviso e perigo.

Avançado

Para configurar o widget, siga estas etapas:

  1. Selecione os dados de série temporal que você quer ver.
  2. Combine as séries temporais em uma única série temporal.
  3. Configure os níveis de aviso e limite.

Selecione os dados de série temporal que você quer ver

Para selecionar as séries temporais no gráfico, siga um destes procedimentos:

  • Para exibir um tipo de métrica, como a utilização de CPU de uma VM, use os menus para fazer suas seleções:

    1. Clique em Selecionar uma métrica e use os menus para selecionar um tipo de recurso e um de métrica.

      Para reduzir o número de opções de menu, insira o nome de um recurso ou um tipo de métrica na Barra de filtro . Por exemplo, para gerar um gráfico da utilização de CPU de uma instância de VM, insira utilization na barra de filtro.

      Para listar todos os tipos de métricas e recursos, defina a opção Mostrar apenas recursos ativos e métricas como desativada. Por padrão, esse botão é definido como ativado para que somente métricas e recursos com dados sejam exibidos nos menus.

    2. (Opcional) Para especificar um subconjunto de dados a serem exibidos, adicione um filtro ou aplique variáveis de modelo. Por exemplo, é possível ver os dados de uma zona aplicando um filtro. É possível adicionar vários filtros. Para mais informações sobre os filtros, consulte Filtrar os dados exibidos no gráfico. Para informações sobre variáveis de modelo, consulte Filtrar um painel.

      Para adicionar um filtro, clique em Adicionar um filtro e selecione o rótulo e o valor dele. Por exemplo, para mostrar séries temporais apenas para a zona us-east1-b, insira o filtro zone = us-east1-b.

      Para aplicar uma variável de modelo, use o menu.

  • Para exibir um objetivo de nível de serviço ou a contagem de processos em execução em VMs, insira um filtro do Monitoring:

    1. Clique em Ajuda no menu Selecionar uma métrica.
    2. Selecione Modo de filtro direto.
    3. Insira o filtro do Monitoring na caixa de texto.

Para mais informações sobre essas opções, consulte Selecionar métricas para gráficos em painéis.

Combinar as séries temporais em uma única série temporal

  1. Selecione os parâmetros de alinhamento. Em geral, os parâmetros de alinhamento podem ficar nos valores padrão. Para mais informações, consulte Alinhamento: regularização em série.

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

Configurar os níveis de aviso e limite

Escolha uma destas opções:

  • Para medidores, faça o seguinte:

    1. 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.
    2. Configure os limites de aviso e perigo.

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

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

  • Para visões gerais, faça o seguinte:

    1. Defina a visualização do gráfico do Spark. A visualização determina como os dados passados são mostrados. Por exemplo, se você selecionar Linha, uma linha será exibida.
    2. Configure os limites de aviso e perigo.

MQL

Para configurar o widget, insira uma consulta MQL que combine a série temporal em uma única série temporal.

Por exemplo, veja a consulta sobre a utilização da CPU de uma instância de VM. Esta consulta agrupa os dados por zona e depois 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, quando suas instâncias de VM estão em várias zonas, esses widgets exibem 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 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 as séries temporais devem ser combinadas e o segundo argumento, max(val()), define como as séries temporais serão a combinação. Depois que a operação de agrupamento for concluída, haverá uma única série temporal.

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

PromQL

Para configurar o widget, insira uma consulta PromQL que combine a série temporal em uma única série temporal.

Por exemplo, veja a consulta sobre a utilização da CPU de uma instância de VM. Se você tiver várias VMs, essa consulta recupera várias séries temporais e não pode ser exibida por um medidor ou visão geral:

compute_googleapis_com:instance_cpu_utilization

Se a consulta retornar várias séries temporais, um widget de medidor ou de visão geral exibirá a mensagem de erro Your Query has too many time series.

Para solucionar essa condição de erro, verifique se a consulta retorna uma única série temporal. A consulta a seguir calcula a média de todas as séries temporais:

avg(compute_googleapis_com:instance_cpu_utilization)

Para mais informações sobre como usar o MQL, consulte PromQL no Cloud Monitoring.

Exibir dados em formato de tabela em um painel

Para ver os dados mais recentes em formato de tabela, adicione uma tabela. As tabelas podem exibir qualquer tipo de métrica que tenha um valor numérico e podem exibir percentis para métricas com valor de distribuição. As tabelas mostram apenas o valor mais recente, semelhante ao comportamento dos medidores e das visões gerais. No entanto, ao contrário dos medidores e visões gerais, as tabelas contêm uma linha para cada série temporal monitorada.

Existem dois estilos de tabelas. O widget Top List é pré-configurado com duas colunas e para limitar o número de linhas. Uma coluna no widget Top List exibe um rótulo como instance_id e a outra exibe o valor e um indicador visual do valor em comparação com o intervalo de valores possíveis. O widget Tabela está pré-configurado para exibir uma coluna para cada rótulo com mais de um valor exclusivo, uma linha para cada série temporal e um valor numérico, como "quot;25%"

Os dois widgets são representados pela mesma estrutura de dados. Portanto, depois de adicionar um desses widgets ao painel, você pode limitar o número de linhas exibidas, alterar as colunas exibidas na tabela e alterar a forma como o valor é representado.

A captura de tela a seguir ilustra um painel que mostra a utilização da CPU das instâncias de máquina virtual usando um widget de lista superior e um widget de tabela:

Exemplo de widgets **Lista superior** e **Tabela**.

Para informações sobre como adicionar tabelas a um painel, consulte os seguintes documentos:

Classificar e filtrar tabelas

É possível mudar a ordem das linhas na tabela e filtrar o conteúdo da tabela para que somente linhas específicas sejam exibidas. Essas configurações não são persistentes. Quando você sai da página do painel ou atualiza o painel, as opções de classificação e filtragem aplicadas são descartadas.

Você tem as seguintes opções de classificação e filtragem:

  • Para classificar a tabela por coluna, clique no cabeçalho da coluna.

  • Para alterar as colunas da tabela, clique em Visualizar colunas, faça as modificações e clique em OK.

  • Para listar somente linhas específicas, adicione um ou mais filtros. É possível adicionar vários filtros. Quando você não especifica o operador OR entre dois filtros, um operador AND mescla esses filtros.

    Para adicionar um filtro, clique em Enter property name or value, selecione uma propriedade no menu e insira um valor ou selecione-o no menu de valores. Por exemplo, se você filtrar a propriedade Name e inserir o valor demo, a tabela listará somente as linhas em que o campo Name inclui o valor demo.

Adicionar texto a um painel

Para adicionar informações úteis ao painel, adicione uma caixa de texto. O conteúdo de uma caixa de texto pode ser informações sobre o painel, links para recursos relevantes ou o que fazer em diferentes situações. O conteúdo dos widgets de texto é permanente. A captura de tela a seguir ilustra uma caixa 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 informações sobre como usar a API Cloud Monitoring, consulte Painel com um widget Text.

Para adicionar uma caixa de texto, faça o seguinte:

  1. No Console do Google Cloud, selecione Monitoring ou clique no seguinte botão:
    Acessar o Monitoring
  2. No painel de navegação, selecione Painéis e selecione o painel que você quer visualizar ou editar.
  3. Se o botão Editar painel for mostrado, clique nele.
  4. Selecione o widget de caixa de texto da Biblioteca de gráficos ou arraste esse widget da biblioteca para a área do gráfico.
  5. Digite o texto que você quer exibir. 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.

Exibir políticas de alertas em um painel

Para ver o gráfico associado a uma política de alertas no mesmo contexto dos dados das suas métricas, adicione um gráfico de alertas ao seu painel. Os gráficos de alertas exibem a série temporal que a política monitora, um limite, o número de incidentes associados à política e se a política está desativada. A captura de tela a seguir ilustra um gráfico de alertas:

Exemplo de um gráfico de alertas.

As informações restantes nesta seção são para o Console do Google Cloud. Para informações sobre como usar a API Cloud Monitoring, consulte Painel com um widget AlertChart.

Para adicionar um gráfico de alertas a um painel, faça o seguinte:

  1. No Console do Google Cloud, selecione Monitoring ou clique no seguinte botão:
    Acessar o Monitoring
  2. No painel de navegação, selecione Painéis e selecione o painel que você quer visualizar ou editar.
  3. Se o botão Editar painel for mostrado, clique nele.
  4. Selecione o widget de gráfico de alertas na Biblioteca de gráficos ou arraste esse widget da biblioteca para a área do gráfico.
  5. Selecione uma política de alertas usando o menu Política de alertas.

Como visualizar políticas de alertas

Ao visualizar um gráfico de alertas, talvez você queira mais informações sobre a política de alertas exibida. Por exemplo, é recomendável analisar os canais de notificação selecionados ou qual documentação personalizada está incluída em uma notificação. Para ver informações sobre a política de alertas, tente o seguinte:

  • Para visualizar os detalhes sobre a política de alertas, clique no ícone de incidentes no gráfico de alertas e selecione Ver política de alertas.

  • Para editar a política de alertas, faça o seguinte:

    1. Verifique se o painel está no modo de edição.
    2. Selecione o gráfico de alertas para ativar o painel de configuração e clique em Editar política.
  • Para ver detalhes sobre a configuração da série temporal exibida, clique em Mais opções e selecione Ver no Metrics Explorer.

    O Metrics Explorer exibe um gráfico de linhas configurado com a mesma configuração de métrica e filtro que o gráfico de alerta. Todas as alterações que você pode fazer no gráfico exibido no Metrics Explorer são limitadas a ele. Ou seja, não é possível usar o Metrics Explorer para alterar a política de alertas.

Como excluir políticas de alertas

Se você excluir a política de alertas associada a um gráfico de alertas, o gráfico de alertas não exibirá mais dados. Para saber mais, consulte Gráfico de alertas não exibe dados.

Exibir entradas de registro em um painel

Para visualizar entradas de registro no mesmo contexto das suas métricas, adicione um painel de registros a um painel personalizado. Como o painel de registros permite filtrar as entradas de registro, você pode configurá-lo para exibir somente aquelas que são de seu interesse.

A captura de tela a seguir ilustra um painel de registros:

Exemplo de um painel com um painel de registros.

Para informações sobre como exibir entradas de registros no painel, consulte Visualizar registros em um painel personalizado.

Exibir SLOs em um painel

Para visualizar a integridade, a conformidade ou o orçamento de erro de um objetivo de nível de serviço (SLO) para um serviço, adicione um gráfico de SLO a um painel personalizado. Um gráfico de SLO fornece um resumo do desempenho de um serviço em relação a um SLO configurado. Ao usar os gráficos de SLO, é possível criar um painel personalizado que mostra o status de todos os SLOs de um conjunto de serviços.

Antes de usar um gráfico de SLO, é preciso configurar os serviços. Para informações sobre serviços e SLOs, consulte Monitoramento de SLOs.

A captura de tela a seguir ilustra um gráfico de SLO que exibe o orçamento de erro de um SLO:

Exemplo de um gráfico de SLO que mostra a margem de erro restante para um SLO.

As informações restantes nesta seção são para o Console do Google Cloud. Para informações sobre como usar a API Cloud Monitoring, consulte Painel com um widget de SLO.

Para adicionar um gráfico de SLO a um painel, faça o seguinte:

  1. No Console do Google Cloud, selecione Monitoring ou clique no seguinte botão:
    Acessar o Monitoring
  2. No painel de navegação, selecione Painéis e selecione o painel que você quer visualizar ou editar.
  3. Se o botão Editar painel for mostrado, clique nele.
  4. Selecione o widget de gráfico de SLO na Biblioteca de gráficos ou arraste esse widget da biblioteca para a área do gráfico.
  5. Selecione um serviço existente no menu Serviço.
  6. Selecione um SLO existente para o serviço no menu Objetivos de nível de serviço.

    Se o serviço escolhido não tiver SLOs, uma mensagem informará que é necessário criar um. Para adicionar um SLO, clique em Criar SLO. Para mais informações sobre como criar SLOs, consulte Como criar um SLO. Após criar um SLO, selecione-o e prossiga para a próxima etapa.

  7. Selecione uma métrica de SLO no menu Tipo de gráfico de objetivo de nível de serviço. É possível selecionar a integridade, a conformidade e o orçamento absoluto ou fracionado de erros. Para saber mais sobre as métricas de SLO, consulte Recuperar dados de SLO.

Organizar widgets do painel

Para melhorar a usabilidade de um painel com muitos widgets, use widgets de grupo recolhíveis. Um widget de grupo recolhível é um contêiner para outros widgets, para que você possa visualizar e gerenciar esses widgets como uma coleção. Por exemplo, um widget de grupo recolhível pode conter gráficos que exibem métricas de VM e políticas de alertas de monitoramento que monitoram VMs.

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

  1. No Console do Google Cloud, selecione Monitoring ou clique no seguinte botão:
    Acessar o Monitoring
  2. No painel de navegação, selecione Painéis e selecione o painel que você quer visualizar ou editar.
  3. Se o botão Editar painel for mostrado, clique nele.
  4. Na barra de ferramentas do painel, verifique se a opção Mosaico está selecionada.
  5. Selecione o widget de grupo recolhível na biblioteca de gráficos ou arraste esse widget da biblioteca para a área do gráfico.
  6. Digite um título descritivo no painel de configuração (opcional). O título é mostrado no widget.
  7. (Opcional) Defina a visualização padrão para expandir ou recolher o grupo. Quando um widget de grupo recolhível é recolhido, o Monitoring recupera os dados dos widgets no grupo com uma prioridade mais baixa do que a de outros widgets.
  8. Adicione widgets ao grupo seguindo um destes procedimentos:

    • Arraste um widget para o grupo.
    • Arraste um widget da biblioteca de gráficos para o grupo.
  9. (Opcional) Use o ponteiro para redimensionar e reposicionar widgets no grupo.

Para remover um widget de um widget de grupo recolhível, é possível excluir o widget ou arrastá-lo para um espaço não utilizado no painel.

Para remover o agrupamento, selecione o widget de grupo recolhível e, na barra de ferramentas do widget, selecione Cancelar.

A seguir