Traduit de l'anglais à l'aide de l'IA
Veuillez noter que cet article a été traduit à l'aide de la technologie IA. Bien que nous travaillions à maintenir l'exactitude, certains détails peuvent ne pas refléter parfaitement le texte original. Si vous avez des doutes sur une information, veuillez vous référer à la version anglaise.
Utilisez les Détails de Dépannage des erreurs API pour aider à identifier où l'erreur s'est produite et comment la corriger.
Une fois configuré, vous pouvez :
- Voir les types suivants de détails supplémentaires sur les erreurs API dans le Flux d'Événements de la Relecture de Session :
- Les en-têtes HTTP de la requête et de la réponse
- Le corps (les données envoyées par la requête ou reçues dans la réponse)
- Les éléments du corps (éléments spécifiques du corps de la requête/réponse)
- Les paramètres de requête du point de terminaison de la requête (de l'URL des informations que vous demandez).
- Tirer parti des éléments du corps de réponse non chiffrés dans les Tableaux de Bord & Alertes, le Contexte d'Analyse et le module d'Erreur pour surveiller, identifier et quantifier les erreurs en fonction du contenu du corps de réponse.
Accéder aux Détails de Dépannage
Les Détails de Dépannage des erreurs API peuvent être consultés depuis le lecteur de Relecture de Session.
Accédez facilement au lecteur depuis une erreur API dans :
- Analyse des Erreurs : naviguez vers le panneau latéral de l'erreur API ou consultez la page des détails complets
- Tableaux de Bord et Alertes : faites un clic droit sur un graphique (contenant une métrique d'erreur API)
Une fois sur la relecture :
- Localisez l'Erreur API dans le flux d'événements ou la chronologie.
- Cliquez sur le bouton "Dépanner".
Détails non chiffrés
Tous les détails non chiffrés seront affichés déjà (en-têtes et éléments du corps de la Requête et de la Réponse, sur leurs onglets respectifs).
Détails chiffrés
Avec les Détails de Dépannage chiffrés, tout ce que vous pouvez voir ce sont les clés des éléments d'En-tête et de Corps qui ont été définies dans la règle de collecte de l'erreur sélectionnée. Cependant, toutes les valeurs apparaissent masquées (floues) et doivent être déchiffrées pour être affichées. Suivez les étapes pour déchiffrer ci-dessous :
1. Cliquez sur le bouton "Déchiffrer".
Remarque, vous pouvez également trouver le bouton "Déchiffrer" en survolant et en cliquant sur l'icône de clé dans les paramètres de requête, les en-têtes et les éléments du corps.
2. Entrez votre clé privée et sélectionnez "Déchiffrer".
3. Vous pouvez maintenant voir les détails d'erreur exposés.
Remarque, une fois déchiffré, si vous voyez le message "Non collecté", cela signifie que l'élément n'est pas présent pour l'erreur API sélectionnée.
4. Cliquez sur "Masquer les détails chiffrés" pour réappliquer le chiffrement.
Analyser dans Impact et Error Analysis
Vous pouvez continuer votre analyse dans Impact et Error Analysis directement depuis l'écran de dépannage :
- Erreur API : quantifiez ou voyez l'erreur sélectionnée dans Error Analysis directement depuis le panneau de dépannage, ou depuis le flux d'événements de replay ou la chronologie.
-
Élément du corps de la réponse : quantifiez un élément spécifique du corps de la réponse pour analyse :
Survolez ou sélectionnez/surlignez le JSON dans l'onglet Corps de la réponse et sélectionnez le bouton ‘Quantifier’ pour être redirigé vers Impact.
Utilisation d'un élément du corps de réponse non chiffré
Dans le contexte d'analyse
Lorsque la condition d'erreur est disponible dans le contexte d'analyse, vous pouvez filtrer les données sur les sessions où les utilisateurs ont rencontré une erreur API avec un élément de corps spécifique :
1. Sélectionnez la condition "Erreurs".
2. Sélectionnez "Une erreur API" dans le menu déroulant des erreurs.
3. Remplissez tous les paramètres dont vous avez besoin (page, code d'état, méthode, URL de la requête).
4. Cochez “avec élément du corps de réponse”.
5. Sélectionnez le chemin JSON de l'élément du corps dans la liste extraite de la configuration.
6. Sélectionnez l'un des opérateurs :
- Existe : si vous souhaitez filtrer uniquement sur la présence du chemin JSON
- Égal : si vous souhaitez filtrer sur la valeur exacte
- Contient : si vous souhaitez filtrer sur des valeurs contenant le texte que vous saisissez
7. Appliquez pour enregistrer le paramètre de l'élément du corps.
8. Appliquez la condition de contexte d'analyse.
Dans les tableaux de bord d'erreurs en temps réel
Utiliser l'élément du corps comme filtre
L'élément du corps de réponse non chiffré peut être utilisé comme filtre sur n'importe quel type de widget (sauf "Image") dans les tableaux de bord d'erreurs en temps réel :
1. Créez ou sélectionnez un tableau de bord d'erreurs en temps réel.
2. Ajoutez un nouveau widget ou modifiez un widget existant (assurez-vous qu'il inclut la métrique d'erreur API).
3. La section des filtres apparaît.
4. Sous "Filtres", cliquez sur "+ Ajouter un filtre".
5. Sélectionnez “Élément du corps d'erreur”.
6. Sélectionnez l'un des chemins JSON d'élément du corps de réponse non chiffré collectés dans la liste (provenant des règles créées).
7. Définissez une condition sur la valeur en utilisant l'un des multiples opérateurs, ou laissez-le sur “existe” si vous souhaitez créer la règle sur la présence du JSON.
Grouper par élément de corps dans le widget de tableau de données
Dans le widget de tableau de données pour le tableau de bord des erreurs en temps réel, l'élément de corps de réponse non chiffré peut être utilisé pour grouper les erreurs API par valeurs distinctes d'un chemin JSON sélectionné :
1. Créez ou sélectionnez un Tableau de bord des erreurs en temps réel.
2. Ajoutez un widget.
3. Sélectionnez le type de widget "Tableau de données".
4. Procédez comme d'habitude pour les champs du widget.
5. Assurez-vous de sélectionner une métrique basée sur une erreur API.
6. Dans le champ “Grouper par”, sélectionnez l'un des chemins JSON d'élément de corps de réponse non chiffré collectés dans la liste (provenant des règles créées).
7. Créez le widget.
Vous aurez maintenant un tableau de valeurs distinctes pour un chemin JSON d'élément de corps spécifique trié par ordre décroissant pour obtenir les erreurs les plus impactantes (selon l'image ci-dessous).
Filtrer sur la valeur de l'élément de corps depuis le widget de tableau
Si vous souhaitez analyser les sessions qui ont rencontré une erreur API avec une valeur d'élément de corps spécifique, le moyen le plus simple de construire ce filtre est d'utiliser le raccourci “Appliquer comme un segment” depuis le tableau des widgets listant les différentes valeurs d'un élément de corps.
Une fois cela fait, le contexte d'Analyse sera automatiquement rempli avec la valeur. Il devient alors facile de :
- Analyser ce contexte dans d'autres modules (par exemple, dans l'Impact quantification) car il sera persistant.
- Le sauvegarder en tant que segment afin de pouvoir l'utiliser pour un widget dans un tableau de bord régulier, ou ailleurs.