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
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 IAM de Visualizador de Datastore

(roles/datastore.viewer) rol de IAM 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 de TTL) de toda la base de datos.
  • Agrupación por uso: 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 puede 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 mayor uso. Como resultado, no todas las colecciones afectadas se incluyen en las métricas de uso de GroupBy.
  • Nombres reservados: 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 Firestore está habilitada.
    • Grupo de colecciones: Está disponible de forma general en todas las configuraciones de la API.

    Datos de estadísticas de uso

    En las estadísticas de uso de la consola de Google Cloud , se muestran los siguientes campos:

    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. Podría 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. Solo se aplica a la edición Standard.
    Total de operaciones de escritura Es la cantidad total de operaciones de escritura. También 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 operaciones de lectura Es la cantidad total de unidades de lectura divididas en tramos (tramos de 4 KiB). Solo se aplica a la edición Enterprise.
    Total de operaciones de escritura Es la cantidad total de unidades de escritura divididas 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 de eliminación administrada 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 bytes leídos Es la cantidad total de bytes analizados.
    Recuento total de documentos analizados Es la cantidad total de documentos analizados.
    Recuento total de entradas de índice analizadas 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 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

    • 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 de 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 salida de red ni de almacenamiento.

    Precios

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

    Ver 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 .

    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 deGoogle 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.