Visão geral do Key Visualizer

O que é o Key Visualizer?

O Key Visualizer ajuda a analisar os padrões de uso do Spanner. Ele gera relatórios visuais para os bancos de dados, divididos por intervalos de linhas ao longo do tempo.

Além disso, ele fornece insights sobre padrões de uso em escala, difíceis de entender de outra forma. Os usos do Key Visualizer incluem:

  • Projetar iterativamente um esquema ou melhorar o design de um esquema atual. Em cada iteração, verifique o Key Visualizer para detectar problemas que seu esquema pode estar causando, ajustar o esquema e verificar novamente.
  • Solucionar problemas de desempenho para entender como consultas e operações usam recursos;
  • Entender como os usuários e os aplicativos acessam os dados que você armazena no Spanner.

Para atingir essas metas, o Key Visualizer pode ajudar a concluir as seguintes tarefas:

  • Verificar se as leituras ou gravações estão criando pontos de acesso em intervalos de linha específicos.
  • Conferir se os padrões de acesso estão balanceados em todas as linhas de uma tabela.

Embora o Key Visualizer mostre várias métricas, ele não captura tudo que pode afetar o desempenho do Spanner. Por exemplo, se houver problemas de rede entre seu aplicativo e o Google Cloud, esses problemas podem não estar visíveis ou podem aparecer como faixas verticais em todas as chaves no Key Visualizer, o que só fornece dicas sobre quando os problemas ocorreram. Caso você não consiga identificar a causa de um problema de desempenho ao examinar as verificações do Key Visualizer, será necessária outra solução de problemas.

Verificações do Key Visualizer

A imagem a seguir mostra uma verificação do Key Visualizer. Cada uma inclui alguns tipos diferentes de informação:

  • Um grande mapa de calor, que mostra padrões de acesso de um grupo de chaves de linha ao longo do tempo.
  • Valores agregados ao longo de cada eixo do mapa de calor, incluindo valores médios, totais ou máximos.

Exemplo de verificação do Key Visualizer

No Key Visualizer também há ferramentas para entender os dados em cada verificação. Caso ainda não tenha usado o Key Visualizer, veja as instruções em Primeiros passos com o Key Visualizer. Se você for um usuário mais experiente, consulte Como analisar mapas de calor.

Mapas de calor

O núcleo de uma verificação do Key Visualizer é o mapa de calor, que mostra o valor de uma métrica ao longo do tempo dividido em intervalos contíguos de chaves de linha. O eixo x do mapa de calor representa o tempo. O eixo y representa os intervalos de linha. Caso em determinado momento a métrica tenha um valor baixo para um grupo de chaves de linha, ela estará "fria" e será exibida em cor escura. Um valor alto é "quente" e exibido com uma cor chamativa. Já os valores mais altos aparecem em branco.

No mapa de calor, diferentes tipos de uso resultam em padrões visuais distintos, o que possibilita o diagnóstico rápido de problemas. Veja alguns exemplos de padrões comuns em Padrões do mapa de calor.

Intervalos de linha

Um intervalo de linha é um conjunto contíguo de linhas em uma única tabela ou índice. Ele é definido por uma chave de início e uma chave de término.

Um banco de dados do Spanner geralmente usa muitas tabelas e índices. O Key Visualizer seleciona até mil intervalos de linhas com base nas chaves existentes em todas as tabelas e índices em todo o banco de dados. No mapa de calor, cada chave é classificada em ordem alfabética com base no nome da tabela ou do índice. Dentro de cada tabela ou índice, as chaves são classificadas pelos respectivos valores de chave primária. Como resultado, um intervalo de linhas consiste apenas em chaves de uma única tabela ou índice. Para tabelas intercaladas, os intervalos de linha de uma tabela pai não incluem nenhuma chave das tabelas filhas intercaladas.

O Key Visualizer seleciona no máximo 1.000 intervalos de linha. Quando há mais de 1.000 tabelas e índices combinados, algumas delas são agrupadas em um único ponto de dados no mapa de calor e são exibidas como uma única linha. Portanto, pode ser difícil detectar possíveis pontos de acesso porque as tabelas deles são combinadas e reduzidas.

Se houver menos de 1.000 tabelas e índices, o mapa de calor terá pelo menos um intervalo de linhas representando cada tabela.

A seguir