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 liée à votre application dépasse un seuil que vous définir 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 un version de SDK compatible en temps réel.

heure de démarrage de l'application

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

  • Firebase a enregistré au moins 100 échantillons des _app_start. trace de 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 par 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 de votre application.

traces de code personnalisées

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

  • Firebase a enregistré au moins 100 échantillons de trace de code personnalisé. pour obtenir 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 pendant le pour la dernière heure et pour le centile configuré.
  • (Pour iOS+ et Android uniquement) Aucune alerte n'a été déclenchée auparavant 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 précédemment 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 requête réseau, l'alerte se déclenche si toutes les conditions suivantes sont remplies:

  • Firebase a enregistré au moins 100 échantillons correspondant à l'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 des heure:
    • Temps de réponse: la valeur agrégée dépasse 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 de le seuil défini pour tous les utilisateurs
  • Aucune alerte n'a été déclenchée précédemment pour le même seuil. 3 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 d'écrans. 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 pendant la période dernière heure:
    • Cadres figés : la valeur agrégée a dépassé le seuil défini.
    • Trames lentes: la valeur cumulée dépassait le seuil défini.
  • Aucune alerte n'a été déclenchée précédemment pour le même seuil dans la dernière de votre application.

chargements de page

Lorsque vous configurez une alerte pour une métrique de chargement de page, l'alerte se déclenche 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 des heure et pour le centile configuré:
    • First Input Delay (Délai avant la première entrée) : la valeur agrégée dépasse le seuil défini et le centile configuré
    • First Contentful Paint : la valeur agrégée a dépassé le seuil défini et le percentile configuré.
    • first paint: la valeur agrégée dépasse le seuil défini et le centile configuré
  • Aucune alerte n'a été déclenchée précédemment pour le même seuil. 3 jours.

En savoir plus sur la configuration 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 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 du Autorisation firebaseperformance.config.update. Les rôles suivants incluent autorisation requise par défaut:

Les alertes et leurs paramètres s'appliquent à l'ensemble du projet. Cela signifie que, par défaut, chaque Le membre du projet (qui n'est pas un groupe de messagerie et dispose des autorisations nécessaires pour recevoir des alertes) reçoit un e-mail lorsqu'une alerte liée aux performances est déclenchée.

Activer/Désactiver les alertes pour votre propre compte

Pour votre propre compte, vous pouvez activer/désactiver les alertes Performance Monitoring sans affectant les autres membres du projet. Notez que vous devez toujours disposer les 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 à Firebase des alertes.
  2. Accédez ensuite à Paramètres et définissez vos préférences de compte pour Performance Monitoring alertes.

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. Configurer Cloud Functions for Firebase qui comprend 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 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 enregistrer, accédez à la documentation de référence 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 une utilisation active. 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é. Après avoir créé un et que vous configurez une alerte, vous avez 90 jours pour envoyer des données ce modèle. Si aucune donnée n'est envoyée au cours de la période de 90 jours, Performance Monitoring supprime cette alerte. Pour en savoir plus sur les formats d'URL personnalisée, consultez Regroupez les 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 autorisation requise par défaut: Administrateur Firebase Performance, 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 de traces. ou la fiche du rapport sur le tableau de bord pour configurer une alerte pour chaque métrique à surveiller. Chaque application peut disposer ensemble d'alertes différent, chacune avec un seuil différent (ou n'ayant aucune alerte toutes).

Configurer une alerte dans la table "Traces"

  1. Accédez au tableau de bord Performance Monitoring. Tabulation 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" (Traces) en bas de l'écran.

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

  4. À droite de la ligne, ouvrez le menu à développer () et sélectionnez Paramètres d'alerte.

  5. Suivez les instructions à l'écran pour définir le seuil d'alerte et la 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 au tableau de bord Performance Monitoring. Tabulation 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étriques pour laquelle configurer une alerte.

  3. Dans la fiche de métrique souhaitée, ouvrez le menu à développer (). 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 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

Bonnes pratiques pour définir une alerte liée aux performances

Requêtes de réseau

Firebase regroupe les données de requêtes réseau similaires dans des formats d'URL, qui peut être l'un des éléments suivants:

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

  • Les modèles dérivés de Firebase, appelés formats d'URL automatiques.
    Ces tendances peuvent changer au fil du temps en fonction de la dernière utilisation de votre application comportemental.

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

Nous vous recommandons de configurer des alertes pour les formats d'URL personnalisés configuré. Firebase tente de faire correspondre une requête à un format d'URL personnalisé. Premièrement, les requêtes similaires sont mappées de manière plus cohérente sur le même format d'URL. Les alertes associées à un format d'URL personnalisé sont ainsi plus pertinentes et efficaces pour votre équipe, car vous avez déjà identifié ce modèle spécifique de demandes aussi important pour votre application.

Configurer des alertes pour les formats d'URL automatiques

Lorsque vous configurez une alerte de format d'URL automatique, assurez-vous que le paramètre Le format d'URL se stabilise depuis quelques jours. N'oubliez pas que la sélection automatique des URL peuvent changer au fil du temps, et les configurations d'alerte ne sont pas transférées Formats d'URL. Cela pourrait 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 modèle est stable.

Chargement de la page Web

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

Rendus d'écran

Pour une expérience optimale de l'application, les sessions utilisateur ne doivent pas comporter de lenteur et cadres figés. Performance Monitoring vous recommande de configurer des alertes pour les cadres figés supérieure à 1% et que vous avez configuré des alertes pour les images lentes dépassant 5%. Toi ces valeurs sont définies comme paramètres par défaut des alertes liées aux performances. Pour en savoir plus sur la lenteur excessive de cadres figés ou d'autres bonnes pratiques pour améliorer les performances de l'application, consultez Conseils Google Play