Supervisa el uso
En esta página, se describe cómo puedes supervisar tu uso de Firestore y detectar posibles problemas en tu app.
Panel de uso
Usa los paneles de uso de la consola de Google Cloud 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 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 Firestore, abre la página Uso de la base de datos en la consola de Google Cloud.
En la consola de Google Cloud, ve a la página Bases de datos.
Selecciona la base de datos requerida de la lista.
En el menú de navegación, haz clic en Uso.
Haz clic en el vínculo del mensaje que aparece en la página para ver el uso de tu base de datos.
Panel de uso agregado
Si tu proyecto tiene varias bases de datos de Firestore, puedes ver las métricas de uso agregado en la consola de Google Cloud o en Firebase console. El panel de uso a nivel del proyecto combina las métricas de uso de todas tus bases de datos de Firestore en modo nativo. Este panel no incluye el uso de las bases de datos de Firestore en modo Datastore.
Consola de Google Cloud
En la consola de Google Cloud, ve a la página Uso del proyecto.
Ir a Uso de proyectos de un proyecto de Google Cloud
El panel de uso del proyecto muestra las operaciones de los documentos a lo largo del tiempo de la siguiente manera:
Firebase console
Ir a la página de uso de Firestore (Firebase console)
Informes de facturación y panel de uso
Los paneles de uso de Firestore en Firebase y la consola de Cloud 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 operaciones de lectura de entradas de índice. Este uso se factura, pero no aparece en el panel de uso. Por ejemplo, las consultas de agregación facturan las entradas de índice leídas, pero este uso 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.
Métricas de Cloud Monitoring
Cloud Monitoring recopila métricas, eventos y metadatos de los productos de Google Cloud. El panel de uso en Firestore console informa los mismos datos de métricas. Para configurar paneles personalizados y alertas de uso, usa Cloud Monitoring.
Cloud Monitoring incluye las siguientes métricas de 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 operaciones de lectura de las operaciones administradas de exportación ni de eliminación masiva. |
| 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 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 Firestore se muestran cada minuto, pero las actualizaciones pueden tardar hasta 4 minutos en aparecer en los paneles.
Métricas de latencia
Las métricas de latencia del backend están disponibles a través de las métricas comunes de firestore 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 ver un panel predefinido o configurar uno, consulta Cómo usar el panel de supervisión.
¿Qué sigue?
- Obtén más información sobre Cloud Monitoring.
- Obtén información sobre las prácticas recomendadas para supervisar el rendimiento de Firestore.