Visão Geral do Key Visualizer

Nesta página, você terá uma visão geral da ferramenta de diagnóstico Key Visualizer para o Cloud Bigtable.

O que é o Key Visualizer?

Key Visualizer é uma ferramenta que ajuda a analisar os padrões de uso do Cloud Bigtable. São gerados relatórios visuais das tabelas e o uso é dividido com base nas chaves de linha acessadas por você.

Além disso, são fornecidos 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.
  • Entender melhor como você acessa os dados armazenados no Cloud Bigtable.

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 linhas específicas.
  • Encontrar linhas que tenham muitos dados.
  • Conferir se os padrões de acesso estão balanceados em todas as linhas de uma tabela.

O Key Visualizer mostra uma série de métricas. No entanto, ele não exibe as que afetam o desempenho do Cloud Bigtable. 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 verificação 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, veja detalhes em 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 as chaves de linha. Caso a métrica tenha em determinado momento 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.

Por padrão, um mapa de calor do Key Visualizer mostra a métrica de Ops que representa o número combinado de leituras e gravações. É possível alternar para o mapa de calor de uma métrica diferente a qualquer momento. Para detalhes, veja Como alternar entre métricas.

Também é possível ver mais dados de uma métrica de uma vez só, o que ajuda você a encontrar relações entre métricas diferentes.

Chaves de linha hierárquicas

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 de guias, conforme mostrado no exemplo acima, à esquerda. Esse recurso ajuda a entender como os dados e padrões de acesso são distribuídos entre as linhas da tabela. Além disso, ele também permite detalhar os dados para intervalos específicos de chaves de linha com mais rapidez.

Caso as chaves de linha não sejam compostas por diversos valores, o Visualizador de Chaves ainda exibirá guias no lado esquerdo da verificação, mas talvez essas guias dividam as chaves de linha de maneiras inesperadas, em vez de apresentar uma hierarquia limpa.

buckets de chaves

Uma tabela do Cloud Bigtable contém trilhões de linhas. Portanto, nem sempre é prático relatar métricas para cada linha individualmente. Em vez disso, o Key Visualizer dividirá todas as chaves de linha em 1.000 intervalos contíguos, com aproximadamente o mesmo número de chaves de linha em cada intervalo. Esses buckets são conhecidos como buckets de chaves.

O Key Visualizer relata a maioria das métricas como médias sobre cada bucket de chaves ou como valores máximos dentro de cada bucket de chaves. Para métricas de Avisos e Desempenho, o Key Visualizer fornece maior precisão relatando métricas para chaves de linha individuais ou para buckets de chaves específicos dentro do bucket de chaves.

Nos bastidores, o Key Visualizer gera novos dados de verificação a cada 15 minutos. Para concatenar dados em períodos contíguos, o Key Visualizer tenta manter os mesmos intervalos de chaves dos 15 minutos anteriores. Também é possível que as chaves excluídas ainda apareçam como limites de intervalo. Como as tabelas mudam ao longo do tempo à medida que os dados são adicionados e removidos, às vezes os intervalos de chaves são recalculados para que sejam balanceados.

O Key Visualizer também gera um novo conjunto de intervalos de chaves a cada duas semanas, mesmo que a tabela não tenha mudado muito, apenas para remover os limites de intervalos residuais das chaves excluídas. Como resultado, mesmo que sua tabela esteja estável, você perceberá que seus intervalos de chave são atualizados ocasionalmente.

Valores agregados

Além do mapa de calor, o Key Visualizer inclui na verificação valores agregados em gráficos de barras nos lados inferior e direito do mapa. Ao passar o mouse sobre os valores agregados, o Key Visualizer destaca uma área restrita no mapa de calor e mostra as seguintes informações:

  • Para o eixo x, ele mostra o valor médio da métrica atual, com o valor total ou máximo. Esses valores aparecem para todos os intervalos de chaves visíveis em intervalos de 15 minutos.
  • Para o eixo y, ele mostra o valor médio da métrica atual no intervalo de tempo visível, dividido em intervalos de chaves.

Limites

Tamanho mínimo da tabela para verificações

O Key Visualizer está disponível para tabelas que contenham pelo menos 30 GB de dados. Depois que a tabela atingir esse tamanho, a disponibilização das verificações pode levar até uma hora.

Intervalos de tempo

  • Mínimo: o período mais curto que você pode ver no Key Visualizer é de 15 minutos.
  • Máximo: o período mais longo que você pode ver é de 14 dias.
  • Tamanho do incremento: os dados do Key Visualizer estão disponíveis em incrementos de 15 minutos.

Duração dos dados

Os dados do Key Visualizer estão disponíveis para os últimos 14 dias. Por exemplo, se você iniciar o Key Visualizer em 19 de dezembro, às 12h45, o primeiro horário de início que poderá ser escolhido será 12h45 de 5 de dezembro.

Esse limite também significa que, se você adicionar aos favoritos ou compartilhar o URL de uma verificação do Key Visualizer, o URL terá uma duração máxima de 14 dias.

A seguir