Esta página descreve como usar o painel de controlo Estatísticas de consultas para detetar e analisar o desempenho das consultas.
Vista geral das estatísticas de consultas
Use o painel de controlo Estatísticas de consultas para monitorizar consultas relacionadas com métricas. Com base nas métricas, pode identificar as consultas usadas com maior frequência e as consultas com latências elevadas que podem exigir otimização. Use o painel de controlo Estatísticas de consultas para ajudar com o seguinte:
- Otimização do desempenho das consultas: identifique consultas com latências elevadas e que podem precisar de otimização.
- Gestão de custos de consultas: descubra consultas de custo elevado e otimize-as para reduzir os custos.
- Monitorização das estatísticas de consultas: acompanhe as estatísticas de consultas ao longo do tempo.
Consulte dados de estatísticas de consultas
As estatísticas de consultas incluem dados dos seguintes métodos da API:
Pode ver dados sobre as consultas que usam estes métodos para um determinado projeto, base de dados e duração que varia entre 10 minutos e 30 dias. Os dados de consultas com estruturas equivalentes são capturados numa única consulta normalizada.
As estatísticas de consultas devolvem as seguintes informações sobre uma consulta:
| Texto da consulta normalizado | A estrutura da consulta representada em texto. |
| Número de execuções | Número de execuções no período selecionado. |
| Contagem de erros | O número de erros no intervalo de tempo selecionado. |
| Duração média da execução(ms) | O tempo médio em milissegundos que a base de dados demorou a processar a consulta. |
| Número médio de resultados devolvidos | O número de resultados devolvidos pela consulta. Os resultados incluem entidades, IDs de tipos, projeções e intervalos agregados. |
| Número médio de entidades analisadas | O número de entidades analisadas numa consulta. |
| Número médio de entradas de índice analisadas | O número de entradas de índice examinadas para executar a consulta. |
| Carregamento por tempo médio | Dados que ajudam a filtrar as principais consultas com base na latência média. |
| Carregamento 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. |
Nível de detalhe e retenção de dados
O nível de detalhe dos dados depende da duração especificada:
- Nível de detalhe de 10 minutos para intervalos até 4 dias atrás
- Nível de detalhe de 1 hora para intervalos até 30 dias atrás
A retenção máxima de dados para as estatísticas de consultas é de 30 dias. Os dados de 10 minutos são armazenados durante 4 dias e os dados por hora são armazenados durante 30 dias.
Limitações
- Os dados das estatísticas de consultas têm um atraso de uma a duas horas.
Preços
As estatísticas de consultas não têm custos adicionais.
Funções necessárias
Para receber a autorização de que
precisa para ver o painel de controlo Estatísticas de consultas,
peça ao seu administrador para lhe conceder a
função IAM Visualizador do Datastore (roles/datastore.viewer)
no seu projeto.
Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.
Esta função predefinida contém a autorização
datastore.insights.get
, que é necessária para
ver o painel de controlo Estatísticas de consultas.
Também pode receber esta autorização com funções personalizadas ou outras funções predefinidas.
Veja as estatísticas de consultas
Para ver as estatísticas de consultas de uma base de dados do Firestore no modo Datastore, abra o painel Estatísticas de consultas na Google Cloud consola.
Na Google Cloud consola, aceda à página Bases de dados.
Na lista de bases de dados, selecione uma base de dados.
No menu de navegação, clique em Estatísticas de consultas.
Use o menu pendente Tipo de carregamento para encontrar as principais consultas por latência ou número de operações de leitura.
O que se segue?
- Use o comando query explain para melhorar o desempenho das consultas
- Monitorize a utilização