Como explorar mapas de calor

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

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

Como ajustar o brilho

Os mapas de calor do Key Visualizer usam cores escuras para indicar valores normais ou baixos e cores claras para indicar valores altos. É possível ajustar a escala de cores para ver os padrões no mapa de calor.

Lembre-se de que, para a maioria das métricas, o Key Visualizer identifica quais valores são "altos" e "baixos" com base no uso do seu banco de dados. Por exemplo, se você executar 20 leituras por segundo em um intervalo de chaves específico e 1 leitura por segundo em outros intervalos de chaves, o Key Visualizer usará uma cor brilhante para esse intervalo de chaves específico. As cores claras não indicam necessariamente um problema.

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.

Para redefinir o brilho para a configuração padrão, clique no ícone Ajustar brilho.

Como aplicar zoom em períodos e intervalos de chave.

Quando você abre um mapa de calor, ele exibe os valores do período incluído na verificação e o intervalo de chaves ativas no banco de dados. Se você perceber um problema durante um período específico ou em um intervalo específico de chaves, 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.

Como detalhar por prefixo de chave

Na seção a seguir, descrevemos como fazer um detalhamento usando uma verificação de chave de documento como exemplo. No caso de chaves de índice, o prefixo muda para grupo de chaves de índice.

No lado esquerdo de um mapa de calor, o Key Visualizer organiza as chaves pela hierarquia do banco de dados. Você pode usá-la para detalhar os dados de intervalos específicos de chaves.

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

  1. Mova o cursor sobre um dos níveis na hierarquia de chave 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 nesse nível.

    Exemplo de área destacada em um mapa de calor referente a um grupo de chaves

  2. Clique no nível da hierarquia de chave que você quer examinar.

    O Key Visualizer aplica o zoom nesse nível da hierarquia.

    Exemplo de aumento de zoom em um nível da hierarquia de chave

  3. Clique em outro nível da hierarquia de chave para aumentar mais o zoom ou pressione a tecla Backspace ou Delete para retornar à área anterior.

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

Como alternar métricas

Por padrão, quando você abre uma verificação do Key Visualizer, ela mostra a métrica de Operações/s para chaves de documentos, o que fornece uma visão geral do padrão de uso. Para alternar para uma métrica diferente, clique na lista suspensa Métrica acima do mapa de calor e, em seguida, clique na métrica que você quer visualizar.

No caso de chaves de índice, ela mostra a métrica Operações de gravação de índice, que oferece uma visão geral do uso da chave de índice.

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

Encontrar conexões entre métricas diferentes para chaves de documentos

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, convém verificar se os pontos de acesso no mapa de calor Ops/s estão correlacionados com alta latência no mapa de calor de Latência média de gravação.

Para visualizar várias métricas e seus valores ao mesmo tempo, clique em Mostrar painel de informações no canto superior direito. Uma lista de métricas é exibida em um painel à direita da verificação.

Exemplo mostrando o painel multimétrico para 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.

    Seta à esquerda que mostra uma métrica na janela principal

  • 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:

  1. Aponte para uma posição de interesse no mapa de calor grande na janela principal.
  2. Clique para fixar a dica. Os valores no painel lateral permanecem fixos no bucket de chaves e no período em que você fixou.
  3. 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