Explorar mapas de calor

Nesta página, descrevemos como analisar o mapa de calor em uma verificação do Key Visualizer para identificar a origem de um problema de desempenho do Bigtable.

Antes de ler esta página, confira a visão geral do Key Visualizer. Também é possível:

Saiba como abrir uma verificação do Key Visualizer.
Veja exemplos de padrões comuns nos mapas de calor do Key Visualizer.

Analisar mensagens de diagnóstico

Se o Key Visualizer identificar um problema nos seus padrões de uso do Bigtable, a verificação do Key Visualizer incluirá mensagens de diagnóstico acima do mapa de calor. Clique em uma dessas mensagens para ver informações detalhadas sobre o problema.

Para ver uma descrição de cada mensagem de diagnóstico, consulte Mensagens de diagnóstico do Key Visualizer.

Ajustar brilho

Os mapas de calor do Key Visualizer usam cores escuras para indicar valores normais ou baixos e cores claras para indicar valores altos. Se as cores em um mapa de calor forem muito claras ou muito escuras, pode ser difícil ver padrões importantes para uma métrica.

Lembre-se de que, para a maioria das métricas, o Key Visualizer identifica quais valores são "altos" e "baixos" com base no seu uso da tabela. Por exemplo, se você executar 20 leituras por segundo em um intervalo de linhas específico e 1 leitura por segundo em outros intervalos de linhas, o Key Visualizer usará uma cor chamativa para esse intervalo específico, mesmo que 20 leituras por segundo seja um número baixo para o Bigtable. As métricas de Aviso e Desempenho são exceções a essa regra. Se essas métricas tiverem uma cor clara, significa que o Key Visualizer encontrou um problema em potencial.

Para ajustar as cores usadas para valores diferentes, use os botões +/– em cada lado do ícone Ajustar brilho . Aumentar o brilho reduz o intervalo de valores que cada cor representa. Diminuir o brilho aumenta o intervalo de valores.

Aplicar zoom em períodos e intervalos de chave de linha

Quando você abre um mapa de calor, ele mostra valores para todo o período incluso na verificação, bem como todo o intervalo de chaves de linha da tabela. Se você perceber um problema durante um período específico ou em um intervalo específico de chaves de linha, poderá ampliar o zoom para analisá-lo em mais detalhes.

Há várias maneiras de aumentar ou diminuir o zoom:

Rolar para cima ou para baixo no mapa de calor.
Clicar no botão zoom retangular e, em seguida, clicar e arrastar para selecionar uma área para ampliar.
Tocar e manter pressionada a tecla Shift, depois clicar e arrastar para selecionar uma área para ampliar.
Retornar à área anterior do mapa de calor pressionando a tecla Backspace ou Delete.
Diminuir o zoom para visualizar a tabela inteira clicando no botão Redefinir zoom ou pressionando a tecla R.

Detalhar o prefixo da chave de linha

Geralmente, as chaves de linha são compostas de uma hierarquia de valores, em que cada um é separado por um delimitador. Por exemplo, a chave de linha memusage#1423523569918 contém um identificador para todas as linhas que capturam uso de memória, seguido por um carimbo de data/hora que identifica um conjunto específico de dados nesse grupo. O Key Visualizer reconhece automaticamente esse tipo de chave de linha e a divide em uma hierarquia, o que ajuda você a detalhar mais rapidamente os dados de intervalos específicos de chaves de linha.

Para detalhar os dados do mapa de calor para um grupo de chaves de linha que compartilham um prefixo comum, faça o seguinte:

Mova o cursor sobre um dos níveis na hierarquia de chave de linha mostrada à esquerda do mapa de calor.

O Key Visualizer destaca a área do mapa de calor que mostra esse nível da hierarquia e o prefixo de todas as chaves de linha nesse nível.
Clique no nível da hierarquia de chave de linha que você quer examinar.

