Surveiller l'activité Cloud Firestore

Cette page explique comment surveiller votre utilisation de Cloud Firestore et 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 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 d'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 dans le message qui s'affiche sur la page pour consulter votre utilisation de la 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 d'utilisation agrégé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.

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 sans vérification (no-op) 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 de la lecture d'entrées d'index Cette utilisation est facturée, mais 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 pour les suppressions ne capture 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 avec une analyse détaillée Cloud Monitoring

Accéder à "Règles"

Règles Cloud Firestore de surveillance dans la console Firebase."/>

Cloud Monitoring métriques

Cloud Monitoring collecte métriques, événements et métadonnées des produits Google Cloud. L'utilisation le tableau de bord de la console Cloud Firestore signale les mêmes données de métriques. À 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 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 Règles de valeur TTL (Time To Live)
Délai d'expiration ou de suppression de la valeur TTL (Time To Live)	Délai écoulé entre l'expiration d'un document Règle de valeur TTL (Time To Live) et sa date de suppression.

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 des mises à jour peuvent l'affichage dans vos tableaux de bord peut prendre jusqu'à 4 minutes.

Statistiques relatives à la latence

Les métriques de latence du backend sont disponibles via des métriques firestore Google Cloud 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 Cloud Firestore, consultez 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.