Utilisez des alertes de vitesse pour informer votre équipe lorsqu'un problème spécifique entraîne un problème urgent dans votre application. Pour Crashlytics, un problème correspond à 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 vitesse en termes de pourcentage de sessions utilisateur 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, pendant 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 compte 250 sessions sur cette période.
- Aucune alerte n'a é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 de qualité Firebase, Administrateur Firebase ou Propriétaire ou éditeur du projet.
Configurez un seuil d'alerte de vitesse 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 pour 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 de vitesse et les régressions, Firebase peut également les afficher 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, un e-mail est envoyé à chaque membre du projet (qui dispose des autorisations requises pour recevoir des alertes) 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:
- Dans la console Firebase, en haut à droite, accédez à
Alertes Firebase . - Accédez ensuite à
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 de workflows avec requête dans l'onglet Intégrations de
Notez que si vous souhaitez plus de contrôle et de personnalisation pour l'envoi d'alertes à un service tiers (et pas seulement à 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 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 pour les alertes de vitesse et publie les informations d'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 dans la console Firebase ou ajouter des informations de dépannage spécifiques à votre 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 comprend les tâches suivantes:
- Configurez un environnement de développement pour Node.js ou Python.
- Installez et connectez-vous à la CLI Firebase.
- 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, 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, consultez la documentation de référence sur les alertes Crashlytics.