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.
Dados de 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 10 minutos 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 entradas de índice verificadas | O número de entradas de índice examinadas 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. |
Granularidade e retenção de dados
A granularidade dos dados depende da duração especificada:
- 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 10 minutos são armazenados por 4 dias, e os dados por hora são armazenados por 30 dias.
Limitações
- Os listeners em tempo real não são incluídos nas estatísticas do Query Insights.
- Os dados de Query Insights têm um atraso de uma a duas horas.
Preços
Não há custo adicional para gerar o Query insights.
Funções exigidas
Para receber a permissão necessária
para acessar o painel do Query Insights,
peça ao administrador para conceder a você o
papel Leitor do Datastore (roles/datastore.viewer)
do IAM no seu projeto.
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Esse papel predefinido contém a
permissão
datastore.insights.get
, que é
necessária para acessar o painel "Insights de consultas".
Também é possível conseguir essa permissão com papéis personalizados ou outros papéis predefinidos.
Mostrar o Query Insights
Para conferir insights de consultas de um banco de dados do Firestore, abra o painel Insights de consultas no console do Google Cloud .
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.
Use o menu suspenso Tipo de carga para encontrar as principais consultas por latência ou número de operações de leitura.
A seguir
- Usar query explain para melhorar o desempenho da consulta
- Monitorar o uso