Analiza las estadísticas de uso

En esta página, se describe cómo usar las estadísticas de uso para analizar el 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
  • Lecturas de transmisión (Listen solicitudes)
  • Escrituras de transmisión (StreamWrite solicitudes, incluye eliminaciones)
Enterprise
  • Unidades de lectura
  • Unidades de escritura (incluye eliminaciones)
  • Unidades de eliminación de TTL o de eliminación administrada
  • Unidades de Eventarc
  • Unidades de lectura de transmisión (sondeo de Listen)
  • Unidades de lectura en tiempo real (Listen actualizaciones de transmisión)
  • Unidades de escritura de transmisión (StreamWrite solicitudes, incluye eliminaciones)

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 IAM 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, lecturas de transmisión, escrituras de transmisión y eliminaciones de TTL) de toda la base de datos.
  • Agrupación por uso: Muestra las métricas desglosadas por las 100 dimensiones principales y agrupadas por colección, grupo de colecciones o espacio 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 (los 100 principales): La sección GroupBy se restringe al desglose del uso solo para las 100 colecciones, grupos de colecciones o espacios de nombres principales. El uso que generan las 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: En el caso de las solicitudes que afectan a una gran cantidad de colecciones (por ejemplo, uniones en varias colecciones, ListCollectionIds, ListDocuments, consultas sin categoría), 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 guiones bajos dobles (__*__) 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 que determinan las APIs habilitadas:

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

    Datos de las estadísticas de uso

    Las estadísticas de uso de 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
    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
    Total de operaciones de lectura Es la cantidad total de operaciones de lectura que no son de transmisión. Solo se aplica a la edición Standard.
    Total de operaciones de escritura Es la cantidad total de operaciones de escritura que no son de transmisión. Incluye operaciones de borrado. Solo se aplica a la edición Standard.
    Total de operaciones de lectura de transmisión Es la cantidad total de operaciones de lectura que se usaron para transmitir solicitudes de Listen (incluidos el sondeo de consultas inicial, las notificaciones de cambios de documentos en tiempo real, los resultados omitidos, las lecturas de índices y los cargos mínimos por lectura). Solo se aplica a la edición Standard.
    Total de operaciones de escritura de transmisión Es la cantidad total de operaciones de escritura que se usaron para las solicitudes de StreamWrite. Incluye operaciones de borrado. Solo se aplica a la edición Standard.
    Total de operaciones de eliminación de TTL Cantidad total de operaciones de eliminación de TTL. Solo se aplica a la edición Standard.
    Total de unidades de lectura Es la cantidad total de unidades de lectura divididas en tramos (tramos de 4 KiB) para lecturas que no son de transmisión. Solo se aplica a la edición Enterprise.
    Total de unidades de escritura Es la cantidad total de unidades de escritura divididas en tramos (tramos de 1 KiB) para las escrituras que no son de transmisión. Incluye unidades de eliminación. Solo se aplica a la edición Enterprise.
    Total de operaciones de eliminación de TTL o de eliminación administrada Es la cantidad total de unidades de eliminación de TTL o de 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 unidades de lectura de transmisión Es la cantidad total de unidades de lectura divididas en tramos (tramos de 4 KiB) que se usan para las operaciones de sondeo en las solicitudes de Listen de transmisión. Solo se aplica a la edición Enterprise.
    Total de unidades de lectura en tiempo real Es la cantidad total de unidades de lectura en tiempo real (tramos de 1 KiB) que se usan para las actualizaciones de transmisión en las solicitudes de Listen. Solo se aplica a la edición Enterprise.
    Total de unidades de escritura de transmisión Es la cantidad total de unidades de escritura divididas en tramos (tramos de 1 KiB) que se usaron para las solicitudes de StreamWrite. Incluye unidades de eliminación. 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 de í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 de los documentos escritos Es el tamaño total de escritura del documento en bytes.

    Limitaciones

    • No se admiten las estadísticas de uso de las operaciones de administrador (que contribuyen a las lecturas y escrituras facturables), como la importación y 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 salida de red ni de almacenamiento.

    Precios

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

    Visualiza las estadísticas de uso

    Para ver las estadísticas de uso de una base de datos de 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.

      Las estadísticas de uso de una base de datos en modo nativo en la
consola de Google Cloud

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