Utilisez les alertes de vitesse pour informer votre équipe dès qu'une difficulté spécifique entraîne un problème à résoudre d'urgence dans votre application. Pour Crashlytics, un problème est un regroupement de plantages similaires.
Qu'est-ce qui déclenche une alerte ?
Les alertes de vitesse se déclenchent 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 ayant été affectées par un plantage. Vous pouvez définir une valeur de seuil comprise entre 0,1 % et 1 % des sessions. Par défaut, le seuil d'alerte de vitesse est défini sur 1 % des sessions.
Plus précisément, une alerte est déclenchée si, au cours d'une période d'une heure, les conditions suivantes sont remplies :
- Un problème dans une application dépasse le seuil défini pour cette application.
- L'application a enregistré 250 sessions au cours de cette période.
- Aucune alerte n'avait été émise précédemment pour le problème dans l'application.
Modifier 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 :
Administrateur Firebase Crashlytics,
Administrateur Firebase Quality,
Administrateur Firebase ou
Propriétaire ou Éditeur du projet.
Configurez un seuil d'alerte de vélocité pour chacune de vos applications enregistrées. Chaque application peut avoir un seuil d'alerte différent.
- Dans la console Firebase, accédez à votre tableau de bord Crashlytics.
- En haut de la page, sélectionnez une application dans la liste déroulante.
- Dans la barre supérieure du volet Problèmes, ouvrez le menu à développer (), puis sélectionnez Paramètres des alertes de vitesse.
- Suivez les instructions à l'écran pour configurer le seuil d'alerte de l'application.
Recevoir des alertes
Recevoir les alertes par défaut
Par défaut, Firebase peut envoyer des alertes Crashlytics par e-mail. Pour les alertes et les régressions de vélocité, 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 sera déclenchée.
Activer/Désactiver les alertes pour votre propre compte
Pour votre propre compte, vous pouvez activer ou désactiver les alertes Crashlytics sans affecter les autres membres du projet. Notez que vous devez toujours disposer des autorisations requises pour recevoir des alertes.
Pour activer ou désactiver les alertes Crashlytics :
- Dans la console Firebase, en haut à droite, accédez à
Alertes Firebase . - Ensuite, accédez à
Paramètres et définissez vos préférences de 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 des workflows guidés dans l'onglet Intégrations de vos
Notez que si vous souhaitez bénéficier de plus de contrôle et de personnalisation pour envoyer des alertes à un service tiers (et pas seulement à Slack, Jira ou PagerDuty), consultez la section Configurer des alertes avancées pour 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 sur le canal de notification préféré de votre équipe à l'aide de Cloud Functions for Firebase. Par exemple, vous pouvez écrire une fonction qui capture un événement d'alerte de vitesse et publie les informations de l'alerte sur un service tiers, comme Discord, Slack ou Jira. Grâce à ce mécanisme d'alerte avancé, vous pouvez personnaliser entièrement les informations envoyées au service tiers. Par exemple, vous pouvez inclure des liens profonds utiles vers 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 for Firebase, procédez comme suit :
Configurez Cloud Functions pour Firebase, ce qui inclut les tâches suivantes :
- Configurez un environnement de développement pour Node.js ou Python.
- Installez la CLI Firebase et connectez-vous.
- Initialisez Cloud Functions for Firebase à l'aide de la CLI Firebase.
É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, en publiant les informations de 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.