Configurer des alertes en cas de problèmes de performances

Utilisez des 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, qui vous avertissent 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 franchit un seuil que vous définissez pour un percentile spécifié (le cas échéant) dans la console Firebase. Les alertes ne se déclenchent que si votre application utilise une version de SDK compatible avec la surveillance en temps réel.

Découvrez comment configurer des alertes, les percentiles 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 Firebase intégrées avec Slack, Jira et 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'autorisation firebaseperformance.config.update. Les rôles suivants incluent cette autorisation requise par défaut:

• Administrateur Firebase Performances
• Administrateur de qualité Firebase
• Administrateur Firebase
• Propriétaire ou éditeur du projet

Les alertes et leurs paramètres s'appliquent à l'ensemble du projet. Cela signifie que, par défaut, chaque membre du projet recevra un e-mail lorsqu'une alerte de performances sera déclenchée. Les alertes ne sont envoyées qu'aux membres du projet disposant des autorisations requises pour recevoir des alertes et aux adresses e-mail individuelles (et non aux regroupements 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 avez toujours besoin 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 alertes Performance Monitoring.

Configurer des alertes avancées pour les services tiers

Vous pouvez également envoyer des alertes Performance Monitoring au 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 un temps de démarrage lent de l'application et publie les informations d'alerte sur un service tiers, comme 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 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 for Firebase à l'aide de la CLI Firebase.

2. Écrivez et déployez une fonction qui capture un événement d'alerte à partir 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 de surveillance des performances.

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. 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 modèle d'URL personnalisé et configuré une alerte, vous disposez de 90 jours pour envoyer des données pour ce modèle. Si aucune donnée n'est envoyée dans un délai de 90 jours, Performance Monitoring supprime cette alerte. Pour en savoir plus sur les formats d'URL personnalisée, consultez la section Agréger des données sous les 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 des performances Firebase, Administrateur de qualité Firebase, Administrateur Firebase et Propriétaire ou éditeur du projet.

Si vous ne l'avez pas déjà fait, ajoutez le dernier 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 des 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 ne pas avoir d'alertes du tout).

Configurer une alerte dans le tableau "Traces"

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

2. Faites défiler l'écran 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évelopper (more_vert) et sélectionnez Paramètres des alertes.

5. Suivez les instructions à l'écran pour définir le seuil d'alerte et le percentile (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 percentiles par défaut, consultez 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 Dashboard (Tableau de bord) de la console Firebase, puis sélectionnez l'application pour laquelle vous souhaitez configurer une alerte.

2. Dans l'onglet "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évelopper more_vert, puis sélectionnez Paramètres d'alerte.

4. Suivez les instructions à l'écran pour définir le seuil d'alerte et le percentile (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 percentiles 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 de réseau

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

• Modèles définis par l'utilisateur, appelés formats d'URL personnalisés.

• Modèles dérivés de Firebase, appelés modèles d'URL automatiques.
  Ces tendances peuvent changer au fil du temps en fonction des derniers comportements d'utilisation de votre application.

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

Nous vous recommandons de configurer des alertes pour tous les modèles 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 sur le même format d'URL. Les alertes pour un schéma d'URL personnalisée sont ainsi plus pertinentes et efficaces pour votre équipe, car vous avez déjà identifié ce schéma de requêtes 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 le format d'URL automatique s'est stabilisé pendant quelques jours. N'oubliez pas que les modèles d'URL automatiques peuvent changer au fil du temps, et que les configurations d'alerte ne sont pas transférées vers les nouveaux modèles d'URL. Cela peut entraîner des alertes incorrectes ou manquantes pour les tendances qui vous intéressent. Vous pouvez également envisager de créer un format d'URL personnalisé pour vous assurer qu'il est stable.

Chargement de la page 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 dans l'application, les sessions utilisateur ne doivent pas comporter de frames lents ni figés. 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 trop lentes ou figées et sur d'autres bonnes pratiques en matière de performances des applications, consultez les consignes Google Play.