La page API Request du module Browser Monitoring surveille chaque appel d'API effectué par votre application web. Utilisez-la pour identifier les endpoints lents, les requêtes en échec et les motifs d'erreur avant qu'ils n'impactent vos utilisateurs.
| Problème | Où chercher |
|---|---|
| Quelles API sont en échec ? | Onglet Success Rate : classe les endpoints par taux de succès afin de mettre en évidence les API peu fiables. |
| Quelles erreurs sont renvoyées ? | Onglet Message : regroupe les appels d'API par message de réponse, triés par volume. |
| Quelles API réussies sont les plus lentes ? | Onglet Success RT : classe les endpoints selon le temps de réponse moyen (RT) des appels ayant abouti. |
| Les échecs sont-ils également lents ? | Onglet Failure RT : affiche le temps de réponse moyen des appels en échec ainsi que leur volume. |
| Le problème est-il régional ou spécifique à un appareil ? | Sections Geographical View, Terminal View et Version View : ventilent toutes les métriques par emplacement géographique, navigateur, système d'exploitation, appareil, résolution et version de l'application. |
Métriques
La page API Request présente quatre métriques principales pour chaque endpoint d'API supervisé :
Success rate : pourcentage d'appels renvoyant une réponse positive.
Response messages : messages de réponse renvoyés par chaque API, classés par volume d'appels.
Average RT for successful calls : durée moyenne nécessaire à l'exécution des requêtes ayant abouti.
Average RT for failed calls : durée moyenne écoulée avant le renvoi d'une erreur pour les requêtes en échec.
Ces quatre métriques peuvent être ventilées selon six dimensions : emplacement géographique, navigateur, système d'exploitation, appareil, résolution et version.
Examiner les taux de succès des API
L'onglet Success Rate situé à gauche classe toutes les API supervisées en fonction de leur taux de succès.
Sélectionnez une API pour afficher :
Le panneau API Success Rate (à droite) : un graphique chronologique présentant le volume d'appels et le taux de succès sur la plage horaire sélectionnée.
Le panneau API Link Trace (TOP 20) (à droite) : les 20 traces d'échec et de succès principales pour cette API. Cliquez sur Link Trace dans la colonne Actions pour inspecter la trace distribuée. Cliquez sur View Details pour consulter l'intégralité des données de la requête et de la réponse.
Les détails de trace relient les appels d'API frontend au traitement backend. Cette fonctionnalité permet de déterminer si un problème provient du code côté client, de la latence réseau ou du service backend. Si le taux de succès d'une API chute soudainement, examinez les traces en échec pour vérifier l'existence de délais d'attente backend, d'erreurs d'authentification ou de codes d'état inattendus.
Analyser les messages de réponse des API
L'onglet Message situé à gauche regroupe toutes les réponses d'API par message de réponse et les classe par volume total d'appels.
Sélectionnez un message pour ouvrir le panneau Message Request Details à droite. Ce panneau répertorie tous les appels d'API ayant renvoyé ce message, triés par volume d'appels décroissant.
Si un seul message d'erreur domine la liste, il constitue votre cible de débogage prioritaire.
Vérifier le temps de réponse des appels réussis
L'onglet Success RT situé à gauche classe les API selon le temps de réponse moyen des appels ayant abouti.
Sélectionnez une API pour afficher le panneau Success API Response Time à droite, qui indique :
Un graphique linéaire représentant le temps de réponse moyen dans le temps.
Un histogramme indiquant le volume total d'appels réussis dans le temps.
Mettez en corrélation le temps de réponse avec le volume d'appels afin de distinguer les ralentissements réels des valeurs aberrantes liées à un faible trafic. Une augmentation soudaine du temps de réponse accompagnée d'un volume d'appels élevé signale généralement un véritable problème de performance.
Vérifier le temps de réponse des appels en échec
L'onglet Failure RT situé à gauche classe les API selon le temps de réponse moyen des appels en échec.
Sélectionnez une API pour afficher le panneau Failure API Response Time à droite, qui indique :
Un graphique linéaire représentant le temps de réponse moyen des appels en échec dans le temps.
Un histogramme indiquant le volume total d'appels en échec dans le temps.
Un temps de réponse élevé pour les appels en échec pointe souvent vers des délais d'attente backend plutôt que vers des erreurs client à retour rapide. Comparez ces données avec l'onglet Message pour vérifier si les échecs lents sont corrélés à des messages d'erreur spécifiques.
Ventiler les métriques par emplacement
La section Geographical View ventile les métriques des API en fonction de l'emplacement des utilisateurs. Deux onglets sont disponibles :
China View : statistiques agrégées par province en Chine.
World View : statistiques agrégées par pays ou région dans le monde entier.
Utilisez cette vue pour identifier les problèmes de performance ou de fiabilité spécifiques à une région, qui peuvent indiquer des problèmes au niveau du CDN, du DNS ou du réseau.
Ventiler les métriques par terminal
La section Terminal View ventile les métriques des API en fonction de l'environnement client. Quatre onglets sont disponibles :
| Onglet | Contenu affiché |
|---|---|
| Browser | Métriques groupées par type de navigateur (Chrome, Firefox, Safari, etc.) |
| OS | Métriques groupées par système d'exploitation |
| Device | Métriques groupées par type d'appareil |
| Resolution | Métriques groupées par résolution d'écran |
Si les échecs ou les réponses lentes se concentrent autour d'un navigateur ou d'un système d'exploitation spécifique, le problème peut être lié à la compatibilité du SDK ou au comportement de l'API propre au navigateur.
Ventiler les métriques par version
La section Version View présente les métriques groupées par version de l'hôte et version de l'application.
Comparez la version actuelle aux versions précédentes après un déploiement afin de confirmer si une nouvelle release a introduit des régressions en matière de performance ou de fiabilité.
Commandes de la page
Ces commandes sont disponibles dans tous les onglets de la page API Request :
Trier les listes : dans n'importe quel onglet de gauche, cliquez sur l'icône de flèche pour basculer entre l'ordre croissant et décroissant.
-
Basculer entre les vues graphique et tableau : dans n'importe quel panneau de droite, cliquez sur l'icône de liste située dans le coin supérieur droit pour passer de la vue graphique à la vue tableau, et inversement.
-
Définir une plage horaire personnalisée : dans n'importe quel panneau de droite, cliquez sur l'icône d'horloge située dans le coin supérieur droit pour sélectionner une plage horaire spécifique pour les données affichées.
