Cette page explique comment utiliser le tableau de bord d'Insights sur les requêtes pour détecter et analyser les performances des requêtes.
Présentation d'Insights sur les requêtes
Utilisez le tableau de bord d'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 des latences élevées et qui peuvent nécessiter une optimisation. Le tableau de bord d'Insights sur les requêtes vous permet d'effectuer les opérations suivantes :
- Optimiser les performances des requêtes : identifiez les requêtes présentant des latences élevées et qui peuvent nécessiter une optimisation.
- Gérer les coûts des requêtes : découvrez les requêtes coûteuses et optimisez-les pour réduire les coûts.
- Surveiller les statistiques sur les requêtes : suivez les statistiques sur les requêtes au fil du temps.
Données d'Insights sur les requêtes
Insights sur les requêtes inclut les données des méthodes d'API suivantes :
listDocumentslistCollectionIdsrunQueryrunAggregationQuerypartitionQueryexecutePipeline
Vous pouvez afficher les données sur les requêtes qui utilisent ces méthodes pour un projet, une base de données et une durée allant de 10 minutes à 30 jours. Les données des requêtes dont la structure est équivalente sont capturées sous une seule requête normalisée.
Insights sur les requêtes renvoie les informations suivantes sur une requête :
| Texte de la requête normalisée | Structure de la requête représentée sous forme de texte. |
| Nombre d'exécutions | Nombre d'exécutions dans la période 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 les documents, les ID de collection, et les 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. |
| Latence moyenne | Données permettant de filtrer les principales requêtes en fonction de la latence moyenne. |
| Charge par nombre total d'opérations de lecture (facturables) | Données permettant de filtrer les principales requêtes en fonction du nombre total d'opérations de lecture facturables. |
Granularité et conservation des données
La granularité des données dépend de la durée spécifiée :
- Granularité de 10 minutes pour les intervalles remontant jusqu'à 4 jours
- Granularité d'une heure pour les intervalles remontant jusqu'à 30 jours
La durée maximale de conservation des données pour Insights sur les requêtes est de 30 jours. Les données de 10 minutes sont stockées pendant 4 jours, et les données horaires sont stockées pendant 30 jours.
Limites
- Les données d'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 d'Insights sur les requêtes,
demandez à votre administrateur de vous accorder le
rôle IAM Lecteur Datastore (roles/datastore.viewer) sur votre projet.
Ce rôle prédéfini contient l'autorisation datastore.insights.get, qui est nécessaire pour afficher le tableau de bord d'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 Insights sur les requêtes
Pour afficher les insights sur les requêtes d'une Cloud Firestore base de données, 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.
Tableau de bord d'utilisation de la base de données Cloud Firestore dans la console Google Cloud."/>Utilisez le menu déroulant Type de charge pour trouver les principales requêtes par latence ou par nombre d'opérations de lecture.