Cette page explique comment utiliser les insights sur l'utilisation pour analyser votre utilisation facturable pour des bases de données spécifiques. Vous pouvez segmenter ces données par dimensions telles que les collections, les groupes de collections ou les espaces de noms (spécifiques au mode Datastore) sur une période personnalisée. Les métriques des insights sur l'utilisation affichées varient en fonction de l'édition ou du mode :
| Édition | Métriques |
| Standard |
|
| Entreprise |
|
Présentation des insights sur l'utilisation
Utilisez le tableau de bord des insights sur l'utilisation pour surveiller l'utilisation de bases de données spécifiques. Ce tableau de bord vous aide à :
- Surveiller l'utilisation détaillée : suivez vos opérations facturables segmentées par
dimensions telles que
collection,collectionGroup, ounamespace. - Optimiser les coûts : identifiez l'utilisation fortement facturée pour déterminer où vous pouvez optimiser les structures de données ou les requêtes et réduire votre facture globale.
- Suivre les tendances historiques : surveillez l'évolution de vos statistiques d'utilisation facturable sur des périodes spécifiques.
Rôles requis
Pour obtenir l'autorisation dont vous avez besoin pour afficher le tableau de bord des insights sur l'utilisation, 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 des insights sur l'utilisation.
Vous pouvez également obtenir cette autorisation avec des rôles personnalisés ou d'autres rôles prédéfinis.
Tableau de bord des insights sur l'utilisation
Le tableau de bord des insights sur l'utilisation est organisé en deux sections principales :
- Utilisation totale : affiche les métriques agrégées (lectures, écritures, suppressions TTL) pour l'ensemble de la base de données.
- Utilisation par regroupement : affiche les métriques segmentées par les 100 principales dimensions et regroupées par collection, groupe de collections ou espaces de noms.
Métriques d'utilisation totale et par regroupement
Il est important de noter que la somme des métriques de la section "Par regroupement" peut ne pas correspondre à la métrique affichée dans la section "Utilisation totale". Cette variance est attendue en raison des facteurs suivants :
- Limites de regroupement (100 premiers) : la section "Par regroupement" est limitée à l'énumération de l'utilisation pour les 100 premières collections, groupes de collections ou espaces de noms. L'utilisation générée par des dimensions moins actives contribue au chiffre de l'utilisation totale, mais n'est pas listée individuellement dans les métriques d'utilisation par regroupement.
- Échantillonnage pour les opérations étendues : pour les requêtes ayant un impact sur un grand nombre de collections (par exemple, les jointures sur plusieurs collections,
ListCollectionIds,ListDocuments, les requêtes sans type), les insights sur l'utilisation peuvent échantillonner les collections, en privilégiant celles dont l'utilisation est la plus élevée. Par conséquent, toutes les collections concernées ne sont pas incluses dans les métriques d'utilisation par regroupement. Noms réservés : Cloud Firestore réserve les noms préfixés par un double trait de soulignement (__*__) pour les métadonnées internes. L'utilisation liée à ces noms réservés contribue à l'utilisation totale, mais n'est pas incluse dans les métriques d'utilisation par regroupement.
Dimensions de regroupement
La section "Par regroupement" organise les métriques d'utilisation en fonction des dimensions déterminées par les API activées :
- Collection : disponible lorsque l'API Cloud Firestore est activée.
- Groupe de collections : généralement disponible dans toutes les configurations d'API.
Données des insights sur l'utilisation
Les insights sur l'utilisation dans la console Google Cloud affichent les données provenant des méthodes d'API suivantes :
queryTopAggregatedInsightsDataqueryTopTimeseriesInsightsData
Nom du champ Détails Nom de la collection
Nom du groupe de collectionsValeur correspondant à la dimension d'utilisation pour laquelle les données d'utilisation sont agrégées. Il peut s'agir d'un nom de collection ou d'un nom de groupe de collections. Nombre total d'opérations de lecture Nombre total d'opérations de lecture. Applicable uniquement à l'édition Standard. Nombre total d'opérations d'écriture Nombre total d'opérations d'écriture. Inclut également les opérations de suppression. Applicable uniquement à l'édition Standard. Nombre total d'opérations de suppression TTL Nombre total d'opérations de suppression TTL. Applicable uniquement à l'édition Standard. Nombre total d'opérations de lecture Nombre total d'unités de lecture par tranches (tranches de 4 Kio). Applicable uniquement à l'édition Enterprise. Nombre total d'opérations d'écriture Nombre total d'unités d'écriture par tranches (tranches de 1 Kio). Inclut également les unités de suppression. Applicable uniquement à l'édition Enterprise. Nombre total d'opérations de suppression TTL ou de suppression gérée Nombre total d'unités de suppression TTL ou de suppression gérée. Applicable uniquement à l'édition Enterprise. Nombre total d'unités Eventarc Nombre total d'unités Eventarc. Applicable uniquement à l'édition Enterprise. Nombre total d'octets lus Nombre total d'octets analysés. Nombre total de documents analysés Nombre total de documents analysés. Nombre total d'entrées d'index analysées Nombre total d'entrées d'index analysées. Nombre total de documents écrits Nombre total de documents écrits. Nombre total d'entrées d'index écrites Nombre total d'entrées d'index écrites. Somme totale de la taille des documents écrits Taille totale des écritures de documents en octets. Limites
- Les requêtes de streaming qui contribuent aux lectures et écritures facturables ne sont pas suivies dans le cadre de la réponse de l'API.
- Les insights sur l'utilisation pour les opérations d'administration (qui contribuent aux lectures et écritures facturables), telles que l'importation/l'exportation, la suppression groupée, la restauration, le clonage et la création d'index dans l'édition Enterprise, ne sont pas compatibles.
- La facturation de la sortie réseau et du stockage n'est pas compatible.
Tarifs
Les insights sur l'utilisation n'entraînent aucun coût supplémentaire.
Afficher les insights sur l'utilisation
Pour afficher les insights sur l'utilisation d'une Cloud Firestore base de données, ouvrez le volet Insights sur l'utilisation 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 l'utilisation.
Utilisez le menu déroulant Regrouper par pour afficher les insights sur l'utilisation d'une collection, d'un groupe de collections ou d'un espace de noms. Vous pouvez afficher les données des insights sur l'utilisation jusqu'aux 45 derniers jours.