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. Para isso, adicione 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 que um painel mostra 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 é possível fazer isso manualmente.

Também é possível criar filtros permanentes. Por exemplo, se você fixar um filtro, ele vai se comportar como um filtro temporário, mas sempre estará 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.

Esse recurso só é compatível com projetos Google Cloud . Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.

Como funcionam os filtros de painel

Um filtro de painel especifica um rótulo e um valor. As série temporal que o painel mostra determinam os rótulos disponíveis para filtragem. A maneira como um widget oferece suporte a um filtro em todo o painel depende do tipo de dados que ele mostra e da configuração do widget:

Para widgets que mostram dados de série temporal, como gráficos de linhas, as seguintes regras se aplicam:
- Se a série temporal mostrada 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 exibidos.
  
  Por exemplo, se você adicionar um filtro no 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 mudar 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 mostrados.
- Caso contrário, o gráfico filtra os dados exibidos para mostrar apenas as série temporal que satisfazem o filtro em todo o painel.
Para widgets do painel de registros, os filtros em todo o painel baseados em um rótulo de recurso atualizam a consulta. Por exemplo, se você adicionar o filtro em todo o painel cluster_name: mycluster, 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 com um AND lógico.

Antes de começar

Conclua o seguinte no projeto do Google Cloud em que você quer ver seus painéis:

Para ter as permissões necessárias para adicionar ou modificar filtros temporários usando o console Google Cloud , peça ao administrador para conceder a você o papel do IAM de Leitor do Monitoring (roles/monitoring.viewer) no seu 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 mostram uma série temporal para cada conjunto de séries temporais que têm 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, essa função é usada.

Por exemplo, suponha que seu painel tenha um gráfico que mostre 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. Outra opção é 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 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 Monitoring.
Na barra de ferramentas do console Google Cloud , selecione seu projeto Google Cloud . Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.
Expanda 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, talvez seja necessário analisar os dados de maneiras específicas. Por exemplo, é possível visualizar apenas as série temporal de uma máquina virtual específica ou de recursos de uma região específica. Quando você cria um filtro temporário, todos os widgets do painel são modificados para mostrar dados que correspondem a esse filtro. Por exemplo, para configurar todos os gráficos para mostrar apenas série temporal para 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érie temporal 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 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 Monitoring.
Na barra de ferramentas do console Google Cloud , selecione seu projeto Google Cloud . Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.
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 sua seleção, e o valor dele é 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 a ser correspondido, clique no filtro, por exemplo, zone: *, e selecione um valor no menu. Para reduzir o número de opções do 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 de fazer uma seleção, os gráficos e 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 um filtro temporário manualmente, clique em Excluir.