Adicionar filtros temporários a um painel personalizado

Neste documento, descrevemos como mudar os dados mostrados em um painel personalizado sem 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 mostra um item de menu para esse agrupamento ou filtro.

Ao resolver problemas, você pode modificar os dados que um painel exibe 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 filtros e agrupamentos temporários são excluídos automaticamente quando você atualiza a página. No entanto, você também pode excluí-los manualmente.

Para informações sobre como criar filtros permanentes, consulte Adicionar filtros permanentes a painéis personalizados.

Como funcionam os filtros do painel

Um filtro de dashboard especifica um rótulo e um valor. A série temporal exibida pelo painel 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 dele:

• As regras a seguir são aplicáveis aos widgets que exibem dados de série temporal, como gráficos de linhas:

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

  • Caso contrário, o gráfico filtrará os dados exibidos apenas para as série temporal que satisfazem o filtro geral 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 painel geral cluster_name: mycluster, 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 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.

Talvez você também consiga receber as permissões necessárias por meio de papéis personalizados ou 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 tenham 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 o 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 painel de navegação do console do Google Cloud, selecione Monitoramento e  Painéis:

   Acessar Painéis

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

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

Criar um filtro temporário

Quando você estiver investigando um incidente, poderá analisar os dados de maneiras específicas. Por exemplo, talvez você queira visualizar apenas série temporal para uma determinada máquina virtual ou para recursos em 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 somente 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 painel de navegação do console do Google Cloud, selecione Monitoramento e  Painéis:

   Acessar Painéis

2. 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 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 da seleção e o valor é definido como *, 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, 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.

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

Quando quiser mais informações sobre uma série temporal específica exibida em um gráfico, use a legenda dele 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 da 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 painel de navegação do console do Google Cloud, selecione Monitoramento e  Painéis:

   Acessar Painéis

2. Identifique o gráfico e expanda a legenda para ver mais detalhes clicando em  Expandir legenda.
3. Role pela legenda até encontrar a série temporal específica de interesse, clique em Ações para esta série temporal e, em seguida, 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 conferir 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 para uma série temporal específica exibida em um gráfico, faça o seguinte:

1. No painel de navegação do console do Google Cloud, selecione Monitoramento e  Painéis:

   Acessar Painéis

2. Identifique o gráfico e expanda a legenda para ver mais detalhes clicando em  Expandir legenda.
3. Role pela legenda até encontrar a série temporal específica de interesse, clique em Ações para esta série temporal e, em seguida, 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 em um gráfico, faça o seguinte:

1. No painel de navegação do console do Google Cloud, selecione Monitoramento e  Painéis:

   Acessar Painéis

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

Por exemplo, quando essas etapas são realizadas 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 incluírem apenas filtros de métrica, você verá 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 um filtro temporário manualmente, clique em Excluir nele.

A seguir

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