Personnaliser les alertes de vélocité

Utilisez des alertes de vélocité pour avertir votre équipe lorsqu'un problème individuel provoque un problème urgent dans votre application. Pour Crashlytics, un problème est un regroupement de crashs similaires.

Qu'est-ce qui déclenche une alerte ?

Les alertes de vélocité sont déclenchées lorsqu'un problème dans votre application dépasse un seuil que vous définissez dans la console Firebase .

Vous définissez le seuil des alertes de vélocité en termes de pourcentage de sessions utilisateur affectées par un crash . Vous pouvez définir une valeur seuil comprise entre 0,1% et 1% des sessions. Par défaut, le seuil d'alerte de vélocité est fixé à 1 % des sessions.

Plus précisément, une alerte est déclenchée si, pendant une période d'une heure, les éléments suivants sont vrais :

  • Un problème dans une application dépasse le seuil défini pour cette application.
  • L'application compte 250 sessions au cours de cette période.
  • Aucune alerte n’a été émise précédemment pour le problème dans l’application.

Mettre à jour le seuil d'alerte

Pour mettre à jour les alertes de vitesse, vous devez disposer de l'autorisation firebasecrashlytics.config.update . Les rôles suivants incluent cette autorisation requise par défaut : Firebase Crashlytics Admin , Firebase Quality Admin , Firebase Admin ou project Owner ou Editor .

Configurez un seuil d'alerte de vitesse pour chacune de vos applications enregistrées. Chaque application peut avoir un seuil d'alerte différent.

  1. Dans la console Firebase , accédez à votre tableau de bord Crashlytics.
  2. En haut de la page, sélectionnez une application dans la liste déroulante des applications.
  3. Dans la barre supérieure du volet Problèmes , ouvrez le menu de débordement ( ), puis sélectionnez Paramètres d'alerte de vélocité .
  4. Suivez les instructions à l'écran pour configurer le seuil d'alerte de l'application.

Recevoir des alertes

Recevez des alertes par défaut

Par défaut, Firebase peut envoyer des alertes Crashlytics par e-mail. Pour les alertes de vélocité et les régressions, Firebase peut également afficher ces alertes dans la console Firebase.

Pour recevoir des alertes Crashlytics à l'aide de ce mécanisme par défaut, vous devez disposer de l'autorisation firebase.projects.update . Les rôles suivants incluent cette autorisation requise par défaut : Administrateur Firebase ou Propriétaire ou Éditeur du projet.

Par défaut, chaque membre du projet (qui dispose des autorisations requises pour recevoir des alertes) recevra un e-mail lorsqu'une alerte de Crashlytics est déclenchée.

Activer/désactiver les alertes pour votre propre compte

Pour votre propre compte, vous pouvez activer/désactiver les alertes Crashlytics sans affecter les autres membres du projet. Notez que vous avez toujours besoin des autorisations requises pour recevoir des alertes.

Pour activer ou désactiver les alertes Crashlytics, procédez comme suit :

  1. Dans la console Firebase, dans le coin supérieur droit, accédez à Alertes Firebase .
  2. Ensuite aller à Paramètres et définissez les préférences de votre compte pour les alertes Crashlytics.

Configurer des alertes de base pour les services tiers

Pour les alertes Crashlytics, Firebase propose un mécanisme permettant d'envoyer des alertes aux services tiers suivants : Slack , Jira ou PagerDuty . Configurez ces options d'alerte de base à l'aide de flux de travail demandés dans l' onglet Intégrations de votre Paramètres du projet .

Notez que si vous souhaitez plus de contrôle et de personnalisation pour l'envoi d'alertes à un service tiers (sans se limiter à Slack, Jira ou PagerDuty), consultez la section Configurer des alertes avancées vers des services tiers qui décrit les options d'alerte avancées.

Configurer des alertes avancées pour les services tiers

Vous pouvez envoyer des alertes Crashlytics au canal de notification préféré de votre équipe, à l'aide de Cloud Functions pour Firebase. Par exemple, vous pouvez écrire une fonction qui capture un événement d'alerte pour les alertes de vitesse et publie les informations d'alerte sur un service tiers, comme Discord, Slack ou Jira. Avec ce mécanisme d'alerte avancé, vous pouvez entièrement personnaliser les informations envoyées au service tiers ; par exemple, vous pouvez inclure des liens profonds utiles dans la console Firebase ou ajouter des informations de dépannage spécifiques à l'entreprise.

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

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

    1. Configurez un environnement de développement pour Node.js ou Python.
    2. Installez et connectez-vous à la CLI Firebase.
    3. Initialisez Cloud Functions pour Firebase à l'aide de la CLI Firebase.
  2. Écrivez et déployez une fonction qui capture un événement d'alerte de Crashlytics et gère la charge utile de l'événement (par exemple, publie les informations d'alerte dans un message sur Discord).

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