Check out what’s new from Firebase at Google I/O 2022. Learn more

Configurer des alertes pour les problèmes de performances

Utilisez les alertes de surveillance des performances pour informer les membres du projet si des modifications de code ou des demandes 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 franchissent 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 console Firebase. Les alertes ne sont déclenchées que si votre application utilise une version du SDK compatible en temps réel .

heure de début de l'application

Lorsque vous configurez une alerte pour l'heure de démarrage de l'application, l'alerte est déclenchée si toutes les conditions suivantes sont remplies :

  • Firebase a enregistré au moins 100 échantillons de la trace _app_start pour la dernière version de votre application au cours de la dernière heure.
  • La durée de la trace _app_start dépassé le seuil défini de l'application au cours de la dernière heure et pour le centile configuré.
  • Aucune alerte n'a été déclenchée précédemment pour le même seuil dans la dernière version de votre application.

traces de code personnalisé

Lorsque vous configurez une alerte pour une métrique de trace de code personnalisée, l'alerte est déclenchée si toutes les conditions suivantes sont remplies :

  • Firebase a enregistré au moins 100 échantillons de la trace de code personnalisé pour la dernière version de votre application au cours de la dernière heure.
  • La durée de la trace a dépassé le seuil défini de l'application au cours de la dernière heure et pour le centile configuré.
  • (Pour iOS+ et Android uniquement) Aucune alerte n'a été précédemment déclenchée pour le même seuil dans la dernière version de votre application.
  • (Pour le Web uniquement) Aucune alerte n'a été déclenchée pour le même seuil au cours des 3 derniers jours .

requêtes réseau

Lorsque vous configurez une alerte pour une métrique de requête réseau, l'alerte est déclenchée si toutes les conditions suivantes sont remplies :

  • Firebase a enregistré au moins 100 échantillons correspondant au modèle d'URL dans toutes les versions de votre application au cours de la dernière heure.
  • La valeur agrégée de la métrique a dépassé le seuil défini au cours de la dernière heure :
    • temps de réponse : la valeur agrégée a dépassé le seuil défini pour le centile configuré
    • taux de réussite : (pour iOS+/Android uniquement) la valeur agrégée est passée sous le seuil défini pour tous les utilisateurs
  • Aucune alerte n'a été émise pour le même seuil au cours des 3 derniers jours .

rendu d'écran

Lorsque vous configurez une alerte pour une métrique de rendu d'écran, l'alerte est déclenchée si toutes les conditions suivantes sont remplies :

  • Firebase a enregistré au moins 100 échantillons de rendu d'écran pour la dernière version de votre application au cours de la dernière heure.
  • La valeur agrégée de la métrique a dépassé le seuil défini au cours de la dernière heure :
    • trames figées : la valeur agrégée a dépassé le seuil défini
    • trames lentes : la valeur agrégée a dépassé le seuil défini
  • Aucune alerte n'a été déclenchée précédemment pour le même seuil dans la dernière version de votre application.

chargements de pages

Lorsque vous configurez une alerte pour une métrique de chargement de page, l'alerte est déclenchée si toutes les conditions suivantes sont remplies :

  • Firebase a enregistré au moins 100 échantillons du chargement de la page de votre application au cours de la dernière heure.
  • La valeur agrégée de la métrique a dépassé le seuil défini au cours de la dernière heure et pour le centile configuré :
    • premier délai d'entrée : la valeur agrégée a dépassé le seuil défini et le centile configuré
    • première peinture contente : la valeur agrégée a dépassé le seuil défini et le centile configuré
    • première peinture : la valeur agrégée a dépassé le seuil défini et le centile configuré
  • Aucune alerte n'a été émise pour le même seuil au cours des 3 derniers jours .

En savoir plus sur la configuration des alertes , les centiles par défaut et les meilleures pratiques pour configurer des alertes pour des types spécifiques de traces et de métriques.

