Analyser les insights sur l'utilisation

Analyser les insights sur l'utilisation

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 ventiler 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 sur les insights d'utilisation affichées varient en fonction de l'édition ou du mode :

Édition	Métriques
Standard	Lectures Écritures (y compris les suppressions) Suppressions TTL
Entreprise	Lectures Écritures Suppressions TTL Événement

Présentation des insights sur l'utilisation

Utilisez le tableau de bord "Insights sur l'utilisation" pour surveiller l'utilisation de bases de données spécifiques. Ce tableau de bord vous aide à :

• Surveillez l'utilisation détaillée : suivez vos opérations facturables ventilées par dimensions telles que collection, collectionGroup ou namespace.
• Optimiser les coûts : identifiez les utilisations facturées à un prix élevé pour déterminer où vous pouvez optimiser les structures de données ou les requêtes, et réduire votre facture globale.
• Suivez 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 nécessaire pour afficher le tableau de bord "Insights sur l'utilisation", demandez à votre administrateur de vous accorder le rôle Lecteur Datastore.

Rôle IAM (roles/datastore.viewer) dans votre projet.

Ce rôle prédéfini contient l'autorisation datastore.insights.get, qui est nécessaire pour afficher le tableau de bord "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 "Insights sur l'utilisation" est divisé 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.
• Regrouper par utilisation : affiche les métriques ventilées par les 100 principales dimensions et regroupées par collection, groupe de collections ou espaces de noms.

Métriques "Utilisation totale" et "GroupBy"

Il est important de noter que la somme des métriques de la section "GroupBy" ne correspond pas forcément à la métrique affichée dans la section "Utilisation totale". Cette variance est normale en raison des facteurs suivants :

• Limites de GroupBy (100 premiers) : la section "GroupBy" est limitée à l'énumération de l'utilisation pour les 100 premières collections, groupes de collections ou espaces de noms uniquement. L'utilisation générée par les dimensions moins actives contribue au chiffre "Utilisation totale", mais n'est pas listée individuellement dans les métriques d'utilisation GroupBy.
• É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 GroupBy.

• Noms réservés : Firestore réserve les noms commençant par un double underscore (__*__) pour les métadonnées internes. L'utilisation associée à ces noms réservés contribue à l'utilisation totale, mais n'est pas incluse dans les métriques d'utilisation GroupBy.

  Dimensions GroupBy

  La section "GroupBy" organise les métriques d'utilisation en fonction des dimensions déterminées par les API activées :

  • Collection : disponible lorsque l'API 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 de la console Google Cloud affichent des données provenant des méthodes d'API suivantes :

  • queryTopAggregatedInsightsData
  • queryTopTimeseriesInsightsData

  Nom du champ	Détails
  Nom de la collection Nom du groupe de collections	Valeur correspondant à la dimension d'utilisation pour laquelle les données d'utilisation sont agrégées. Il peut s'agir du nom d'une collection ou d'un 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 fractionnées (tranches de 4 kio). Applicable uniquement à l'édition Enterprise.
  Nombre total d'opérations d'écriture	Nombre total d'unités d'écriture fractionnées (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 suppressions gérées. 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 flux qui contribuent aux lectures et écritures facturables ne sont pas suivies dans la réponse de l'API.
  • Les insights sur l'utilisation pour les opérations d'administration (qui contribuent aux lectures et écritures facturables), comme l'importation/exportation, la suppression groupée, la restauration, le clonage et la création d'index dans l'édition Enterprise, ne sont pas disponibles.
  • La facturation de la sortie réseau et du stockage n'est pas disponible.

  Tarifs

  Les insights sur l'utilisation ne sont pas facturés.

  Afficher les insights sur l'utilisation

  Pour afficher les insights sur l'utilisation d'une base de données Firestore, ouvrez le volet Insights sur l'utilisation de la base de données dans la console Google Cloud .

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

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

  2. Dans la liste des bases de données, sélectionnez-en une.

  3. Dans le menu de navigation, cliquez sur Insights sur l'utilisation.

     

     Utilisez le menu déroulant Regrouper par pour afficher des insights sur l'utilisation d'une collection, d'un collectionGroup ou d'un espace de noms. Vous pouvez consulter les données sur les insights d'utilisation pour les 45 derniers jours.