Esta página foi traduzida pela API Cloud Translation.

Adicionar filtros temporários a um painel personalizado

Este documento descreve como mudar os dados exibidos em um painel personalizado, sem precisar modificar cada widget, adicionando agrupamentos temporários e filtros temporários. Depois de adicionar um agrupamento ou filtro em todo o painel, a barra de ferramentas do painel mostra um item de menu para esse agrupamento ou filtro.

Ao resolver problemas, você pode modificar os dados exibidos em um painel adicionando agrupamentos ou filtros temporários. Por exemplo, se você estiver investigando um incidente e quiser que o painel mostre apenas dados de uma máquina virtual (VM) específica, adicione um filtro temporário.

Os agrupamentos e filtros temporários são excluídos automaticamente quando você recarrega a página, mas também podem ser excluídos manualmente.

Também é possível criar filtros permanentes. Por exemplo, se você fixar um filtro, ele vai se comportar como um filtro temporário, exceto por estar sempre disponível. Também é possível criar variáveis, que permitem aplicar um filtro a widgets selecionados. Para mais informações, consulte Criar e gerenciar variáveis e filtros fixados.

Como funcionam os filtros do painel

Um filtro de painel especifica um rótulo e um valor. A série temporal que o painel mostra determina os rótulos disponíveis para filtragem. A compatibilidade de um widget com um filtro em todo o painel depende do tipo de dados que ele exibe e da configuração dele:

Para widgets que mostram dados de séries temporais, como gráficos de linhas, as seguintes regras se aplicam:
- Se a série temporal exibida pelo widget não for compatível com o rótulo em um filtro, o filtro em todo o painel não vai mudar os dados mostrados.
  
  Por exemplo, se você adicionar um filtro ao rótulo instance_id, mas um gráfico no painel não mostrar dados com um rótulo instance_id, o filtro não vai alterar os dados exibidos.
- Se o widget especificar um valor para um rótulo, o filtro em todo o painel não vai mudar os dados mostrados.
  
  Por exemplo, se você adicionar um filtro no rótulo instance_id, mas um gráfico no painel incluir um filtro com base no rótulo instance_id, o filtro em todo o painel não vai mudar os dados exibidos.
- Caso contrário, o gráfico filtra os dados mostrados apenas para as séries temporais que atendem ao filtro em todo o painel.
Para widgets do painel de registros, os filtros em todo o painel que são baseados em um rótulo de recurso atualizam a consulta. Por exemplo, se você adicionar o filtro cluster_name: mycluster em todo o painel, a consulta será atualizada para incluir resource.labels."cluster_name"="mycluster".

É possível adicionar vários filtros em todo o painel. Esses filtros são unidos por um AND lógico.

Antes de começar

Para receber as permissões necessárias para adicionar ou modificar filtros temporários usando o console do Google Cloud, peça ao administrador para conceder a você o papel do IAM de Leitor do Monitoring (roles/monitoring.viewer) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

Para mais informações sobre papéis, consulte Controlar o acesso com o Identity and Access Management.

Criar ou modificar agrupamentos temporários

Quando você adiciona agrupamentos em todo o painel, os widgets no painel mostram uma série temporal para cada conjunto de séries temporais que tem os mesmos valores para os rótulos de agrupamento. Por padrão, a média de cada conjunto é mostrada. No entanto, quando o widget define uma função de agrupamento, ela é usada.

Por exemplo, suponha que o painel tenha um gráfico que mostra a utilização da CPU das instâncias de VM. Para determinar se você precisa implantar mais VMs em uma zona específica, edite o painel e o gráfico para mudar as opções de agrupamento. Uma alternativa é agrupar temporariamente o painel por zona e conferir o gráfico de utilização da CPU.

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

No console do Google Cloud, acesse a página Painéis:
Ir para Painéis

Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.
Abra o menu Agrupar por e selecione os rótulos para agrupar.
Clique em OK.

Quando você sai do painel, todos os agrupamentos criados são descartados.

Criar um filtro temporário

Ao investigar um incidente, é possível analisar os dados de maneiras específicas. Por exemplo, você pode querer visualizar apenas séries temporais de uma máquina virtual específica ou de recursos em uma região específica. Quando você cria um filtro temporário, todos os widgets do painel são modificados para mostrar os dados correspondentes a esse filtro. Por exemplo, para configurar todos os gráficos para mostrar apenas séries temporais de uma instância de VM específica, crie um filtro com base no rótulo instance_id. Da mesma forma, se quiser configurar o painel para mostrar apenas séries temporais de uma zona específica, crie um filtro com base no rótulo zone.

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

No console do Google Cloud, acesse a página Painéis:
Ir para Painéis

Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.
Na barra de filtro do painel, clique em Adicionar filtro e selecione um rótulo no menu.

O menu lista os rótulos de cada série temporal mostrada no painel.

Depois de selecionar um rótulo, um filtro é adicionado à barra de ferramentas do painel. O nome do filtro é o mesmo da seleção, e o valor é definido como *, que corresponde a todos os valores. Por exemplo, se você selecionar zone, a barra de ferramentas vai mostrar zone: *.
Para selecionar um valor específico, clique no filtro, por exemplo, zone: *, e selecione um valor no menu. Para reduzir o número de opções de menu, insira parte do valor na área Filtro.

Quando você sai do painel, todos os filtros criados são descartados.

Modificar um filtro temporário

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

Depois que você faz uma seleção, os gráficos e as tabelas são atualizados.

Excluir um filtro temporário

Os filtros temporários são excluídos automaticamente quando você sai do painel. Para remover manualmente um filtro temporário, clique em Excluir.