Neste documento, descrevemos como mudar quais dados são 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 exibirá um item de menu para esse agrupamento ou filtro.
Ao solucionar problemas, é possível 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 exiba dados apenas para 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ê atualiza a página. No entanto, também é possível excluí-los manualmente.
Para informações sobre como criar filtros permanentes, consulte [Adicionar filtros permanentes aos painéis personalizados][permanent-filter].
Como funcionam os filtros do painel
Um filtro de painel 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 exibido 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 exibida pelo widget não for compatível com o rótulo em um filtro, o filtro do painel não 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ótuloinstance_id
, o filtro não alterará os dados exibidos.Se o widget especificar um valor para um rótulo, o filtro do painel não 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 baseado no rótuloinstance_id
, o filtro do painel não alterará os dados exibidos.Caso contrário, o gráfico filtrará os dados exibidos apenas para as série temporal que satisfaçam o filtro do painel.
Para widgets do painel de registros, os filtros de todo o painel 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 no painel. Esses filtros são combinados com 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 de monitoramento (roles/monitoring.viewer
) do projeto.
Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.
Também é possível receber as permissões necessárias com 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 exibem uma série temporal para cada conjunto de séries temporais que têm os mesmos valores dos 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 o 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 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:
-
No console do Google Cloud, acesse a página Painéis:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
- Expanda o menu arrow_drop_down 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 você queira 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 determinada região. Quando você cria um filtro temporário, todos os widgets do painel são modificados para mostrar dados que correspondem a ele.
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, para configurar o painel para mostrar apenas série temporal para 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:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
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 mostrada no painel.
Depois que você seleciona um marcador, um filtro é adicionado à barra de ferramentas do painel. O nome do filtro é igual ao da seleção, e o valor dele é definido como
*
, que corresponde a todos os valores. Por exemplo, se você selecionarzone
, a barra de ferramentas exibirázone: *
.Para selecionar um valor específico para corresponder, clique no filtro (por exemplo, clique em
zone: *
) e selecione um valor no menu. Para reduzir o número de opções de menu, insira parte do valor na área filter_list 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 você quiser mais informações sobre uma série temporal específica mostrada 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 exiba 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:
-
No console do Google Cloud, acesse a página Painéis:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
- Identifique o gráfico e expanda a legenda para ver mais detalhes clicando em unfold_more Expandir legenda.
- 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 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 por um gráfico, faça o seguinte:
-
No console do Google Cloud, acesse a página Painéis:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
- Identifique o gráfico e expanda a legenda para ver mais detalhes clicando em unfold_more Expandir legenda.
- 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:
-
No console do Google Cloud, acesse a página Painéis:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
- Identifique o gráfico e expanda a legenda para ver mais detalhes clicando em unfold_more Expandir legenda.
- 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étricas.
Por exemplo, quando essas etapas são realizadas no gráfico que exibe a métrica CPU utilization
para o painel Exemplo, um filtro baseado no rótulo instance_name
é adicionado. Nesse caso, é possível que ambos os gráficos exibam 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 escrita. 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 nele.
A seguir
- Analisar os dados em gráficos
- Acessar painéis específicos de recursos
- Adicionar filtros permanentes a painéis personalizados