Analisar estatísticas de desempenho da consulta
Nesta página, descrevemos como usar o painel do Query Insights para detectar e analisar o desempenho das consultas.
Visão geral do Query Insights
Use o painel "Query Insights" para monitorar consultas relacionadas a métricas. Com base nas métricas, é possível identificar as consultas mais usadas e aquelas com alta latência que podem precisar de otimização. Use o painel "Query Insights" para:
- Otimização do desempenho da consulta: identifique consultas com latências altas e que talvez precisem de otimização.
- Gerenciamento de custos de consulta: descubra consultas de alto custo e otimize-as para reduzir os custos.
- Monitoramento de estatísticas de consulta: acompanhe as estatísticas de consulta ao longo do tempo.
- Recomendações de índice: identifique índices compostos ausentes ou abaixo do ideal e crie índices recomendados diretamente no painel (edição Enterprise).
Dados do Query Insights
Os Query Insights incluem dados dos seguintes métodos de API:
É possível conferir dados sobre as consultas que usam esses métodos para um determinado projeto, banco de dados e período que varia de 1 minuto a 30 dias. Os dados de consultas com estruturas equivalentes são capturados em uma única consulta normalizada.
Os Query Insights retornam as seguintes informações sobre uma consulta:
| Texto da consulta normalizada | A estrutura da consulta representada em texto. |
| Contagem de execução | Número de execuções na janela de tempo selecionada. |
| Contagem de erros | Número de erros na janela de tempo selecionada. |
| Duração média da execução(ms) | O tempo médio em milissegundos que o banco de dados levou para processar a consulta. |
| Número médio de resultados retornados | O número de resultados retornados pela consulta. Os resultados incluem documentos, IDs de coleção e agrupamentos agregados. |
| Número médio de documentos verificados | O número de documentos verificados em uma consulta. |
| Número médio de registros de index verificados | O número de registros de index examinados para executar a consulta. |
| Carga por tempo médio | Dados para ajudar a filtrar as principais consultas com base na latência média. |
| Carga por total de operações de leitura (faturáveis) | Dados para ajudar a filtrar as principais consultas com base no total de operações de leitura faturáveis. |
| Recomendações de índice | Índices compostos recomendados, índices usados e impacto estimado da carga de trabalho para consultas em bancos de dados da edição Enterprise. |
Granularidade e retenção de dados
A granularidade dos dados depende da duração especificada:
- Granularidade de 1 minuto para intervalos de até 6 horas atrás
- Granularidade de 10 minutos para intervalos de até 4 dias atrás
- Granularidade de uma hora para intervalos de até 30 dias atrás
O período máximo de retenção de dados para Query Insights é de 30 dias. Os dados de 1 minuto são armazenados por 6 horas, os dados de 10 minutos são armazenados por 4 dias e os dados por hora são armazenados por 30 dias.
Mostrar o Query Insights
Para conferir os Query Insights de um banco de dados do Firestore, faça o seguinte:
No console do Google Cloud , acesse a página Bancos de dados.
Na lista, selecione um banco de dados.
No menu de navegação, clique em Query Insights.
A página Query Insights exibe um gráfico de série temporal das principais consultas ao lado de uma tabela de estatísticas de consulta normalizadas. Para analisar o desempenho da consulta:
- Selecione um período para conferir as tendências históricas ou as métricas quase em tempo real em intervalos de 1 minuto.
- Use a lista Tipo de carga para classificar as principais consultas por latência média ou total de operações de leitura.
- Selecione consultas individuais na tabela para traçar e comparar as contagens de execução, a latência, os documentos verificados, os registros de index verificados e as contagens de erros no gráfico.
Recomendações de índice
As recomendações de índice do Query Insights identificam automaticamente configurações de índice composto ausentes ou abaixo do ideal para formas de consulta executadas com frequência em bancos de dados da edição Firestore Enterprise.Na edição Firestore Enterprise, as consultas podem ser executadas mesmo sem índices compostos correspondentes, o que pode resultar em verificações lentas de coleções completas ou operações de classificação na memória. O painel do Query Insights analisa as estatísticas históricas de execução de consultas e sugere índices compostos direcionados para otimizar a latência de consultas e reduzir os documentos verificados faturáveis.
Como funcionam as recomendações de índice
Um pipeline de lote off-line avalia periodicamente as principais consultas históricas:
- Análise da estrutura de consultas: extrai predicados de igualdade, classificação e intervalo de consultas executadas com frequência.
- Geração de índices candidatos: gera possíveis definições de índice composto usando heurísticas de ordenação de índice (Igualdade > Classificação > Intervalo).
- Avaliação do otimizador: injeta índices candidatos no modelo de custo do mecanismo de consulta para comparar os custos de execução de consulta de referência com planos de execução indexados hipotéticos.
- Classificação de impacto na carga de trabalho: classifica os índices recomendados em níveis de impacto com base na economia total estimada de custos de carga de trabalho:
- ALTA: converte verificações completas de coleções em buscas de índice seletivas, reduzindo significativamente as leituras de documentos e a latência de execução.
- MÉDIO: elimina operações caras, como classificação na memória, fornecendo resultados de índice pré-classificados.
- BAIXA: oferece pequenas melhorias de busca.
Ver e criar índices recomendados
Para ver as recomendações de índice e criar índices sugeridos no console doGoogle Cloud :No console do Google Cloud , acesse a página Bancos de dados.
Na lista de bancos de dados, selecione um banco de dados da edição Enterprise.
No menu de navegação, clique em Query Insights.
Na tabela de consultas, selecione um formato de consulta para ver o card Recomendações. O card mostra:
- A definição de índice composto recomendada (coleção, campos, ordens de classificação ou propriedades de conteúdo da matriz).
- O nível estimado de impacto na carga de trabalho (HIGH, MEDIUM ou LOW).
- Os índices usados ou uma indicação de que uma verificação completa da coleção é realizada.
Clique em Criar índice no card de recomendação. Uma caixa de diálogo é aberta com a coleção, o escopo da consulta e os campos pré-preenchidos.
Clique em Criar para começar a criar o índice. É possível monitorar o progresso da criação do índice na página Índices no console do Google Cloud .
Edições e modos compatíveis
As recomendações de índice são compatíveis com os bancos de dados da edição Firestore Enterprise, incluindo:
- Firestore no modo nativo
- Firestore com compatibilidade com o MongoDB
Os bancos de dados da edição Standard não são compatíveis com as recomendações de índice.
Limitações
- Os listeners em tempo real não estão incluídos nas estatísticas do Query Insights.
- Os dados do Query Insights ficam disponíveis minutos após a execução da consulta.
- As recomendações de índice são geradas periodicamente com base em dados históricos de consulta, não em tempo real.
- As recomendações de índice sugerem novos índices compostos, mas não sugerem a modificação ou exclusão de índices atuais.
- A criação automática de índices não é compatível. Os índices recomendados precisam ser criados manualmente.
- A normalização de consultas substitui valores literais por marcadores de posição. As recomendações de índice são baseadas em modelos de consulta normalizados, e não em valores de ambiente de execução específicos.
- A avaliação de custo usa heurísticas em vez de amostragem de dados em tempo real. Os índices recomendados podem não melhorar o desempenho em todos os cenários, e a criação de um índice adiciona sobrecarga de gravação e armazenamento.
Preços
Não há custo adicional para Query Insights ou recomendações de índice.
Funções exigidas
Para receber as permissões necessárias para visualizar o painel do Query Insights e criar índices recomendados, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:
-
Acessar o Query Insights:
Leitor do Datastore (
roles/datastore.viewer) -
Crie os índices recomendados:
- Administrador de índice do armazenamento de dados (
roles/datastore.indexAdmin) - Proprietário do Cloud Datastore (
roles/datastore.owner) - Editor (
roles/editor) - Proprietário (
roles/owner)
- Administrador de índice do armazenamento de dados (
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Esses papéis predefinidos contêm as permissões necessárias para acessar o painel do Query Insights e criar índices recomendados. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
As seguintes permissões são necessárias para acessar o painel do Query Insights e criar índices recomendados:
-
Acessar o Query Insights:
datastore.insights.get -
Crie os índices recomendados:
-
datastore.indexes.create -
datastore.indexes.update
-
Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.
A seguir
- Usar o Query Explain para melhorar o desempenho da consulta
- Monitorar o uso