Surveiller l'activité Cloud Firestore

Cette page explique comment surveiller votre utilisation de Cloud Firestore et identifier 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 Cloud 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 Cloud Firestore, ouvrez la page Utilisation de la base de données dans la console Google Cloud.

1. Dans la console Google Cloud, accédez à la page Base de données.

   Accéder à la page "Bases de données"

2. Sélectionnez la base de données requise dans la liste des bases de données.

3. Dans le menu de navigation, cliquez sur Utilisation.

4. Cliquez sur le lien figurant dans le message qui s'affiche sur la page pour afficher l'utilisation de votre base de données.

   Tableau de bord d'utilisation de la base de données Cloud Firestore dans la console Google Cloud."/>

Tableau de bord de l'utilisation cumulée

Si votre projet comporte plusieurs bases de données Cloud Firestore, vous pouvez afficher les métriques d'utilisation agrégées dans la console Google Cloud ou la console Firebase.

Console Google Cloud

Dans la console Google Cloud, accédez à la page Utilisation du projet.

Accéder à l'utilisation des projets Google Cloud

Le tableau de bord d'utilisation du projet affiche les opérations sur les documents au fil du temps comme suit:

Tableau de bord d'utilisation du projet Cloud Firestore dans la console Google Cloud."/>

Console Firebase

Accéder à la page d'utilisation de Cloud Firestore (console Firebase)

Tableau de bord d'utilisation de Cloud Firestore dans la console Firebase."/>

Tableau de bord d'utilisation et rapports de facturation

Les tableaux de bord d'utilisation de Cloud 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 qui ne modifient pas 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 s'afficher dans le tableau de bord d'utilisation sous la forme "UPDATE_NOOP" ou "DELETE_NOOP". Même si elles s'affichent sous la forme "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.
• 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.

Accéder à "Règles"

Tableau de bord de surveillance des règles Cloud Firestore dans la console Firebase."/>

Cloud Monitoring métriques

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 Cloud 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 Cloud 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 ou de suppression groupée 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 liées à la valeur TTL	Nombre total de documents supprimés par les règles de valeur TTL (Time To Live).
Délais d'expiration du délai de vie avant suppression	Intervalle de 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 à Cloud 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 Cloud 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 Google Cloud firestore 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 afficher un tableau de bord prédéfini ou en configurer un, consultez Utiliser le tableau de bord de surveillance.

Étape suivante

• En savoir plus sur Cloud Monitoring
• Découvrez les bonnes pratiques pour surveiller les performances de Firestore.