Analiza las estadísticas de uso

En esta página, se describe cómo usar las estadísticas de uso para analizar tu uso facturable de bases de datos específicas. Puedes desglosar estos datos por dimensiones como colecciones, grupos de colecciones o espacios de nombres (específicos del modo Datastore) durante un período personalizado. Las métricas de estadísticas de uso que se muestran varían según la edición o el modo:

Edición	Métricas
Estándar	Lecturas Escrituras (incluye eliminaciones) Eliminaciones de TTL
Enterprise	Lecturas Escrituras Eliminaciones de TTL Evento

Descripción general de las estadísticas de uso

Usa el panel de estadísticas de uso para supervisar el uso de bases de datos específicas. Este panel te ayuda con lo siguiente:

• Supervisar el uso detallado: Haz un seguimiento de tus operaciones facturables desglosadas por dimensiones como collection, collectionGroup, o namespace.
• Optimizar los costos: Identifica el uso con facturas altas para determinar dónde puedes optimizar las estructuras de datos o las consultas y reducir tu factura general.
• Realizar un seguimiento de las tendencias históricas: Supervisa cómo cambian tus estadísticas de uso facturable durante períodos específicos.

Roles obligatorios

Para obtener el permiso que necesitas para ver el panel de estadísticas de uso, pide a tu administrador que te otorgue el rol de IAM de Visualizador de Datastore

(roles/datastore.viewer) en tu proyecto.

Este rol predefinido contiene el permiso datastore.insights.get, que se requiere para ver el panel de estadísticas de uso.

También puedes obtener este permiso con roles personalizados o con otros roles predefinidos.

Panel de estadísticas de uso

El panel de estadísticas de uso se organiza en dos secciones principales:

• Uso total: Muestra métricas agregadas (lecturas, escrituras, eliminaciones de TTL) para toda la base de datos.
• Uso de GroupBy: Muestra las métricas desglosadas por las 100 dimensiones principales y se agrupa por colección, grupo de colecciones o espacios de nombres.

Métricas de uso total y GroupBy

Es importante tener en cuenta que la suma de las métricas en la sección GroupBy podría no coincidir con la métrica que se muestra en la sección Uso total. Esta variación es esperable debido a los siguientes factores:

• Límites de GroupBy (100 principales): La sección GroupBy se limita a detallar el uso solo de las 100 colecciones, grupos de colecciones o espacios de nombres principales. El uso generado por dimensiones menos activas contribuye a la cifra de Uso total, pero no se incluye de forma individual en las métricas de uso de GroupBy.
• Muestreo para operaciones amplias: Para las solicitudes que afectan a una gran cantidad de colecciones (por ejemplo, uniones en varias colecciones, ListCollectionIds, ListDocuments, consultas sin tipo), las estadísticas de uso pueden muestrear colecciones y priorizar aquellas con el uso más alto. Como resultado, no todas las colecciones afectadas se incluyen en las métricas de uso de GroupBy.

• Nombres reservados: Cloud Firestore reserva nombres con el prefijo de guion bajo doble (__*__) para los metadatos internos. El uso relacionado con estos nombres reservados contribuye al uso total, pero no se incluye en las métricas de uso de GroupBy.

  Dimensiones de GroupBy

  La sección GroupBy organiza las métricas de uso en función de las dimensiones determinadas por las APIs habilitadas:

  • Colección: Disponible cuando la API está habilitada.Cloud Firestore
  • Grupo de colecciones: Disponible de forma general en todas las configuraciones de la API.

  Datos de estadísticas de uso

  Las estadísticas de uso en la consola de Google Cloud muestran datos provenientes de los siguientes métodos de la API:

  • queryTopAggregatedInsightsData
  • queryTopTimeseriesInsightsData

  Nombre del campo	Detalles
  Nombre de la colección Nombre del grupo de colecciones	El valor correspondiente a la dimensión de uso para la que se agregan los datos de uso. Puede ser un nombre de colección o un nombre de grupo de colecciones.
  Total de operaciones de lectura	Cantidad total de operaciones de lectura. Solo se aplica a la edición Estándar.
  Total de operaciones de escritura	Cantidad total de operaciones de escritura. También incluye operaciones de eliminación. Solo se aplica a la edición Estándar.
  Total de operaciones de eliminación de TTL	Cantidad total de operaciones de eliminación de TTL. Solo se aplica a la edición Estándar.
  Total de operaciones de lectura	Cantidad total de unidades de lectura en tramos (tramos de 4 KiB). Solo se aplica a la edición Enterprise.
  Total de operaciones de escritura	Cantidad total de unidades de escritura en tramos (tramos de 1 KiB). También incluye unidades de eliminación. Solo se aplica a la edición Enterprise.
  Total de operaciones de eliminación de TTL o eliminación administrada	Cantidad total de unidades de eliminación de TTL o eliminación administrada. Solo se aplica a la edición Enterprise.
  Total de unidades de Eventarc	Cantidad total de unidades de Eventarc. Solo se aplica a la edición Enterprise.
  Total de bytes de lectura	Cantidad total de bytes analizados.
  Total de documentos analizados	Cantidad total de documentos analizados.
  Total de entradas de índice analizadas	Cantidad total de entradas de índice analizadas.
  Total de documentos escritos	Cantidad total de documentos escritos.
  Total de entradas de índice escritas	Cantidad total de entradas de índice escritas.
  Suma total del tamaño de los documentos escritos	Tamaño total de escritura de documentos en bytes.

  Limitaciones

  • Las consultas de transmisión que contribuyen a las lecturas y escrituras facturables no se registran como parte de la respuesta de la API.
  • No se admiten las estadísticas de uso para las operaciones de administrador (que contribuyen a las lecturas y escrituras facturables), como la importación o exportación, la eliminación masiva, el restablecimiento, la clonación y las compilaciones de índices en la edición Enterprise.
  • No se admite la facturación de almacenamiento ni de salida de red.

  Precios

  No hay costo adicional por las estadísticas de uso.

  Cómo ver las estadísticas de uso

  Para ver las estadísticas de uso de una base de datos Cloud Firestore, abre el panel Estadísticas de uso de la base de datos en la consola de Google Cloud.

  1. En la consola de Google Cloud, ve a la página Bases de datos.

     Ir a Bases de datos

  2. En la lista de bases de datos, selecciona una.

  3. En el menú de navegación, haz clic en Estadísticas de uso.

     

     Usa el menú desplegable Agrupar por para ver las estadísticas de uso de una colección, un grupo de colecciones o un espacio de nombres. Puedes ver los datos de estadísticas de uso de los últimos 45 días.