Configurer des alertes avancées pour des canaux de notification personnalisés

Firebase propose deux options pour configurer des alertes et les envoyer à des canaux de notification personnalisés.

• (Recommandé) Configurer et envoyer des alertes personnalisées vers des canaux de notification personnalisés

  Vous pouvez utiliser Cloud Monitoring pour envoyer des alertes entièrement personnalisées à des canaux de notification personnalisés en fonction des données Crashlytics et (facultativement) des données de sessions Firebase que vous avez exportées vers Cloud Logging.

• Envoyer les alertes Crashlytics par défaut vers des canaux de notification personnalisés

  Vous pouvez utiliser Cloud Functions pour envoyer les alertes Crashlytics par défaut vers des canaux de notification personnalisés.

---

(Recommandé) Configurer et envoyer des alertes personnalisées vers 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

---

Envoyer des alertes Crashlytics par défaut vers des canaux de notification personnalisés

Firebase propose des alertes Crashlytics par défaut (consultez la liste sur la page de présentation des options d'alerte). Toutefois, les informations contenues dans ces alertes par défaut et leurs canaux de notification peuvent ne pas suffire à vos besoins.

Dans ce cas, vous pouvez utiliser Cloud Functions for Firebase pour envoyer ces alertes Crashlytics par défaut à des canaux de notification personnalisés. Par exemple, vous pouvez écrire une fonction qui capture un événement d'alerte pour les alertes de vélocité et publie les informations de l'alerte sur un service tiers, comme Discord, Slack ou Jira.

Ce mécanisme d'alerte avancé vous permet également de personnaliser les informations envoyées au service tiers. Par exemple, en plus des informations par défaut fournies par Firebase, vous pouvez également inclure des liens profonds utiles vers la console Firebase ou des informations de dépannage spécifiques à l'entreprise.

Pour configurer des fonctionnalités d'alerte avancées à l'aide de Cloud Functions for Firebase, procédez comme suit :

1. Configurez Cloud Functions pour Firebase, ce qui inclut les tâches suivantes :

   1. Configurez un environnement de développement pour Node.js ou Python.
   2. Installez la CLI Firebase et connectez-vous.
   3. Initialisez Cloud Functions for Firebase à l'aide de la CLI Firebase.

2. Écrivez et déployez une fonction qui capture un événement d'alerte à partir de Crashlytics et gère la charge utile de l'événement (par exemple, publie les informations sur l'alerte dans un message sur Discord).

Pour en savoir plus sur tous les événements d'alerte Crashlytics que vous pouvez capturer, consultez la documentation de référence sur les alertes Crashlytics.

En savoir plus sur la gestion des alertes Crashlytics à l'aide de Cloud Functions for Firebase