Adicionar filtros temporários a um painel personalizado

Neste documento, descrevemos como alterar os dados exibidos em um painel personalizado sem precisar modificar cada widget adicionando agrupamentos temporários e filtros temporários. Depois que você adiciona um agrupamento ou filtro em todo o painel, a barra de ferramentas do painel exibe um item de menu para esse agrupamento ou filtro.

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

Agrupamentos e filtros temporários são excluídos automaticamente quando você atualiza a página. No entanto, você também pode excluí-los manualmente.

Saiba como criar filtros permanentes em [Adicionar filtros permanentes a painéis personalizados][permanent-filter].

Como funcionam os filtros do painel

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

• Para widgets que exibem dados de série temporal, como gráficos de linhas, as seguintes regras são aplicadas:

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

    Por exemplo, se você adicionar um filtro no rótulo instance_id, mas um gráfico no painel não exibir dados com um rótulo instance_id, o filtro não mudará os dados exibidos.

  • Se o widget especificar um valor para um rótulo, o filtro de todo o painel não vai alterar os dados exibidos.

    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 de todo o painel não mudará os dados exibidos.

  • Caso contrário, o gráfico vai filtrar os dados exibidos apenas para as série temporal que satisfaçam o filtro do painel.

• Para widgets do painel de registros, filtros de todo o painel baseados em um rótulo de recurso atualizam a consulta. Por exemplo, se você adicionar o filtro de todo o painel cluster_name: mycluster, a consulta será atualizada para incluir resource.labels."cluster_name"="mycluster".

Você pode adicionar vários filtros em todo o painel. Esses filtros são unidos com um AND lógico.

Antes de começar

Para ter 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 como conceder papéis, consulte Gerenciar acesso.

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 exibem uma série temporal para cada conjunto de séries temporais que tenha os mesmos valores para os rótulos de agrupamento. Por padrão, a média de cada conjunto é exibida. No entanto, quando o widget define uma função de agrupamento, ela é usada.

Por exemplo, suponha que seu painel contenha um gráfico que exibe a utilização da CPU das suas instâncias de VM. Para determinar se você precisa implantar mais VMs em uma zona específica, edite o painel e esse gráfico para alterar as opções de agrupamento. Uma alternativa é agrupar temporariamente o painel por zona e, em seguida, visualizar o 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:

   Acessar Painéis

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.

2. Expanda o menu arrow_drop_down Agrupar por e selecione os rótulos do agrupamento.
3. Clique em OK.

Ao sair do painel, todos os agrupamentos criados são descartados.

Criar um filtro temporário

Quando você estiver investigando um incidente, talvez seja necessário analisar os dados de maneiras específicas. Por exemplo, talvez você queira visualizar apenas série temporal de uma determinada máquina virtual 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 que todos os gráficos mostrem apenas série temporal de uma instância de VM específica, crie um filtro com base no rótulo instance_id. Da mesma forma, para 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:

1. No console do Google Cloud, acesse a página  Painéis:

   Acessar Painéis

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.

2. Na barra de filtro filter_list do painel, clique em Adicionar filtro e selecione um rótulo no menu.

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

   Depois que você seleciona um marcador, um filtro é adicionado à barra de ferramentas do painel. O nome do filtro tem o mesmo nome que sua seleção e o valor dele é definido como *, o que corresponde a todos os valores. Por exemplo, se você selecionar zone, a barra de ferramentas exibirá zone: *.

3. Para selecionar um valor específico para correspondência, clique no filtro. Por exemplo, clique em zone: * e selecione um valor no menu. Para reduzir o número de opções do menu, insira parte do valor na área Filtro filter_list.

Ao sair do painel, todos os filtros criados são descartados.

Adicionar filtros temporários que correspondam a uma série temporal

Se você quiser mais informações sobre uma série temporal específica mostrada em um gráfico, use a legenda do gráfico para aplicar filtros temporários. É possível aplicar filtros que correspondam aos rótulos específicos das séries temporais, que correspondam ao recurso da série temporal ou que correspondam apenas aos rótulos da métrica. Esta seção descreve essas opções.

Exemplo de painel

Para ajudar a descrever o comportamento das diferentes opções, considere um painel que exibe as métricas CPU utilization e Disk read bytes para instâncias de VM do Compute Engine. A captura de tela a seguir mostra esse painel em um sistema:

Filtrar por todos os rótulos de uma série temporal

Quando você quiser aplicar o conjunto mais restritivo de rótulos, filtre por todos eles. Com essa opção, os rótulos identificam um recurso exclusivo e um conjunto exclusivo de valores para os rótulos da métrica.

Para aplicar filtros temporários que identificam uma série temporal específica em um gráfico, faça o seguinte:

1. No console do Google Cloud, acesse a página  Painéis:

   Acessar Painéis

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.

