Esta página oferece uma vista geral da ferramenta de diagnóstico Key Visualizer para o Firestore no modo Datastore.
O que é o Key Visualizer?
O Key Visualizer é uma ferramenta que ajuda a analisar os seus padrões de utilização do modo Datastore. Gera relatórios visuais que discriminam a sua utilização com base nas entidades às quais acede ou nas entradas de índice que são escritas ou eliminadas à medida que as entidades são modificadas.
O Key Visualizer pode fornecer estatísticas sobre padrões de utilização à escala. As utilizações do visualizador de chaves incluem:
- Resolução de problemas de desempenho. O Key Visualizer ajuda a identificar problemas de desempenho na sua base de dados causados por pontos críticos de chaves de entidades ou de índices sequenciais, ou aumentos súbitos de tráfego.
- Compreender melhor como acede aos dados armazenados no modo Datastore.
- Conceber iterativamente um modelo de dados ou melhorar o design de um modelo de dados existente. Em cada iteração, pode verificar o Key Visualizer para detetar problemas causados pelo seu modelo de dados.
Para alcançar estes objetivos, o visualizador de chaves pode ajudar a concluir as seguintes tarefas:
- Verifique se as suas leituras ou escritas criam pontos críticos em intervalos de entidades específicos.
- Veja como um aumento súbito no tráfego afeta a latência.
- Verifique se os seus padrões de acesso estão equilibrados na base de dados.
- Verifique a estrutura das chaves de índice para identificar as definições de índice que causam problemas de carregamento de índices.
- Use a visualização das chaves de índice para fazer melhores previsões de padrões de carga de trabalho.
Verifique a elegibilidade
Cada análise do visualizador de chaves abrange um período de duas horas. Uma análise de um determinado período está disponível para bases de dados com tráfego que exceda 3000 operações de documentos em qualquer minuto desse período.
A elegibilidade para a análise depende totalmente da atividade da base de dados. Não depende da quantidade de dados nem do tipo de dados na sua base de dados.
Análises do Key Visualizer
A imagem seguinte mostra uma análise do Key Visualizer. Cada análise inclui um mapa de calor que mostra padrões de acesso ou métricas de desempenho para um grupo de chaves de entidades ou chaves de índice ao longo do tempo.
Partilhar URLs de análise
Pode partilhar ou adicionar aos favoritos o URL de uma análise do Key Visualizer. O URL abre a mesma análise do Key Visualizer e seleciona a mesma métrica. Este URL é válido até à expiração da duração dos dados de verificação.
Mapas térmicos
O núcleo de uma análise do Key Visualizer é o mapa de calor, que mostra o valor de uma métrica ao longo do tempo, discriminado em até 1000 grupos de chaves contíguos.
Para um mapa térmico de chaves de entidades, o eixo X do mapa térmico representa o tempo e o eixo Y representa as chaves de entidades. Já para um mapa térmico de chaves de índice, o eixo X do mapa térmico representa o tempo e o eixo Y representa as chaves de índice.
Cada análise do Key Visualizer para o Firestore no modo Datastore abrange duas horas de atividade divididas em segmentos de 10 segundos.
Um valor baixo para uma métrica é considerado "frio" e aparece como uma cor escura. Um valor elevado é "quente" e aparece como uma cor brilhante. Os valores mais elevados aparecem a branco.
Os diferentes tipos de utilização resultam em diferentes padrões visuais no mapa de calor, o que pode permitir diagnosticar problemas rapidamente. Consulte Padrões de mapa de calor para chaves de entidades ou Padrões de mapa de calor para chaves de índice para ver exemplos de alguns padrões comuns.
O Key Visualizer oferece ferramentas que ajudam a compreender os dados em cada análise. Consulte os artigos Começar a usar o Key Visualizer e Explorar mapas de calor.
Contentores de chaves
O Key Visualizer divide todas as chaves na sua base de dados em até 1000 intervalos contíguos, com aproximadamente o mesmo número de chaves e operações/s em cada intervalo. Estes intervalos são conhecidos como grupos de chaves.
O Key Visualizer usa o total de operações/s de uma base de dados para dividir os contentores de chaves, de modo que cada contentor capture aproximadamente o mesmo número de operações/s com um tamanho mínimo pretendido de 50 operações/s por contentor de chaves. Para bases de dados com um total de operações/s mais elevado, os contentores de chaves podem captar mais de 50 operações/s cada. As bases de dados com menos de 50 operações/s resultam em análises com um único contentor de chaves.
O Key Visualizer apresenta a maioria das métricas como médias em cada grupo de chaves ou como valores máximos em cada grupo de chaves.
Métrica
As seguintes métricas estão disponíveis para chaves de entidades em análises do Key Visualizer:
| Métrica | Descrição |
|---|---|
| Métricas de atividade | |
| Ops/s | Número médio de operações de entidades por segundo. Geralmente igual à soma das gravações, das pesquisas e das consultas por segundo. Esta métrica pode indicar que teclas estão quentes. |
| Operações de escrita/s | Número médio de operações de entidades por segundo para escritas e eliminações. |
| Operações de pesquisa/s | Número médio de operações de entidades por segundo para pesquisas. |
| Operações de consulta/s | Número médio de operações de entidades por segundo para consultas. |
| Métricas de desempenho | |
| Latência média de gravação | Latência média para gravações e eliminações nos dados processados no contentor. |
| Latência média de pesquisa | Latência média das pesquisas nos dados processados na categoria. |
| Latência média da consulta | Latência média das consultas nos dados processados na categoria. |
| Escrever latência de cauda | Latência máxima de gravação ou eliminação observada nos dados processados no contentor. |
| Latência de cauda de pesquisa | Latência de pesquisa observada máxima nos dados processados no contentor. |
| Latência de cauda da consulta | Latência máxima da consulta observada nos dados processados no contentor. |
A seguinte métrica está disponível para chaves de índice em análises do Key Visualizer:
| Métrica | Descrição |
|---|---|
| Operações de escrita de índice/s | Número médio de gravações de índice por segundo. |
Médias de desempenho
As métricas de latência média calculam a média das chaves no conjunto de chaves. Uma vez que esta medição é feita na camada de armazenamento, a latência comunicada aqui pode ser inferior à latência total que uma chamada API experimenta.
Limites
Embora o Key Visualizer mostre uma variedade de métricas, não apresenta todas as métricas que podem afetar o desempenho do modo Datastore. Por exemplo:
- Os problemas de rede entre a sua aplicação e Google Cloud podem não ser visíveis. Podem aparecer como faixas verticais em todas as teclas no Key Visualizer, o que apenas lhe dá indicações sobre quando ocorreram os problemas.
Duração dos dados
Os dados recolhidos pelo Key Visualizer para o Firestore no modo Datastore são eliminados após 14 dias.
Os dados do Key Visualizer estão disponíveis para os últimos 14 dias. Por exemplo, se iniciar o Key Visualizer a 19 de dezembro às 12:45, a hora de início mais próxima que pode escolher para um período de 2 horas é 5 de dezembro às 13:00.
Este limite também significa que, se adicionar aos favoritos ou partilhar o URL de uma leitura do Key Visualizer, o URL tem uma duração máxima de 14 dias.
O que se segue?
- Saiba como começar a usar o Key Visualizer.
- Compreenda os padrões de chaves de entidades ou os padrões de chaves de índices que pode ver nos mapas de calor do Key Visualizer.
- Saiba como explorar um mapa térmico em detalhe.