Les alertes pour d'autres mesures de performances ou pour les intégrations Firebase intégrées avec Slack , Jira et PagerDuty ne sont pas disponibles pour les alertes de surveillance des performances.

Recevez des alertes

Les alertes de surveillance des performances sont envoyées via des notifications par e-mail.

Pour recevoir des alertes de surveillance des performances, vous devez disposer de l'autorisation firebaseperformance.config.update . Les rôles suivants incluent cette autorisation requise par défaut :

Les alertes et leurs paramètres s'appliquent à l'ensemble du projet. Cela signifie que, par défaut, chaque membre du projet (qui dispose des autorisations requises pour recevoir des alertes) recevra une notification par e-mail lorsque l'alerte est déclenchée.

La surveillance des performances valide les alertes pour s'assurer que les données sont valides et que les alertes sont en cours d'utilisation. Les alertes sont considérées comme valides si l'une des conditions suivantes est vraie :

  • 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 modèle d'URL personnalisé. Après avoir 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 le délai de 90 jours, Performance Monitoring supprime cette alerte. Pour plus d'informations sur les modèles d'URL personnalisés, consultez Agréger les données sous les modèles d'URL des clients .

Si l'une de ces conditions n'est pas remplie, la surveillance des performances supprime l'alerte.

Activer/désactiver les alertes pour votre propre compte

Pour votre propre compte, vous pouvez activer/désactiver les alertes de surveillance des performances sans affecter les autres membres du projet. Notez que vous avez toujours besoin des autorisations requises pour recevoir des alertes.

Dans la console Firebase, dans le coin supérieur droit, accédez aux Alertes Firebase > Paramètres , puis définissez vos préférences de compte pour les alertes de surveillance des performances.

Configurer une alerte

Pour configurer les alertes de surveillance des performances, vous devez disposer de l'autorisation firebaseperformance.config.update . Les rôles suivants incluent cette autorisation requise par défaut : Firebase Performance Admin , Firebase Quality Admin , Firebase Admin et Project Owner ou Editor .

Si vous ne l'avez pas déjà fait, ajoutez le dernier SDK de surveillance des performances à votre application. Pour plus d'informations, 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 différent d'alertes, chacune avec un seuil différent (ou n'avoir aucune alerte).

Configurer une alerte dans le tableau Traces

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

  2. Faites défiler 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 de débordement ( ) 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 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 Tableau de bord de surveillance des performances 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 mesure pour laquelle vous souhaitez configurer une alerte.

  3. Dans la fiche de métrique souhaitée, ouvrez le menu de débordement ( ) 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 Suivre les métriques clés dans votre tableau de bord .

Meilleures pratiques pour définir une alerte de performances

Requêtes réseau

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

Configurer des alertes pour vos modèles 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 demande à un modèle d'URL personnalisé, les demandes similaires sont mappées de manière plus cohérente avec le même modèle d'URL. Cela rend les alertes pour un modèle d'URL personnalisé plus significatives et efficaces pour votre équipe, car vous avez déjà identifié ce modèle spécifique de demandes comme important pour votre application.

Configurer des alertes pour les modèles d'URL automatiques

Lors de la configuration d'une alerte pour un modèle d'URL automatique, assurez-vous que le modèle 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 répercutées sur les nouveaux modèles d'URL. Cela pourrait entraîner des alertes incorrectes ou manquantes pour les modèles qui vous intéressent. Vous pouvez également envisager de créer un modèle d'URL personnalisé pour vous assurer que ce modèle est stable.

Chargements de pages Web

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

Rendus d'écran

Pour garantir une expérience d'application optimale, les sessions utilisateur doivent être exemptes de trames lentes et gelées. La surveillance des performances vous recommande de configurer des alertes pour les images gelées supérieures à 1 % et de configurer des alertes pour les images lentes dépassant 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 gelées et sur d'autres bonnes pratiques en matière de performances des applications, consultez les conseils de Google Play .