Configurer des alertes en cas de problèmes de performances

Utilisez les alertes Performance Monitoring pour avertir les membres du projet si des modifications de code ou des requêtes réseau dégradent les performances de votre application.

Vous pouvez configurer et personnaliser des alertes pour votre application. Vous serez ainsi averti lorsque les performances d'un événement dépassent un seuil défini.

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

Une alerte est déclenchée lorsqu'une métrique de votre application dépasse un seuil que vous définissez pour un centile spécifié (le cas échéant) dans la Firebase console. Les alertes ne sont déclenchées que si votre application utilise une version du SDK compatible en temps réel.

Découvrez comment configurer des alertes, les centiles par défaut, et les bonnes pratiques pour configurer des alertes pour des types spécifiques de traces et de métriques.

Les alertes pour d'autres métriques de performances ou pour les intégrations configurées dans la console Firebase avec Slack, Jira ou PagerDuty ne sont pas disponibles pour les alertes Performance Monitoring.

Recevoir des alertes

Recevoir des alertes par défaut

Par défaut, Firebase peut envoyer des alertes Performance Monitoring par e-mail.

Pour recevoir des alertes Performance Monitoring via ce mécanisme par défaut, vous devez disposer de l' firebaseperformance.config.update autorisation. Les rôles suivants incluent cette autorisation requise par défaut :

• Administrateur Firebase Performance
• Administrateur Firebase Quality
• Administrateur Firebase
• Propriétaire ou éditeur du projet

Les alertes et leurs paramètres sont définis à l'échelle du projet. Cela signifie que, par défaut, chaque membre du projet recevra un e-mail lorsqu'une alerte de performances est déclenchée. Les alertes ne sont envoyées qu'aux membres du projet disposant des autorisations requises pour les recevoir et à des adresses e-mail individuelles (et non à des groupes de comptes tels que les groupes Google ou les comptes Google Workspace).

Activer/désactiver les alertes pour votre propre compte

Pour votre propre compte, vous pouvez activer/désactiver les alertes Performance Monitoring 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 Performance Monitoring, procédez comme suit :

1. Dans la console Firebase, en haut à droite, accédez à notifications Alertes Firebase.
2. Accédez ensuite à settings Paramètres et définissez vos préférences de compte pour les Performance Monitoring alertes.

Configurer des alertes avancées pour les services tiers

Vous pouvez également envoyer des alert0/} au canal de notification préféré de votre équipe à l'aide de Cloud Functions for Firebase.Performance Monitoring Par exemple, vous pouvez écrire une fonction qui capture un événement d'alerte pour un délai de démarrage d'application lent et publie les informations d'alerte sur un service tiers, tel que Discord, Slack ou Jira.

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 de Performance Monitoring 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 de performances que vous pouvez capturer, consultez la documentation de référence sur les alertes Performance Monitoring.

Suppression automatique des alertes non valides

Performance Monitoring valide les alertes pour s'assurer que les données sont valides et que les alertes sont utilisées activement. Les alertes sont considérées comme valides si l'une des conditions suivantes est remplie :

• L'alerte est créée pour un ID de ressource pour lequel Performance Monitoring a reçu des données au cours des 90 derniers jours.
• L'alerte a été créée récemment pour un format d'URL personnalisé. Une fois que vous avez créé un format d'URL personnalisé et configuré une alerte, vous disposez de 90 jours pour envoyer des données pour ce format. Si aucune donnée n'est envoyée dans ce délai de 90 jours, Performance Monitoring supprime cette alerte. Pour en savoir plus sur les formats d'URL personnalisés, consultez la section Agréger des données sous des formats d'URL client.

Si l'une de ces conditions n'est pas remplie, Performance Monitoring supprime l'alerte.

Configurer une alerte

Pour configurer des alertes Performance Monitoring, vous devez disposer de l'autorisation firebaseperformance.config.update. Les rôles suivants incluent cette autorisation requise par défaut : administrateur Firebase Performance, administrateur Firebase Quality, administrateur Firebase, et propriétaire ou éditeur du projet.

Si ce n'est pas déjà fait, ajoutez la dernière version du SDK Performance Monitoring à votre application. Pour en savoir plus, consultez les guides de démarrage pour les plates-formes Web, Android, Apple et Flutter.

