Configurer et envoyer des alertes personnalisées à des canaux de notification personnalisés

Firebase propose des alertes Crashlytics par défaut (consultez la page Présentation des alertes). Toutefois, ces alertes par défaut et leurs canaux de notification peuvent ne pas suffire à vos besoins.

Dans ce cas, vous pouvez utiliser Cloud Monitoring pour envoyer des alertes personnalisées à des canaux de notification personnalisés en fonction des données Crashlytics (et éventuellement des données de sessions Firebase) que vous avez exportées vers Cloud Logging.

Pour utiliser Cloud Monitoring pour les alertes personnalisées, vous configurez une règle d'alerte, qui décrit les circonstances dans lesquelles vous souhaitez être averti et comment vous souhaitez être averti.

Par exemple, si votre taux d'absence d'erreur passe en dessous d'un seuil spécifique, Cloud Monitoring peut envoyer un message d'alerte personnalisé à une adresse e-mail spécifique ou le publier sur un service tiers, tel que Discord, Slack ou Jira. Vous pouvez également personnaliser entièrement les informations envoyées dans l'alerte, par exemple en incluant des liens profonds utiles dans la console Firebase ou des informations de dépannage spécifiques à l'entreprise.

Pour en savoir plus sur Cloud Monitoring et les alertes, y compris sur les tarifs, consultez la documentation Google Cloud.

Prérequis

1. Assurez-vous que votre projet Firebase dispose du forfait Blaze avec paiement à l'usage.

2. Configurez l'exportation des données Crashlytics et (éventuellement) des données de sessions Firebase vers Cloud Logging.

3. Configurez des canaux de notification.

Configurer une règle d'alerte

Voici des instructions générales. Pour obtenir des instructions détaillées, consultez la Google Cloud documentation (par exemple, Créer des règles d'alerte basées sur un seuil de métrique ou Utiliser PromQL pour créer des règles d'alerte).

Lorsque vous exécutez des requêtes, vous pouvez configurer une alerte basée sur les journaux ou une alerte basée sur SQL :

• Configurer une alerte basée sur les journaux :

  1. Exécutez une requête dans Logs Explorer.

  2. Cliquez sur le bouton Ajouter une alerte qui s'affiche.

  3. Suivez les instructions à l'écran pour ajouter une alerte basée sur les journaux.

• Configurer une alerte basée sur SQL :

  1. Exécutez une requête dans l'Analyse de journaux.

  2. Cliquez sur le bouton Ajouter une alerte qui s'affiche.

  3. Suivez les instructions à l'écran pour ajouter une alerte basée sur SQL.

Vous pouvez également configurer des alertes pour vos métriques basées sur les journaux à l'aide de l' outil de configuration des règles dans la console Google Cloud, où vous pouvez choisir l'une des options suivantes :

• Générateur: l'interface utilisateur de la console fournit un workflow guidé pour créer la règle d'alerte.

• PromQL: Vous fournissez une requête PromQL pour votre règle d'alerte.

  Exemple de requête PromQL

  Supposons que vous ayez créé deux métriques basées sur les journaux pour vos données exportées Crashlytics et de sessions Firebase :

  • Une métrique nommée firebase/crashlytics_events avec un libellé errorType, définie comme suit :

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

  • Une autre métrique nommée firebase/session_events avec un libellé eventType, définie comme suit :

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

  Voici un exemple de requête PromQL utilisant ces métriques basées sur les journaux pour envoyer une alerte lorsque votre taux d'absence d'erreur passe en dessous de 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