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.

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

Une alerte est déclenchée lorsqu'une métrique spécifique pour votre application dépasse un seuil que vous définissez 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 .

requêtes réseau

Si 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 50e centile des utilisateurs)
    • taux de réussite : (pour iOS+/Android uniquement) la valeur agrégée est passée en dessous du seuil défini (pour tous les utilisateurs)
  • Aucune alerte n'a été émise précédemment pour le même seuil (au cours des 3 derniers jours ).

heure de début de l'application

Si 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 50e centile des utilisateurs).
  • Aucune alerte n'a été déclenchée auparavant pour le même seuil (dans la dernière version de votre application).

traces de code personnalisé

Si 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 par l'application (au cours de la dernière heure et pour le 50e centile des utilisateurs).
  • Aucune alerte n'a été déclenchée auparavant pour le même seuil (dans la dernière version de votre application).

chargements de pages

Si 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 (pour 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 50e centile des utilisateurs) :
    • premier délai d'entrée : la valeur agrégée a dépassé le seuil défini
    • première peinture contente : la valeur agrégée a dépassé le seuil défini
  • Aucune alerte n'a été émise précédemment pour le même seuil (au cours des 3 derniers jours ).

Plus loin sur cette page, apprenez-en plus sur la configuration des alertes ainsi que sur certaines bonnes pratiques pour configurer des alertes pour des types spécifiques de traces et de métriques.

Notez qu'actuellement, 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 : Firebase Performance Admin , Firebase Quality Admin , Firebase Admin et Project Owner ou Editor .

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.

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 .

Dans chacune de vos applications enregistrées, configurez une alerte pour chaque métrique que vous souhaitez surveiller de près. Chaque application peut avoir un ensemble différent d'alertes, chacune avec un seuil différent (ou n'avoir aucune alerte).

  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 des traces au 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.

    Notez que la trace _app_start est imbriquée dans l'onglet Traces personnalisées .

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

  5. Suivez les instructions à l'écran pour définir le seuil d'alerte de l'application ou pour activer/désactiver l'alerte.

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 .