Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Supervisa la actividad de Cloud Firestore

En esta página se describe cómo puedes supervisar el uso de Cloud Firestore y detectar posibles problemas en tu app. Si observas el uso de la app, tendrás una idea del importe de la próxima factura. Además, si algo parece estar fuera de lugar, contar con una imagen clara de las operaciones de la base de datos puede ser una herramienta útil para solucionar problemas.

Panel de uso

Google Cloud Platform Console y Firebase console incluyen un panel de uso de Cloud Firestore que muestra las operaciones de lectura, escritura y eliminación de documentos a lo largo del tiempo.

GCP Console

Ir a la página de uso de Cloud Firestore (GCP Console)

El panel de uso de Cloud Firestore de GCP Console

Control de acceso

El panel de uso requiere 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.

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. 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, contribuyen a las operaciones facturadas. Sin embargo, el panel de uso no cuenta estas operaciones.
  • 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.

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.

Ir a la página Reglas

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

Cuotas diarias

Cuando creas un proyecto de Firebase, también creas un proyecto en Google Cloud. En la página Cuotas de App Engine de GCP Console, se realiza un seguimiento de la información del uso diario de Cloud Firestore, incluidas las lecturas, las escrituras, las escrituras de índice, las eliminaciones, los datos almacenados y la salida de red.

Ir a la página Cuotas

El uso de Cloud Firestore en la página Cuotas de App Engine

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.

Evaluaciones de las reglas

La cantidad de evaluaciones de reglas de Cloud Firestore ejecutadas en respuesta a solicitudes de escritura o lectura. Puedes desglosar esta métrica según el resultado de la solicitud (ALLOW, DENY o ERROR).

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.

Con estas métricas, puedes configurar un panel de Cloud Firestore como el siguiente:

El uso de Cloud Firestore en un panel de Cloud Monitoring

Sigue los pasos que se indican a continuación para comenzar a supervisar Cloud Firestore con Cloud Monitoring.

Crea un lugar de trabajo de Cloud Monitoring

Para supervisar Cloud Firestore con Cloud Monitoring, debes configurar un lugar de trabajo para tu proyecto. Un lugar de trabajo permite organizar la información de supervisión de uno o más proyectos. Después de configurar un lugar de trabajo, podrás crear paneles personalizados y políticas de alertas.

  1. Abrir la página de Cloud Monitoring

    Si tu proyecto ya forma parte de un lugar de trabajo, se abrirá la página de Cloud Monitoring. De lo contrario, selecciona uno para tu proyecto.

  2. Selecciona la opción Nuevo lugar de trabajo o selecciona uno que ya exista.

  3. Haz clic en Agregar. Después de que se compile el lugar de trabajo, se abrirá la página de Cloud Monitoring.

Crea un panel y agrega un gráfico

Puedes mostrar las métricas de Cloud Firestore recopiladas de Cloud Monitoring en tus propios gráficos y paneles.

Antes de continuar, asegúrate de que el proyecto forme parte de un lugar de trabajo de Cloud Monitoring.

  1. En la página Cloud Monitoring, abre el lugar de trabajo y ve a la página Paneles.

    Ir a la página Paneles

  2. Haz clic en Crear panel y, luego, ingresa un nombre para el panel.

  3. En la esquina superior derecha, haz clic en Agregar gráfico.

  4. En la ventana Agregar gráfico, ingresa un título para el gráfico. Haz clic en la pestaña Metric.

  5. En el campo Find resource type and metric, ingresa Cloud Firestore. En el menú desplegable de propagación automática, selecciona una de las métricas de Cloud Firestore.

  6. Para agregar más métricas al mismo gráfico, haz clic en Agregar métrica y repite el paso anterior.

  7. Opcionalmente, adapta el gráfico según tus necesidades. Por ejemplo, en el campo Filtro, haz clic en + Agregar un filtro. Desplázate hacia abajo y, luego, selecciona un valor o rango para la métrica que deseas usar a fin de filtrar el gráfico.

  8. Haz clic en Guardar.

Para obtener más información sobre los gráficos de Cloud Monitoring, consulta cómo trabajar con gráficos.

Crea una política de alertas

Puedes crear una política de alertas basada en las métricas de Cloud Firestore. Sigue los pasos que se indican a continuación para crear una política de alertas que te envíe un correo electrónico cada vez que una métrica específica de Cloud Firestore cumpla con un límite determinado.

Antes de continuar, asegúrate de que el proyecto forme parte de un lugar de trabajo de Cloud Monitoring.

  1. En la página Cloud Monitoring, abre el lugar de trabajo y ve a la página Alertas.

    Ir a la página Crear política de alertas nueva

  2. Haz clic en Crear política.

  3. Ingresa un nombre para la política de alertas.

  4. Agrega una condición de alerta basada en una de las métricas de Cloud Firestore. Haz clic en Agregar condición.

  5. Selecciona un objetivo. En el campo Find resource type and metric, ingresa Cloud Firestore. En el menú desplegable de propagación automática, selecciona una de las métricas de Cloud Firestore.

  6. En Activadores de políticas, usa los campos desplegables para definir la condición de alerta.

  7. Agrega un canal de notificaciones a tu política de alertas. En Notificaciones, haz clic en Agregar canal de notificaciones. Selecciona Correo electrónico en el menú desplegable.

  8. Ingresa tu dirección de correo electrónico en el campo Dirección de correo electrónico. Haz clic en Agregar.

  9. De manera opcional, completa el campo de documentación para incluir información adicional en tu notificación por correo electrónico.

  10. Haz clic en Guardar.

Si el uso de Cloud Firestore supera el límite configurado, recibirás una alerta por correo electrónico como la que se muestra a continuación: Un ejemplo de correo electrónico de alerta de Cloud Firestore

Para obtener más información sobre las políticas de alertas, consulta Introducción a las alertas.

Pasos siguientes