O Key Visualizer aumenta o zoom nesse nível da hierarquia.
Clique em outro nível da hierarquia de chave de linha para aumentar mais o zoom ou pressione a tecla Backspace ou Delete para retornar à área anterior.

Fixar detalhes sobre uma métrica

Conforme você move o cursor sobre um mapa de calor, o Key Visualizer mostra uma dica que contém detalhes sobre a métrica que está sob o cursor. Você pode fixar essa dica clicando no mapa de calor. As dicas fixadas mostram mais detalhes sobre a métrica. Fixar uma dica também facilita a captura de tela ou a cópia das informações dela.

Alternar métricas

Por padrão, quando você abre uma verificação do Key Visualizer, ela mostra a métrica de Operações, que fornece uma visão geral do padrão de uso da tabela. Para passar para outra métrica a qualquer momento, clique na lista suspensa Métrica acima do mapa de calor e, em seguida, clique na métrica que você quer visualizar. Se um item da lista estiver desativado, o valor dessa métrica será sempre zero.

Para ver uma descrição de cada métrica, consulte Métricas do Key Visualizer.

Alternar formato da chave

Por padrão, as chaves são exibidas como bytes serializados. Isso significa que os caracteres imprimíveis são exibidos como caracteres ASCII, ou seja, texto. Os caracteres não imprimíveis são exibidos como uma série de barras invertidas seguidas de números de três dígitos. Cada número simboliza a representação octal de um byte.

Por exemplo, uma chave que contém bytes imprimíveis e não imprimíveis pode ter a seguinte aparência:

\360q\364\031\253\735\223xdf\272\022\362\251bn\101

É possível optar por visualizar as chaves em formato hexadecimal em vez do formato de texto:

Clique no botão Configurações.
Em Preferências, escolha Hexadecimal.
Clique em OK.

Encontrar conexões entre diferentes métricas

Você pode ver várias métricas ao mesmo tempo no Key Visualizer quando quiser comparar métricas ou encontrar correlações entre métricas. Por exemplo, talvez convenha ver se os pontos de acesso no mapa de calor Ops estão correlacionados a quaisquer pontos de acesso do mapa de calor Latency, o que pode indicar que o número de operações em um bucket de chave estava gerando mais latência.

Para visualizar várias métricas e respectivos valores ao mesmo tempo, clique em Multimetric perto do canto superior direito. Uma lista de métricas é exibida em um painel à direita da verificação.

Exemplo mostrando o painel multimétrico de uma análise

Para examinar várias métricas de uma vez, use as seguintes ferramentas no painel multimétrico:

Para mostrar ou ocultar mapas de calor em miniatura de todas as métricas, clique em Expand All ou Collapse All no canto superior direito.
Para mostrar o mapa de calor de uma métrica individual, clique no nome da métrica.
Para ocultar o mapa de calor de uma métrica individual, clique no nome da métrica novamente.
Para exibir o mapa de calor de uma métrica na janela principal, clique na seta à esquerda da barra de título da métrica.
Passe o cursor do mouse sobre um mapa de calor em miniatura para ver a atividade correspondente na visualização principal.

Para comparar métricas diferentes de um bucket de chaves no mesmo período, você pode fixar um valor em uma verificação e alternar para uma métrica diferente no mesmo período:

Aponte para uma posição de interesse no mapa de calor grande na janela principal.
Clique para fixar a dica. Os valores no painel lateral permanecem fixos no bucket de chaves e no período em que você fixou.
Para exibir uma métrica no mapa de calor grande, clique na seta à esquerda dessa métrica. A dica na janela principal mostra os detalhes completos dessa métrica.

A seguir

Aprenda a reconhecer padrões comuns em mapas de calor.
Leia sobre as métricas que você pode ver em um mapa de calor.
Entenda as mensagens de diagnóstico mostradas no Key Visualizer.
Saiba mais sobre chaves de linha que contêm vários valores.