Utilisez les 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 est un regroupement de plantages ou d'événements "Application ne répond pas" (ANR) similaires.
Qu'est-ce qui déclenche une alerte ?
Les alertes de vitesse sont déclenchées lorsqu'un problème dans votre application dépasse certains seuils que vous configurez dans la console Firebase.
Vous définissez le seuil des alertes de vélocité en termes de pourcentage d'utilisateurs et de nombre minimal d'utilisateurs ayant été touchés par le plantage ou l'ANR. Vous pouvez définir la valeur du seuil de pourcentage entre 0 % et 100 % des sessions. Le seuil minimal d'utilisateurs peut être défini sur n'importe quel nombre supérieur ou égal à 10. Par défaut, le seuil d'alerte de vélocité est défini sur 1 % des sessions et 25 utilisateurs.
Plus précisément, une alerte est déclenchée si, au cours d'une période de 30 minutes, toutes les conditions suivantes sont remplies :
- Un problème dans une application dépasse le seuil de pourcentage défini et le nombre minimal d'utilisateurs défini pour cette application.
- L'application compte au moins 10 utilisateurs au cours de cette période.
- Aucune alerte n'avait été émise précédemment pour le problème dans l'application sur cette version.
Configurer les seuils d'alerte de vitesse
Pour configurer les seuils des 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 des seuils d'alerte de vélocité pour chacune de vos applications enregistrées. Chaque application peut avoir un seuil d'alerte différent.
Connectez-vous à la console Firebase, puis sélectionnez votre projet.
Cliquez sur , puis sélectionnez Paramètres du projet. Sélectionnez l'onglet Alertes.
Accédez à la fiche d'alertes Crashlytics, puis sélectionnez l'onglet Alertes de vitesse.
Configurez les seuils 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 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 ou 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.
Connectez-vous à la console Firebase, puis sélectionnez votre projet.
Cliquez sur , puis sélectionnez Paramètres du projet. Sélectionnez l'onglet Alertes.
Accédez à la fiche d'alertes Crashlytics, puis sélectionnez l'onglet Alertes de vitesse.
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 de l'onglet Intégrations dans vos
Paramètres du projet .Sélectionnez la configuration utilisée pour chaque application et configurez la destination des autres alertes sur la fiche Crashlytics de l'onglet Alertes dans vos
Paramètres du projet .
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, 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.