| Relevante apenas para a edição Enterprise do Cloud Firestore. |
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:
findaggregate
É 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 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.
Esse papel predefinido contém a permissão datastore.insights.get, que é necessária para acessar o painel "Query Insights".
Também é possível conseguir essa permissão com papéis personalizados ou outros papéis predefinidos.
Mostrar o Query Insights
Para conferir o Query Insights de um banco de dados do Cloud Firestore com compatibilidade com o MongoDB, abra o painel Query Insights 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.