Surveiller l'utilisation
Cette page explique comment surveiller votre utilisation de Firestore repérer 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 sur l'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 consulter votre utilisation de la 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 regroupe les métriques d'utilisation de toutes vos Firestore dans des bases de données en mode natif. Ce tableau de bord n'inclut pas l'utilisation des bases de données Firestore en mode Datastore.
console Google Cloud
Dans la console Google Cloud, accédez à la page Utilisation du projet.
Accéder à la page "Utilisation du projet Google Cloud"
Le tableau de bord d'utilisation du projet présente les opérations liées aux 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.
- Écritures no-ops de vérification uniquement. Les écritures qui ne vérifient que l'existence ou l'absence d'un document contribuent aux opérations de lecture facturées, mais elles s'affichent respectivement sous la forme "UPDATE_NOOP" et "DELETE_NOOP" dans le tableau de bord d'utilisation des écritures.
- Écritures no-ops. Les opérations n'entraînant pas de modification de la base de données comme une mise à jour qui ne modifie pas les valeurs des champs ou une écriture dans un document peut s'afficher dans le tableau de bord d'utilisation sous la forme "UPDATE_NOOP" ou "DELETE_NOOP". Même s'ils apparaissent comme NOOP, ils 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.
- Opérations de lecture à partir des entrées d'index lues. Bien qu'une telle utilisation soit facturée, elle n'apparaît pas dans le tableau de bord d'utilisation. Par exemple, les requêtes d'agrégation facturent les entrées d'index lues, mais cette utilisation n'apparaît pas dans le tableau de bord d'utilisation.
Le tableau de bord d'utilisation des suppressions n'inclut pas les opérations d'expiration automatique effectuées par les règles de valeur 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 TTL |
Nombre total de documents supprimés par Règles TTL (Time To Live) |
| Délais d'expiration du délai de vie avant suppression |
Temps écoulé entre l'expiration d'un document en vertu d'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.
Statistiques relatives à la latence
Les métriques de latence du backend sont disponibles via les métriques firestore Google Cloud courantes.
Par exemple, un graphique de la latence p50 est disponible dans la vue de l'explorateur de métriques de Cloud Console.
Configurer un tableau de bord Cloud Monitoring
Pour configurer un tableau de bord avec des métriques Firestore, consultez les pages Gérer un tableau de bord personnalisé et Ajouter des widgets de tableau de bord.
Étape suivante
- En savoir plus sur Cloud Monitoring.
- Découvrez les bonnes pratiques pour surveiller les performances de Firestore.