2. Identifique o gráfico e abra a legenda para conferir mais detalhes clicando em unfold_more Expandir legenda.
3. Role pela legenda até encontrar a série temporal específica de interesse, clique em more_vertAções para esta série temporal e selecione Filtrar painel para todos os rótulos.

Por exemplo, quando essas etapas são aplicadas ao gráfico que exibe a métrica CPU utilization para o painel Exemplo, os seguintes filtros são adicionados:

• Rótulo da métrica: instance_name

• Rótulos de recursos para instâncias de VM do Compute Engine:

  • project_id
  • instance_id
  • zone

A captura de tela a seguir ilustra o resultado:

Na figura anterior, o gráfico que exibe a métrica CPU utilization mostra uma única série temporal. Esse comportamento ocorre porque você adicionou filtros que correspondem aos rótulos de série temporal. No entanto, o gráfico que exibe a métrica Disk read bytes mostra várias séries temporais. A métrica Disk read bytes contém três rótulos, além do rótulo instance_name. Portanto, é possível que várias séries temporais neste gráfico se refiram à mesma instância.

Como comparação, quando as etapas anteriores são aplicadas ao gráfico que exibe a métrica Disk read bytes para o painel Exemplo, os seguintes filtros são adicionados:

• Rótulos de métricas:

  • instance_name
  • device_name
  • storage_type
  • device_type

• Rótulos de recursos para instâncias de VM do Compute Engine:

  • project_id
  • instance_id
  • zone

Conforme mostrado na captura de tela anterior, os dois gráficos agora exibem uma única série temporal.

Filtrar por rótulos de recursos de uma série temporal

Ao filtrar por todos os rótulos de recursos, você restringe o painel para exibir séries temporais de um recurso específico. Agora é possível visualizar as métricas apenas desse recurso, eliminando temporariamente da exibição as série temporal que não são de interesse.

Para aplicar filtros temporários que identificam o recurso de uma série temporal específica exibida por um gráfico, faça o seguinte:

1. No console do Google Cloud, acesse a página  Painéis:

   Acessar Painéis

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.

2. Identifique o gráfico e abra a legenda para conferir mais detalhes clicando em unfold_more Expandir legenda.
3. Role pela legenda até encontrar a série temporal específica de interesse, clique em more_vertAções para esta série temporal e selecione Filtrar painel para rótulos de recursos.

Por exemplo, quando essas etapas são realizadas no gráfico que exibe a métrica CPU utilization do painel de exemplo, três filtros são adicionados. Estes filtros correspondem aos rótulos do recurso, uma instância de VM:

Conforme ilustrado na captura de tela anterior, quando você filtra por recurso, um gráfico pode exibir várias séries temporais.

Como a opção Filtrar painel para rótulos de recursos aplica apenas rótulos de recursos à barra de filtro temporária, o resultado é o mesmo quando você seleciona essa opção em qualquer um dos gráficos.

Filtrar por rótulos de métricas de uma série temporal

Essa opção permite aplicar filtros que correspondam aos valores dos rótulos de uma métrica. Por exemplo, ao visualizar métricas de balanceamento de carga, é possível visualizar as séries temporais que sejam apenas para um protocolo específico.

Para aplicar filtros temporários que identificam a métrica de uma série temporal específica exibida por um gráfico, faça o seguinte:

1. No console do Google Cloud, acesse a página  Painéis:

   Acessar Painéis

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.

2. Identifique o gráfico e abra a legenda para conferir mais detalhes clicando em unfold_more Expandir legenda.
3. Role pela legenda até encontrar a série temporal específica de interesse, clique em more_vertAções para esta série temporal e selecione Filtrar painel para rótulos de métrica.

Por exemplo, quando essas etapas são executadas no gráfico que exibe a métrica CPU utilization do painel de exemplo, um filtro com base no rótulo instance_name é adicionado. Nesse caso, é possível que os dois gráficos mostrem várias série temporal porque o valor do rótulo instance_name é configurável. Ou seja, é possível ter várias VMs com o mesmo valor para o rótulo instance_name.

Como comparação, quando as etapas anteriores são aplicadas ao gráfico que exibe a métrica Disk read bytes para o Painel de exemplo, são adicionados quatro filtros. Esses filtros correspondem aos rótulos da métrica Disk read bytes.

Quando os filtros temporários incluem apenas filtros de métrica, você vê séries temporais para essa métrica, independentemente do recurso em que a série temporal foi gravada. Como você não está restringindo a série temporal a um recurso específico, é possível que várias séries temporais sejam exibidas em um gráfico. A captura de tela anterior ilustra esse comportamento, já que os dois gráficos exibem duas séries temporais.

Modificar ou 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 cancel Excluir.

A seguir

• Analisar os dados em gráficos
• Acessar painéis específicos de recursos
• Adicionar filtros permanentes a painéis personalizados