Dans chacune de vos applications enregistrées, utilisez le tableau "Traces" ou la fiche de rapport du tableau de bord pour configurer une alerte pour chaque métrique que vous souhaitez surveiller. Chaque application peut avoir un ensemble d'alertes différent, chacune avec un seuil différent (ou aucune alerte).

Configurer une alerte dans le tableau "Traces"

1. Accédez à l'onglet Performance Monitoring Tableau de bord dans la console Firebase, puis sélectionnez l'application pour laquelle vous souhaitez configurer une alerte.

2. Faites défiler la page jusqu'au tableau "Traces" en bas de l'écran.

3. Sélectionnez l'onglet du type de trace pour lequel vous souhaitez définir une alerte, puis recherchez la ligne applicable.

4. À l'extrême droite de la ligne, ouvrez le menu "Dépassement" (more_vert) et sélectionnez Paramètres d'alerte.

5. Suivez les instructions à l'écran pour définir le seuil d'alerte et le centile (le cas échéant) pour l'application, ou pour activer/désactiver l'alerte. Les centiles par défaut sont le 90e pour Android et iOS, et le 75e pour le Web. Pour en savoir plus sur les centiles par défaut, consultez la section Suivre les métriques clés dans votre tableau de bord.

Configurer une alerte dans la fiche de rapport du tableau de bord

1. Accédez à l'onglet Performance Monitoring Tableau de bord dans la console Firebase, puis sélectionnez l'application pour laquelle vous souhaitez configurer une alerte.

2. Dans l'onglet "Fiche de rapport", recherchez la fiche de métrique pour laquelle vous souhaitez configurer une alerte.

3. Dans la fiche de métrique souhaitée, ouvrez le menu "Dépassement" (more_vert) et sélectionnez Paramètres d'alerte.

4. Suivez les instructions à l'écran pour définir le seuil d'alerte et le centile (le cas échéant) pour l'application, ou pour activer/désactiver l'alerte. Les centiles par défaut sont le 90e pour Android et iOS, et le 75e pour le Web. Pour en savoir plus sur les centiles par défaut, consultez la section Suivre les métriques clés dans votre tableau de bord.

Bonnes pratiques pour définir une alerte de performances

Requêtes réseau

Firebase agrège les données de requêtes réseau similaires sous des formats d'URL, qui peuvent être l'un des suivants :

• Formats définis par l'utilisateur, appelés formats d'URL personnalisés.

• Formats dérivés de Firebase, appelés formats d'URL automatiques.
  Ces formats peuvent changer au fil du temps en fonction du comportement d'utilisation le plus récent de votre application.

Configurer des alertes pour vos formats d'URL personnalisés

Nous vous recommandons de configurer des alertes pour tous les formats d'URL personnalisés que vous avez configurés. Étant donné que Firebase tente d'abord de faire correspondre une requête à un format d'URL personnalisé, les requêtes similaires sont mappées de manière plus cohérente au même format d'URL. Les alertes pour un format d'URL personnalisé sont donc plus pertinentes et efficaces pour votre équipe, car vous avez déjà identifié ce format de requête spécifique comme important pour votre application.

Configurer des alertes pour les formats d'URL automatiques

Lorsque vous configurez une alerte pour un format d'URL automatique, assurez-vous que ce format est stable depuis quelques jours. N'oubliez pas que les formats d'URL automatiques peuvent changer au fil du temps et que les configurations d'alerte ne sont pas transférées vers de nouveaux formats d'URL. Cela peut entraîner des alertes incorrectes ou manquantes pour les formats qui vous intéressent. Vous pouvez également envisager de créer un format d'URL personnalisé pour vous assurer que ce format est stable.

Chargements de pages Web

Pour connaître les seuils recommandés pour mesurer les métriques Web, consultez la documentation sur les Core Web Vitals.

Rendus d'écran

Pour garantir une expérience optimale de l'application, les sessions utilisateur ne doivent pas comporter d'images lentes ni figées. Performance Monitoring vous recommande de configurer des alertes pour les images figées supérieures à 1% et pour les images lentes supérieures à 5%. Vous constaterez que ces valeurs sont présentes en tant que paramètres par défaut lors de la configuration des alertes de performances. Pour en savoir plus sur les images lentes excessives ou figées et sur les autres bonnes pratiques en matière de performances des applications, consultez les conseils Google Play.