Supervisa el uso

En esta página, se describe cómo puedes supervisar el uso de Firestore y detectar posibles problemas en la app. Observar el uso de la app también puede darte una idea de lo que puedes esperar en la 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 Console y Firebase console incluyen un panel de uso de Firestore que muestra lecturas, escrituras y eliminaciones de documentos en el tiempo.

Cloud Console

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

El panel de uso de Firestore en Cloud Console

Control de acceso

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

Firebase console

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

El panel de uso de Firestore en Firebase console

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 Firestore en Firebase console

Cuotas diarias

En la página Cuotas de App Engine de Cloud 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

Uso de 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 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 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

Es la cantidad de evaluaciones de reglas de Firestore realizadas 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

Usa las métricas de objetos de escucha de instantáneas y conexiones activas para medir el uso de las 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.

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

Uso de Firestore en un panel de Cloud Monitoring

Completa los siguientes pasos para comenzar a supervisar Firestore con Cloud Monitoring.

Crea un lugar de trabajo de Cloud Monitoring

A fin de supervisar Firestore con Cloud Monitoring, debes configurar un lugar de trabajo para el 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

Muestra las métricas de 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 Métrica.

  5. En el campo Buscar tipo de recurso y métrica, ingresa Firestore. En el menú desplegable de propagación automática, selecciona una de las métricas de 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 Firestore. Sigue los pasos a continuación para crear una política de alertas que te envíe correos electrónicos cada vez que una métrica específica de Firestore alcance 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 Firestore. Haz clic en Agregar condición.

  5. Selecciona un objetivo. En el campo Buscar tipo de recurso y métrica, ingresa Firestore. En el menú desplegable de propagación automática, selecciona una de las métricas de 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 la 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 tu uso de Firestore supera el umbral configurado, recibirás una alerta por correo electrónico:Un ejemplo de correo electrónico de alerta de Firestore.

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

Qué sigue