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.

Na solução de problemas, você pode modificar os dados que um painel exibe adicionando filtros ou agrupamentos temporários. Por exemplo, se você estiver investigando incidente e quer que o painel exiba apenas os dados de um máquina virtual (VM) e adicione um filtro temporário.

Os agrupamentos e filtros temporários são automaticamente excluídos ao atualizar a página. No entanto, também é possível excluí-los manualmente.

Para saber como criar filtros permanentes, consulte Adicionar filtros permanentes a painéis personalizados.

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 do painel inteiro não alterará os dados exibidos.

      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 mudar os dados exibidos.

    • Se o widget especificar um valor para um rótulo, o o filtro geral do painel não altera os dados exibidos.

      Por exemplo, se você adicionar um filtro no rótulo instance_id, mas um gráfico no painel inclui um filtro baseado no rótulo instance_id e, em seguida, o filtro do painel inteiro não altera 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 de painel de registros, filtros do painel que são baseados em um o rótulo de recurso atualiza 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 no 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 Controle o acesso com o Identity and Access Management.

Criar ou modificar agrupamentos temporários

Quando você adiciona agrupamentos em todo o painel, os widgets exibem uma série temporal para cada conjunto de séries temporais que têm os mesmos valores para o 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, e essa função é usada.

Por exemplo, suponha que seu painel contenha um gráfico que exibe o uso 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, em seguida, exibir os Gráfico de utilização da CPU.

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

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

  2. Abra o menu Agrupar por e selecione os rótulos para agrupar.
  3. Clique em OK.

Quando você sai do painel, todos os agrupamentos que você criou serão descartados.

Criar um filtro temporário

Quando você está investigando um incidente, pode querer olhar para os dados maneiras específicas. Por exemplo, você pode querer visualizar apenas as 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:

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

  2. Na barra de filtro do painel, Clique em Adicionar filtro e selecione um marcador no menu.

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

    Depois que você seleciona um marcador, 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: *.

  3. Para selecionar um valor específico para correspondência, Clique no filtro, por exemplo, em 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, quaisquer filtros criados serão descartados.

Modificar um filtro temporário

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

Depois que você fizer uma seleção, os gráficos e as tabelas serã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.

A seguir