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

Firebase propose des alertes Crashlytics par défaut (consultez la page de 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 devez configurer 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 sans plantage 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, comme 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 vers la console Firebase ou des informations de dépannage spécifiques à l'entreprise.

Dans la documentation Google Cloud, découvrez Cloud Monitoring et les alertes, y compris les tarifs.

Prérequis

1. Assurez-vous que votre projet Firebase bénéficie du forfait Blaze avec paiement à l'usage.

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

3. Configurez des canaux de notification.

Configurer une règle d'alerte

Les instructions suivantes sont générales. Pour obtenir des instructions détaillées, consultez la documentation Google Cloud (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 :

• Configurez 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 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 de la console Google Cloud. Vous pouvez alors 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

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

  • 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 générer une alerte lorsque votre taux sans plantage descend 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