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
Para empresas	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:

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

Roles obligatorios

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

Rol de IAM (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 las métricas agregadas (lecturas, escrituras y eliminaciones basadas en el TTL) de toda la base de datos.
GroupBy Usage: 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 Total Usage. 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, los grupos de colecciones o los espacios de nombres principales. El uso generado por las dimensiones menos activas contribuye a la cifra de Uso total, pero no se incluye individualmente en las métricas de uso de GroupBy.
Muestreo para operaciones amplias: En el caso de las solicitudes que afectan a una gran cantidad de colecciones (por ejemplo, las uniones en varias colecciones, ListCollectionIds, ListDocuments y las búsquedas sin tipo), es posible que las estadísticas de uso muestreen las colecciones y prioricen aquellas con el mayor uso. Como resultado, no todas las colecciones afectadas se incluyen en las métricas de uso de GroupBy.

Nombres reservados: Firestore reserva los nombres que tienen un prefijo de doble guion bajo (__*__) 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

En la sección GroupBy, se organizan las métricas de uso según las dimensiones determinadas por las APIs habilitadas:

Colección: Disponible cuando la API de Firestore está habilitada.
Collection Group: Disponible de forma general en todas las configuraciones de la API.

Datos de las estadísticas de uso

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

queryTopAggregatedInsightsData
queryTopTimeseriesInsightsData

Nombre del campo	Detalles
Nombre de la colección Nombre del grupo de colección	Es el valor correspondiente a la dimensión de uso para la que se agregan los datos de uso. Puede ser el nombre de una colección o de un grupo de colecciones.
Operaciones de lectura totales	Es la cantidad total de operaciones de lectura. Solo se aplica a la edición Standard.
Operaciones de escritura totales	Cantidad total de operaciones de escritura. También incluye operaciones de borrado. Solo se aplica a la edición Standard.
Operaciones de eliminación de TTL totales	Cantidad total de operaciones de eliminación de TTL. Solo se aplica a la edición Standard.
Operaciones de lectura totales	Es la cantidad total de unidades de lectura en tramos (tramos de 4 KiB). Solo se aplica a la edición Enterprise.
Operaciones de escritura totales	Cantidad total de unidades de escritura en tramos (tramos de 1 KiB). También incluye las unidades de eliminación. Solo se aplica a la edición Enterprise.
Operaciones de eliminación administrada o de eliminación de TTL totales	Es la cantidad total de unidades de eliminación administrada o eliminación por TTL. Solo se aplica a la edición Enterprise.
Total de unidades de Eventarc	Es la cantidad total de unidades de Eventarc. Solo se aplica a la edición Enterprise.
Total de bytes leídos	Cantidad total de bytes analizados.
Recuento total de documentos analizados	Es la cantidad total de documentos analizados.
Recuento total de entradas del índice analizadas	Es la cantidad total de entradas de índice analizadas.
Recuento total de documentos escritos	Es la cantidad total de documentos escritos.
Recuento total de entradas de índice escritas	Es la cantidad total de entradas de índice escritas.
Suma total del tamaño del documento escrito	Es el tamaño total de escritura del documento 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 la compilación de índices en la edición Enterprise.
No se admite la facturación del almacenamiento ni de la salida de red.

Precios

No hay costos adicionales por las estadísticas de uso.

Consulta las estadísticas de uso

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

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

Ir a Bases de datos
En la lista de bases de datos, selecciona una.
En el menú de navegación, haz clic en Estadísticas de uso.

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