Analyser les statistiques sur les performances des requêtes
Cette page explique comment utiliser le tableau de bord Insights sur les requêtes pour détecter et analyser les performances des requêtes.
Présentation des insights sur les requêtes
Utilisez le tableau de bord "Insights sur les requêtes" pour surveiller les requêtes liées aux métriques. En fonction des métriques, vous pouvez identifier les requêtes les plus fréquemment utilisées et celles qui présentent une latence élevée et qui peuvent nécessiter une optimisation. Le tableau de bord "Insights sur les requêtes" vous permet de :
- Optimisation des performances des requêtes : identifiez les requêtes présentant une latence élevée et qui peuvent nécessiter une optimisation.
- Gestion des coûts des requêtes : identifiez les requêtes coûteuses et optimisez-les pour réduire les coûts.
- Surveillance des statistiques sur les requêtes : suivez les statistiques sur les requêtes au fil du temps.
Données des insights sur les requêtes
Les insights sur les requêtes incluent des données provenant des méthodes d'API suivantes :
Vous pouvez afficher des données sur les requêtes qui utilisent ces méthodes pour un projet, une base de données et une durée donnés (de 10 minutes à 30 jours). Les données des requêtes ayant des structures équivalentes sont capturées dans une seule requête normalisée.
Les insights sur les requêtes renvoient les informations suivantes sur une requête :
| Texte de requête normalisé | Structure de la requête représentée sous forme de texte. |
| Nombre d'exécutions | Nombre d'exécutions dans la fenêtre de temps sélectionnée. |
| Nombre d'erreurs | Nombre d'erreurs dans la période sélectionnée. |
| Durée d'exécution moyenne(ms) | Temps moyen en millisecondes nécessaire à la base de données pour traiter la requête. |
| Nombre moyen de résultats renvoyés | Nombre de résultats renvoyés par la requête. Les résultats incluent des documents, des ID de collection et des buckets agrégés. |
| Nombre moyen de documents analysés | Nombre de documents analysés dans une requête. |
| Nombre moyen d'entrées d'index analysées | Nombre d'entrées d'index examinées pour exécuter la requête. |
| Charge par durée moyenne | Données permettant de filtrer les requêtes les plus performantes en fonction de la latence moyenne. |
| Charge par nombre total d'opérations de lecture (facturables) | Données permettant de filtrer les requêtes les plus importantes en fonction du nombre total d'opérations de lecture facturables. |
Précision et conservation des données
La précision des données dépend de la durée spécifiée :
- Précision de 10 minutes pour les intervalles jusqu'à quatre jours
- Précision d'une heure pour les intervalles jusqu'à 30 jours
La durée de conservation maximale des données pour les insights sur les requêtes est de 30 jours. Les données de 10 minutes sont stockées pendant quatre jours, et les données horaires pendant 30 jours.
Limites
- Les écouteurs en temps réel ne sont pas inclus dans les statistiques des insights sur les requêtes.
- Les données sur les insights sur les requêtes sont retardées d'une à deux heures.
Tarifs
Insights sur les requêtes n'entraîne aucun coût supplémentaire.
Rôles requis
Pour obtenir l'autorisation nécessaire pour afficher le tableau de bord "Insights sur les requêtes", demandez à votre administrateur de vous accorder le rôle IAM Lecteur Datastore (roles/datastore.viewer) sur votre projet.
Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.
Ce rôle prédéfini contient l'autorisation datastore.insights.get, qui est nécessaire pour afficher le tableau de bord "Insights sur les requêtes".
Vous pouvez également obtenir cette autorisation avec des rôles personnalisés ou d'autres rôles prédéfinis.
Afficher les insights sur les requêtes
Pour afficher les insights sur les requêtes d'une base de données Firestore, ouvrez le volet Insights sur les requêtes de la base de données dans la console Google Cloud .
Dans la console Google Cloud , accédez à la page Bases de données.
Dans la liste des bases de données, sélectionnez-en une.
Dans le menu de navigation, cliquez sur Insights sur les requêtes.
Utilisez le menu déroulant Type de chargement pour trouver les principales requêtes par latence ou par nombre d'opérations de lecture.
Étapes suivantes
- Utiliser query explain pour améliorer les performances des requêtes
- Surveiller l'utilisation