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 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 dépasse un seuil que vous définissez pour un centile spécifié (le cas échéant) dans la console Firebase. Les alertes sont déclenchées uniquement 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ébut 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 a dépassé le seuil défini de l'application au cours de la dernière heure et pour le percentile configuré.
  • Aucune alerte n'a été émise 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 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 centile configuré.
  • (Pour iOS+ et Android uniquement) Aucune alerte n’a été émise précédemment pour le même seuil dans la dernière version de votre application.
  • (Pour le Web uniquement) Aucune alerte n'a été émise pour le même seuil au cours des trois derniers jours .

requêtes réseau

Lorsque vous configurez une alerte pour une métrique de demande 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 en dessous du 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 :
    • frames gelées : la valeur agrégée a dépassé le seuil défini
    • frames lentes : 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 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 de chargement de 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 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 contenue : 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 percentile configuré
  • Aucune alerte n'a été émise pour le même seuil au cours des 3 derniers jours .

Apprenez-en davantage sur la configuration des alertes , des centiles par défaut et des bonnes 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.

Recevoir des alertes

Recevez des alertes par défaut

Par défaut, Firebase peut envoyer des alertes de surveillance des performances par e-mail.

Pour recevoir des alertes de surveillance des performances 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 :

Les alertes et leurs paramètres s'appliquent à l'ensemble du projet. Cela signifie que, par défaut, chaque membre du projet (qui n'est pas un groupe de messagerie et dispose des autorisations requises pour recevoir des alertes) recevra un e-mail lorsqu'une alerte de performance 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.

Pour activer ou désactiver les alertes de surveillance des performances, procédez comme suit :

  1. Dans la console Firebase, dans le coin supérieur droit, accédez à Alertes Firebase .
  2. Ensuite aller à paramètres Paramètres définissez les préférences de votre compte pour les alertes de surveillance des performances.

Configurer des alertes avancées pour les services tiers

Vous pouvez également envoyer des alertes de surveillance des performances au canal de notification préféré de votre équipe, à l'aide de Cloud Functions pour Firebase. Par exemple, vous pouvez écrire une fonction qui capture un événement d'alerte pour une heure de démarrage lente d'une 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 pour Firebase, procédez comme suit :

  1. Configurez Cloud Functions pour Firebase , 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 pour 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, accédez à la documentation de référence pour les alertes de surveillance des performances .

Suppression automatique des alertes invalides

La surveillance des performances valide les alertes pour garantir que les données sont valides et que les alertes sont activement utilisées. 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 client .

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

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 or 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 plateformes Web , Android , Apple et Flutter .

Dans chacune de vos applications enregistrées, utilisez le tableau Traces ou le 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 n'avoir aucune alerte du tout).

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 percentile (le cas échéant) pour l'application, ou pour activer/désactiver l'alerte. Les percentiles 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 indicateurs clés dans votre tableau de bord .

Configurer une alerte dans le bulletin 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, localisez la fiche de métrique pour laquelle vous souhaitez configurer une alerte.

  3. Dans la carte métrique souhaitée, ouvrez le menu Overflow ( ) et 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 percentiles 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 indicateurs clés dans votre tableau de bord .

Bonnes pratiques pour définir une alerte de performances

Demandes de 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 requête à un modèle d'URL personnalisé, les requêtes similaires sont mappées de manière plus cohérente au 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 de demandes spécifique comme étant 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. Gardez à l’esprit 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 garantir 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 d'images lentes et gelées. Performance Monitoring 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 comme 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 instructions de Google Play .