Supervisa la actividad de Cloud Firestore

En esta página, se describe cómo puedes supervisar tu uso de Cloud Firestore y detectar posibles problemas en tu app.

Panel de uso

Usa los paneles de uso de Google Cloud Platform Console y Firebase console para ver las operaciones de lectura, escritura y eliminación de documentos a lo largo del tiempo.

Control de acceso

Los paneles de uso requieren el permiso monitoring.timeSeries.list de Cloud IAM. Las funciones de propietario, editor y lector del proyecto 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, abre la página Uso de la base de datos en GCP Console.

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

    Ir a Bases de datos

  2. Selecciona la base de datos requerida de la lista.

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

  4. Haz clic en el vínculo del mensaje que aparece en la página para ver el uso de tu 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 las métricas de uso agregado en GCP Console o Firebase console.

Consola de GCP

En Google Cloud Platform Console, ve a la página Uso del proyecto.

Ir a Uso del proyecto de GCP

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

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

Firebase console

Ir a la página de uso de Cloud Firestore (Firebase console)

El panel de uso de Cloud Firestore de Firebase console

Informes de facturación y panel de uso

Los paneles de uso de Cloud Firestore en Firebase y Cloud Console proporcionan estimaciones del uso. Con ellos, puedes identificar las alzas repentinas. Sin embargo, no proporcionan una visión exacta de las operaciones facturadas. Es probable que el uso facturado sea más alto. En todos los casos en que haya discrepancias, el informe de facturación tiene prioridad sobre el panel de uso.

Estas son algunas de las operaciones que causan discrepancias entre el panel de uso y el uso facturado:

  • Operaciones de importación y exportación. Las operaciones de lectura y escritura que realizan estas operaciones no aparecen en el panel de uso.
  • Escrituras no-op solo con verificación. Las operaciones de escritura que solo verifican la existencia o inexistencia 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.
  • Escrituras no-op. Las operaciones que no generan cambios en la base de datos, como una actualización que no modifica los valores de los campos o una escritura en un documento borrado, pueden aparecer en el panel de uso como “UPDATE_NOOP” o “DELETE_NOOP”. Aunque se muestran como “NOOP”, siguen contribuyendo a las operaciones facturadas.
  • Escrituras contraídas. Si se realizan varias lecturas a un mismo documento rápidamente, el panel de uso puede contraer varias escrituras y contarlas como una sola. Cuando se usa la facturación, cada escritura se cuenta por separado.

    El panel de uso también contrae las escrituras para transformaciones de campo, como marcas de tiempo del servidor, incrementos numéricos y operaciones de unión de arrays. Para las transformaciones de campo, es posible que el panel de uso cuente varias operaciones como una sola operación.

  • Búsquedas que no muestran resultados. Las búsquedas sin resultados incurren en el costo de una operación de lectura. Este uso se factura, pero no aparece en el panel.
  • Lee las operaciones asociadas con las 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 capta las operaciones de vencimiento automáticas que realizan las políticas de tiempo de actividad (TTL). Consulta las métricas de 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 rápida y útil de las invocaciones de reglas. Puedes complementar este panel con un análisis detallado en Cloud Monitoring.

Ve a Reglas.

Panel de supervisión de reglas de Cloud Firestore en Firebase console

Métricas de Cloud Monitoring

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

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

Nombre de la métrica Descripción
Operaciones de lectura de documentos

Es la cantidad de operaciones de lectura de documentos realizadas correctamente. Puedes desglosar esta métrica según el tipo de lectura: LOOKUP o QUERY.

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

Operaciones de escritura de documentos

Es la cantidad de operaciones de escritura de documentos realizadas correctamente. Puedes desglosar esta métrica según el tipo de escritura: CREATE o UPDATE.

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

Operaciones de eliminación de documentos Es la cantidad de eliminaciones correctas de documentos.
Conexiones activas

Es la cantidad de conexiones activas a tu base de datos.

Cada SDK web y para dispositivos móviles activo mantiene una sola conexión que puede compartirse entre varios objetos de escucha de instantáneas. Las bibliotecas cliente del servidor crean una conexión por cada objeto de escucha de instantáneas.

Objetos de escucha de instantáneas

Es la cantidad de objetos de escucha de instantáneas de todas las conexiones activas.

Recuento de eliminaciones del tiempo de actividad

Recuento total de documentos borrados según las políticas de tiempo de actividad (TTL).

Retrasos entre el vencimiento del tiempo de actividad y la eliminación

Tiempo transcurrido entre el vencimiento de un documento conforme a la política de tiempo de actividad (TTL)y el momento en que se borró.

Uso de actualizaciones en tiempo real

Utiliza las métricas de objetos de escucha de instantáneas y conexiones activas para medir tu uso de actualizaciones en tiempo real.

Supongamos que un usuario abre tu app en su teléfono. Luego, la app se conecta a Cloud Firestore y se suscribe a 10 consultas. Con esto, tus métricas aumentan en 1 conexión activa y 10 objetos de escucha 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 tus paneles.

Métricas de latencia

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

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

Configura un panel de Cloud Monitoring

Para configurar un panel con las métricas de Cloud Firestore, consulta Cómo administrar un panel personalizado y Cómo agregar widgets al panel

¿Qué sigue?