Monitorear la actividad de Cloud Firestore

Esta página describe cómo puede monitorear el uso de Cloud Firestore y detectar posibles problemas en su aplicación.

Panel de uso

Utilice los paneles de uso en Google Cloud Platform Console y Firebase console para ver las lecturas, escrituras y eliminaciones de documentos a lo largo del tiempo.

Control de acceso

Los paneles de uso requieren el permiso monitoring.timeSeries.list Cloud IAM. Las funciones de Propietario del proyecto, Editor y Visualizador otorgan este permiso. También puedes otorgar este permiso a través de una función de Cloud Monitoring o una función personalizada .

Panel de uso de la base de datos

Para ver las métricas de uso de una base de datos de Cloud Firestore, abra la página Uso de la base de datos en GCP Console.

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

    Ir a Bases de Datos

  2. Seleccione la base de datos requerida de la lista de bases de datos.

  3. En el menú de navegación, haga clic en Uso .

  4. Haga clic en el enlace del mensaje que aparece en la página para ver el uso de su base de datos.

    El panel de uso de la base de datos de Cloud Firestore en GCP Console.

Panel de uso agregado

Si tu proyecto tiene varias bases de datos de Cloud Firestore, puedes ver métricas de uso agregadas en GCP Console o Firebase console.

Consola GCP

En Google Cloud Platform Console, vaya a la página de uso del proyecto .

Ir al uso del proyecto del proyecto GCP

El panel de uso del proyecto muestra las operaciones de documentos a lo largo del tiempo de la siguiente manera:

El panel de uso del proyecto Cloud Firestore en GCP Console.

Consola de base de fuego

Vaya a la página de uso de Cloud Firestore (consola Firebase)

El panel de uso de Cloud Firestore en Firebase console.

Panel de uso e informes de facturación

Los paneles de uso de Cloud Firestore en las consolas Firebase y Cloud proporcionan una estimación del uso. Pueden ayudarle a identificar picos de uso. Sin embargo, el panel no ofrece una vista exacta de las operaciones facturadas. Es probable que el uso facturado sea mayor. En todos los casos de discrepancia, el informe de facturación tiene prioridad sobre el panel de uso.

Las operaciones que causan discrepancias entre el panel de uso y el uso facturado incluyen:

  • Operaciones de importación y exportación. Las lecturas y escrituras realizadas por estas operaciones no aparecen en el panel de uso.
  • Escrituras no operativas de solo verificación. Las escrituras que solo verifican la existencia o no existencia de un documento contribuyen a las operaciones de lectura facturadas, pero se muestran como `UPDATE_NOOP` y `DELETE_NOOP` respectivamente en el panel de uso de escritura.
  • Escribe sin operación. Las operaciones que no resultan en un cambio en la base de datos, como una actualización que no cambia los valores de los campos o una escritura en un documento eliminado, pueden aparecer en el panel de uso como "UPDATE_NOOP" o "DELETE_NOOP". Aunque se muestren como "NOOP", siguen contribuyendo a las operaciones facturadas.
  • Escrituras colapsadas. En casos con múltiples escrituras en el mismo documento en rápida sucesión, el panel de uso puede colapsar varias escrituras juntas y contarlas como una. Al facturar el uso, cada escritura todavía se cuenta por separado.

    El panel de uso también colapsa las escrituras para transformaciones de campos, como marcas de tiempo del servidor, incrementos numéricos y operaciones de unión de matrices. Para las transformaciones de campos, el panel de uso puede contar varias operaciones como una sola operación.

  • Consultas que devuelven cero resultados. Las consultas sin resultados generan un costo de una operación de lectura. Este uso se factura pero no aparece en el panel de uso.
  • Leer operaciones asociadas con consultas de agregación como COUNT. Este uso se factura pero no aparece en el panel de uso.

El panel de uso para eliminaciones no captura las operaciones de vencimiento automático realizadas por las políticas de tiempo de vida (TTL). Consulte las métricas TTL de Cloud Monitoring .

Uso de reglas de seguridad

Además, Firebase console proporciona un panel de evaluación de reglas de seguridad, una vista útil y resumida de las invocaciones de reglas. Puede complementar este panel con un análisis detallado en Cloud Monitoring .

Ir a las reglas

Panel de monitoreo de reglas de Cloud Firestore en Firebase console.

Métricas de monitoreo de la nube

Cloud Monitoring recopila métricas, eventos y metadatos de los productos de Google Cloud. El panel de uso en la consola de Cloud Firestore informa los mismos datos de métricas. Para configurar paneles personalizados y alertas de uso, utilice Cloud Monitoring.

Cloud Monitoring incluye las siguientes métricas de Cloud Firestore:

Nombre de la métrica Descripción
Lecturas de documentos

El número de lecturas de documentos exitosas. Puede desglosar esta métrica por tipo de lectura: BUSCAR o CONSULTA.

Esta métrica no incluye lecturas de operaciones de exportación administradas.

Escritura de documentos

El número de escrituras de documentos exitosas. Puede desglosar la métrica por tipo de escritura: CREAR o ACTUALIZAR.

Esta métrica no incluye escrituras de operaciones de importación administradas.

Eliminaciones de documentos El número de eliminaciones de documentos exitosas.
Conexiones activas

El número de conexiones activas a su base de datos.

Cada SDK web y móvil activo mantiene una única conexión, que se puede compartir entre varios oyentes de instantáneas. Las bibliotecas cliente del servidor crean una conexión por escucha de instantáneas.

Oyentes de instantáneas

El número de oyentes de instantáneas en todas las conexiones activas.

Recuento de eliminaciones del tiempo de vida

Recuento total de documentos eliminados por políticas de tiempo de vida (TTL) .

Vencimiento del tiempo de vida hasta retrasos en la eliminación

Tiempo transcurrido entre el momento en que un documento expiró según una política de tiempo de vida (TTL) y el momento en que se eliminó realmente.

Uso de actualizaciones en tiempo real

Utilice las métricas de conexiones activas y escuchas de instantáneas para medir su uso de actualizaciones en tiempo real .

Digamos que un usuario abre su aplicación en su teléfono. Luego, la aplicación se conecta a Cloud Firestore y se suscribe a 10 consultas. Esto aumenta sus métricas en 1 conexión activa y 10 oyentes de instantáneas.

Tasa de muestreo

Las métricas de Cloud Firestore se muestrean cada minuto, pero las actualizaciones pueden tardar hasta 4 minutos en aparecer en sus paneles.

Métricas de latencia

Las métricas de latencia de backend están disponibles a través de métricas comunes de Google Cloud Firestore .

Por ejemplo, se puede encontrar un gráfico de latencia p50 en la vista del explorador de métricas de Cloud Console.

Configurar un panel de monitoreo de la nube

Para configurar un panel con métricas de Cloud Firestore, consulte Administrar panel personalizado y Agregar widgets de panel .

Que sigue