Surveiller l'utilisation
Cette page explique comment surveiller votre utilisation de Firestore et détecter les problèmes potentiels dans votre application.
Tableau de bord sur l'utilisation
Utilisez les tableaux de bord d'utilisation de la console Google Cloud et de la console Firebase pour afficher les lectures, les écritures et les suppressions de documents au fil du temps.
Contrôle des accès
Les tableaux de bord d'utilisation nécessitent l'autorisation IAM monitoring.timeSeries.list.
Les rôles "Propriétaire", "Éditeur" et "Lecteur" accordent cette autorisation. Vous pouvez également accorder cette autorisation via un rôle Cloud Monitoring ou un rôle personnalisé.
Tableau de bord d'utilisation de la base de données
Pour afficher les métriques d'utilisation d'une base de données Firestore, ouvrez la page Utilisation de la base de données dans la console Google Cloud.
Dans la console Google Cloud, accédez à la page Base de données.
Sélectionnez la base de données requise dans la liste des bases de données.
Dans le menu de navigation, cliquez sur Utilisation.
Cliquez sur le lien dans le message qui s'affiche sur la page pour afficher l'utilisation de votre base de données.
Tableau de bord d'utilisation agrégée
Si votre projet comporte plusieurs bases de données Firestore, vous pouvez afficher les métriques d'utilisation agrégées dans la console Google Cloud ou la console Firebase. Le tableau de bord d'utilisation au niveau du projet combine les métriques d'utilisation de toutes vos bases de données Firestore en mode natif. Ce tableau de bord n'inclut pas l'utilisation de Firestore dans les bases de données en mode Datastore.
console Google Cloud
Dans la console Google Cloud, accédez à la page Utilisation des projets.
Accéder à la page "Utilisation du projet Google Cloud"
Le tableau de bord d'utilisation du projet montre les opérations sur les documents au fil du temps, comme suit:
Console Firebase
Accéder à la page d'utilisation de Firestore (console Firebase)
Tableau de bord d'utilisation et rapports de facturation
Les tableaux de bord d'utilisation de Firestore dans les consoles Firebase et Cloud fournissent une estimation de l'utilisation. Ils peuvent vous aider à identifier les pics d'utilisation. Toutefois, le tableau de bord n'est pas une vue exacte des opérations facturées. Le niveau d'utilisation facturé est généralement plus important. Dans tous les cas où un écart est constaté, le rapport de facturation prévaut sur le tableau de bord d'utilisation.
Opérations qui entraînent des écarts entre le tableau de bord d'utilisation et l'utilisation facturée :
- Opérations d'importation et d'exportation. Les lectures et écritures effectuées par ces opérations n'apparaissent pas dans le tableau de bord d'utilisation.
- Opérations d'écriture en lecture seule no-op. Les écritures qui vérifient uniquement l'existence ou la non-existence d'un document contribuent aux opérations de lecture facturées, mais qui s'affichent respectivement sous la forme "UPDATE_NOOP" et "DELETE_NOOP" dans le tableau de bord d'utilisation en écriture.
- Écritures no-ops. Les opérations qui n'entraînent pas de modification de la base de données, telles qu'une mise à jour qui ne modifie pas les valeurs des champs ou une écriture dans un document supprimé, peuvent apparaître dans le tableau de bord d'utilisation sous la forme "UPDATE_NOOP" ou "DELETE_NOOP". Même si elles apparaissent comme "NOOP", elles contribuent toujours aux opérations facturées.
Écritures regroupées. Si plusieurs écritures successives sont effectuées sur le même document, le tableau de bord d'utilisation peut les regrouper et ne comptabiliser qu'une seule écriture. Avec les données d'utilisation pour la facturation, chaque écriture est toujours comptabilisée individuellement.
Le tableau de bord d'utilisation regroupe également les écritures pour les transformations de champ telles que les horodatages de serveur, les incréments numériques et les opérations d'union de tableau. Pour les transformations de champ, le tableau de bord d'utilisation peut comptabiliser plusieurs opérations comme une seule et même opération.
- Requêtes ne renvoyant aucun résultat. Les requêtes sans résultat entraînent la facturation d'une opération de lecture. Bien qu'une telle utilisation soit facturée, elle n'apparaît pas dans le tableau de bord d'utilisation.
- Lire les opérations associées aux requêtes d'agrégation telles que COUNT. Cette utilisation est facturée, mais n'apparaît pas dans le tableau de bord d'utilisation.
Le tableau de bord d'utilisation des suppressions ne capture pas les opérations d'expiration automatique effectuées par les règles TTL (Time To Live). Veuillez consulter les métriques TTL de Cloud Monitoring.
Utilisation des règles de sécurité
En outre, la console Firebase fournit un tableau de bord d'évaluation des règles de sécurité, une vue d'ensemble utile des appels de règles. Vous pouvez compléter ce tableau de bord par une analyse détaillée dans Cloud Monitoring.
Métriques Cloud Monitoring
Cloud Monitoring collecte des métriques, des événements et des métadonnées provenant des produits Google Cloud. Le tableau de bord d'utilisation de la console Firestore fournit les mêmes métriques. Pour configurer des tableaux de bord personnalisés et des alertes d'utilisation, utilisez Cloud Monitoring.
Cloud Monitoring inclut les métriques Firestore suivantes :
| Nom de la métrique | Description |
|---|---|
| Lectures de documents |
Nombre de lectures de documents réussies. Vous pouvez décomposer cette métrique par type de lecture : RECHERCHE ou REQUÊTE. Cette métrique n'inclut pas les lectures provenant des opérations d'exportation gérées. |
| Écritures de documents |
Nombre d'écritures de documents réussies. Vous pouvez décomposer cette métrique par type d'écriture : CRÉATION ou MISE À JOUR. Cette métrique n'inclut pas les écritures provenant des opérations d'importation gérées. |
| Suppressions de documents | Nombre de suppressions de documents réussies. |
| Connexions actives |
Nombre de connexions actives à votre base de données. Chaque SDK mobile et Web actif conserve une connexion unique, qui peut être partagée entre plusieurs écouteurs d'instantanés. Les bibliothèques clientes du serveur créent une connexion par écouteur d'instantanés. |
| Écouteurs d'instantanés |
Nombre d'écouteurs d'instantanés sur l'ensemble des connexions actives. |
| Nombre de suppressions (Time To Live) |
Nombre total de documents supprimés par les règles de valeur TTL (Time To Live). |
| Délais entre l'expiration de la valeur TTL et la suppression |
Temps écoulé entre l'expiration d'un document selon une règle TTL (Time To Live) et sa suppression effective. |
- Utilisation des mises à jour en temps réel
Utilisez les métriques relatives aux connexions actives et aux écouteurs d'instantanés pour mesurer votre utilisation des mises à jour en temps réel.
Supposons qu'un utilisateur ouvre votre application sur son téléphone. L'application se connecte ensuite à Firestore et s'abonne à 10 requêtes. Ainsi, vos métriques augmentent d'une connexion active et de 10 écouteurs d'instantanés.
- Taux d'échantillonnage
Les métriques Firestore sont échantillonnées toutes les minutes, mais les mises à jour peuvent mettre jusqu'à quatre minutes à s'afficher dans vos tableaux de bord.
Métriques de latence
Les métriques de latence du backend sont disponibles via les métriques Google Cloud firestore courantes.
Par exemple, un graphique de latence P50 est disponible dans la vue de l'explorateur de métriques de la console Cloud.
Configurer un tableau de bord Cloud Monitoring
Pour configurer un tableau de bord avec des métriques Firestore, consultez Gérer un tableau de bord personnalisé et Ajouter des widgets de tableau de bord.
Étapes suivantes
- En savoir plus sur Cloud Monitoring.
- Découvrez les bonnes pratiques pour surveiller les performances de Firestore.