Adicione filtros temporários a um painel de controlo personalizado

Este documento descreve como pode alterar os dados apresentados num painel de controlo personalizado, sem ter de modificar cada widget, adicionando agrupamentos temporários e filtros temporários. Depois de adicionar um agrupamento ou um filtro ao nível do painel de controlo, a barra de ferramentas do painel de controlo apresenta um item de menu para esse agrupamento ou filtro.

Ao resolver problemas, pode modificar os dados apresentados por um painel de controlo adicionando agrupamentos ou filtros temporários. Por exemplo, se estiver a investigar um incidente e quiser que o painel de controlo apresente apenas dados de uma máquina virtual (VM) específica, adicione um filtro temporário.

Os agrupamentos e os filtros temporários são eliminados automaticamente quando recarrega a página. No entanto, também os pode eliminar manualmente.

Também pode criar filtros permanentes. Por exemplo, se fixar um filtro, este comporta-se como um filtro temporário, exceto que está sempre disponível. Também pode criar variáveis, que lhe permitem aplicar um filtro a widgets selecionados. Para mais informações, consulte o artigo Crie e faça a gestão de variáveis e filtros fixos.

Esta funcionalidade só é suportada para projetos do Google Cloud . Para configurações do App Hub, selecione o projeto anfitrião do App Hub ou o projeto de gestão da pasta com apps ativadas.

Como funcionam os filtros do painel de controlo

Um filtro do painel de controlo especifica uma etiqueta e um valor. As séries cronológicas apresentadas no painel de controlo determinam as etiquetas disponíveis para filtragem. A forma como um widget suporta um filtro ao nível do painel de controlo depende do tipo de dados que o widget apresenta e da configuração do widget:

  • Para widgets que apresentam dados de séries temporais, como gráficos de linhas, aplicam-se as seguintes regras:

    • Se o intervalo temporal apresentado pelo widget não suportar a etiqueta num filtro, o filtro ao nível do painel de controlo não altera os dados apresentados.

      Por exemplo, se adicionar um filtro na etiqueta instance_id, mas um gráfico no painel de controlo não apresentar dados com uma etiqueta instance_id, o filtro não altera os dados apresentados.

    • Se o widget especificar um valor para uma etiqueta, o filtro ao nível do painel de controlo não altera os dados apresentados.

      Por exemplo, se adicionar um filtro na etiqueta instance_id, mas um gráfico no painel de controlo incluir um filtro com base na etiqueta instance_id, o filtro ao nível do painel de controlo não altera os dados apresentados.

    • Caso contrário, o gráfico filtra os dados apresentados para apenas as séries cronológicas que satisfazem o filtro ao nível do painel de controlo.

  • Para widgets do painel de registos, os filtros ao nível do painel de controlo baseados numa etiqueta de recurso atualizam a consulta. Por exemplo, se adicionar o filtro ao nível do painel de controlo cluster_name: mycluster, a consulta é atualizada para incluir resource.labels."cluster_name"="mycluster".

Pode adicionar vários filtros ao nível do painel de controlo. Estes filtros estão unidos por um operador lógico AND.

Antes de começar

Conclua os passos seguintes no Google Cloud projeto onde quer ver os seus painéis de controlo:

Crie ou modifique agrupamentos temporários

Quando adiciona agrupamentos ao nível do painel de controlo, os widgets no painel de controlo apresentam uma série cronológica para cada conjunto de séries cronológicas que têm os mesmos valores para as etiquetas de agrupamento. Por predefinição, é apresentada a média de cada conjunto. No entanto, quando o widget define uma função de agrupamento, essa função é usada.

Por exemplo, suponha que o seu painel de controlo contém um gráfico que apresenta a utilização da CPU das suas instâncias de VM. Para determinar se precisa de implementar mais VMs numa zona específica, pode editar o painel de controlo e esse gráfico para alterar as respetivas opções de agrupamento. Uma alternativa é agrupar temporariamente o painel de controlo por zona e, em seguida, ver o gráfico de utilização da CPU.

Para criar ou modificar os agrupamentos temporários, faça o seguinte:

  1. Na Google Cloud consola, aceda à página  Painéis de controlo:

    Aceda a Painéis de controlo

    Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.

  2. Na barra de ferramentas da Google Cloud consola, selecione o seu Google Cloud projeto. Para configurações do App Hub, selecione o projeto anfitrião do App Hub ou o projeto de gestão da pasta com apps ativadas.
  3. Expanda o menu Agrupar por e, de seguida, selecione as etiquetas para agrupar.
  4. Clique em OK.

Quando navega para fora do painel de controlo, todos os agrupamentos que criou são rejeitados.

Crie um filtro temporário

Quando está a investigar um incidente, pode querer analisar os dados de formas específicas. Por exemplo, pode querer ver apenas séries cronológicas para uma máquina virtual específica ou para recursos numa região específica. Quando cria um filtro temporário, todos os widgets do painel de controlo são modificados para mostrar dados que correspondem a esse filtro. Por exemplo, para configurar todos os gráficos de modo a apresentarem apenas séries cronológicas para uma instância de VM específica, crie um filtro com base na etiqueta instance_id. Da mesma forma, para configurar o painel de controlo de forma a apresentar apenas séries cronológicas para uma zona específica, crie um filtro com base na etiqueta zone.

Para criar um filtro temporário, faça o seguinte:

  1. Na Google Cloud consola, aceda à página  Painéis de controlo:

    Aceda a Painéis de controlo

    Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.

  2. Na barra de ferramentas da Google Cloud consola, selecione o seu Google Cloud projeto. Para configurações do App Hub, selecione o projeto anfitrião do App Hub ou o projeto de gestão da pasta com apps ativadas.

  3. Na barra de filtros do painel de controlo, clique em Adicionar filtro e, de seguida, selecione uma etiqueta no menu.

    O menu apresenta as etiquetas de todas as séries cronológicas apresentadas no painel de controlo.

    Depois de selecionar uma etiqueta, é adicionado um filtro à barra de ferramentas do painel de controlo. O nome do filtro tem o mesmo nome que a sua seleção e o respetivo valor está definido como *, que corresponde a todos os valores. Por exemplo, se selecionar zone, a barra de ferramentas apresenta zone: *.

  4. Para selecionar um valor específico para corresponder, clique no filtro, por exemplo, clique em zone: * e, de seguida, selecione um valor no menu. Para reduzir o número de opções do menu, introduza parte do valor na área Filtrar.

Quando navega para fora do painel de controlo, todos os filtros que criou são rejeitados.

Modifique um filtro temporário

Para modificar o valor de um filtro temporário, nesse filtro, clique em Menu e, de seguida, faça uma seleção.

Depois de fazer uma seleção, os gráficos e as tabelas são atualizados.

Elimine um filtro temporário

Os filtros temporários são eliminados automaticamente quando navega para fora do painel de controlo. Para remover manualmente um filtro temporário, nesse filtro, clique em Eliminar.

O que se segue?