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 la consola de Google Cloud y la consola de Firebase 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 un rol de Cloud Monitoring o un rol personalizado.
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 sección 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.
Cloud Firestore database usage dashboard in the Google Cloud console."/>
Panel de uso agregado
Si tu proyecto tiene varias bases de datos Cloud Firestore, puedes visualizar métricas de uso agregadas en la consola de Google Cloud o en la consola de Firebase.
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:
Cloud Firestore project usage dashboard in the Google Cloud console."/>
Consola de Firebase
Ve a la página de uso de Cloud Firestore (consola de Firebase)
Cloud Firestore usage dashboard in the Firebase console."/>
Informes de facturación y panel de uso
Los paneles de uso de Cloud Firestore en Firebase y las consolas 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.
Cloud Firestore Rules
monitoring dashboard in the Firebase console."/>
Cloud Monitoring métricas
Cloud Monitoring recopila métricas, eventos y metadatos de 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, 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 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 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 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 Google Cloud firestore.
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?
- Más información sobre Cloud Monitoring.
- Obtén información sobre las prácticas recomendadas para supervisar el rendimiento de Firestore.