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
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 facturación alta 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 en 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 por 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, los grupos de colecciones o los 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: El modo Datastore reserva nombres con el prefijo de dos guiones bajos (__*__) 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.

  • Entidades de estadísticas del modo Datastore: Las entidades de estadísticas que se usan en el modo Datastore se incluyen en el uso total, pero no contribuyen a 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:

  • Espacio de nombres: Disponible cuando la API de Datastore está habilitada.
  • Tipo: Disponible de forma general en todas las configuraciones de la API.

Datos de estadísticas de uso

Las estadísticas de uso en la Google Cloud consola 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

Valor del espacio de nombres
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, un nombre de grupo de colecciones o un nombre de espacio de nombres.
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 bytes de lectura Cantidad total de bytes analizados.
Total de entidades analizadas Cantidad total de entidades analizadas.
Total de entradas de índice analizadas Cantidad total de entradas de índice analizadas.
Total de entidades escritas Cantidad total de entidades escritas.
Total de entradas de índice escritas Cantidad total de entradas de índice escritas.
Suma total del tamaño de la entidad escrita Tamaño total de escritura de la entidad 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 de Firestore en modo Datastore, abre el panel Estadísticas de uso de la base de datos en la Google Cloud consola.

  1. En la Google Cloud consola, 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 grupo de colecciones o un espacio de nombres. Puedes ver los datos de estadísticas de uso de los últimos 45 días.