Cómo configurar y enviar alertas personalizadas a canales de notificación personalizados

Firebase ofrece alertas de Crashlytics predeterminadas (consulta la página de descripción general de las alertas). Sin embargo, es posible que estas alertas predeterminadas y sus canales de notificación no sean suficientes para tus necesidades.

En estos casos, puedes usar Cloud Monitoring para enviar alertas personalizadas a canales de notificaciones personalizados según los datos de Crashlytics (y, de manera opcional, los datos de sesiones de Firebase) que exportaste a Cloud Logging.

Para usar Cloud Monitoring en alertas personalizadas, debes configurar una política de alertas, que describe las circunstancias en las que deseas recibir alertas y cómo quieres recibir las notificaciones.

Por ejemplo, si tu porcentaje de usuarios sin fallas baja de un umbral específico, Cloud Monitoring puede enviar un mensaje de alerta personalizado a una dirección de correo electrónico específica o publicarlo en un servicio de terceros, como Discord, Slack o Jira. También puedes personalizar por completo la información que se envía en la alerta, como incluir vínculos directos útiles en la consola de Firebase o información de solución de problemas específica de la empresa.

En la documentación de Google Cloud, obtén más información sobre Cloud Monitoring y las alertas, incluidos los precios.

Requisitos previos

1. Asegúrate de que tu proyecto de Firebase tenga el plan de precios Blaze de pago por uso.

2. Configura la exportación a Cloud Logging de los datos de Crashlytics y, de forma opcional, de los datos de sesiones de Firebase.

3. Configura los canales de notificación.

Configura una política de alertas

A continuación, se incluyen instrucciones generales. Para obtener instrucciones detalladas, consulta la documentación de Google Cloud (por ejemplo, Crea políticas de alertas de límite de métrica o Usa PromQL para crear políticas de alertas).

Como parte de la ejecución de consultas, puedes configurar una alerta basada en registros o una alerta basada en SQL:

• Configura una alerta basada en registros:

  1. Ejecuta una consulta en Logs Explorer.

  2. Haz clic en el botón Agregar alerta que aparece.

  3. Sigue las instrucciones en pantalla para agregar una alerta basada en registros.

• Configura una alerta basada en SQL:

  1. Ejecuta una consulta en Análisis de registros.

  2. Haz clic en el botón Agregar alerta que aparece.

  3. Sigue las instrucciones en pantalla para agregar una alerta basada en SQL.

Como alternativa, puedes configurar alertas para tus métricas basadas en registros con la herramienta de configuración de políticas en la consola de Google Cloud, donde puedes elegir una de las siguientes opciones:

• Compilador: La IU de la consola proporciona un flujo de trabajo guiado para compilar la política de alertas.

• PromQL: Proporcionas una consulta de PromQL para tu política de alertas.

  Ejemplo de consulta de PromQL

  Por ejemplo, supongamos que creaste dos métricas basadas en registros para tus datos de sesiones de Crashlytics y Firebase exportados:

  • Una métrica llamada firebase/crashlytics_events con una etiqueta de errorType, que se define de la siguiente manera:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"

  • Otra métrica llamada firebase/session_events con una etiqueta de eventType, que se define de la siguiente manera:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fsession_events"

  A continuación, se muestra un ejemplo de consulta de PromQL que usa estas métricas basadas en registros para generar alertas cuando el porcentaje de sesiones sin fallas desciende por debajo del 70%:

  1 - (sum by (project_id) (rate({__name__="logging.googleapis.com/user/firebase/crashlytics_events", errorType="FATAL"}[5m])) /
  sum by (project_id) (rate({__name__="logging.googleapis.com/user/firebase/session_events", eventType="SESSION_START"}[5m]))
  ) < 0.7