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 d'erreur d'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 d'erreur d'API dans le flux d'événements de la révision 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 de corps de réponse non chiffrés dans les dashboards et Alerts d'Erreurs, 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 d'erreur d'API peuvent être accédés depuis le lecteur de révision de session.
Accédez facilement au lecteur depuis une erreur d'API dans :
- Analyse d'erreur : naviguez vers le panneau latéral de l'erreur d'API ou consultez la page des détails complets
- Dashboards et Alerts : faites un clic droit sur un graphique (contenant une métrique d'erreur d'API)
Une fois sur la révision :
- Localisez l'erreur d'API depuis 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 de 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éfinis 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 de 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 d'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 d'API : quantifier ou voir 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 : quantifier un élément spécifique du corps de la réponse pour l'analyse :
Survolez ou sélectionnez/soulignez le JSON dans le corps de l'onglet Réponse et sélectionnez le bouton ‘Quantifier’ pour être redirigé vers Impact.
Utiliser 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 d'API avec un élément de corps spécifique :
1. Sélectionnez la condition "Erreurs".
2. Sélectionnez "Une erreur d'API" dans le menu déroulant des erreurs.
3. Remplissez tout paramètre 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 les 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 dashboards 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 dashboards d'erreurs en temps réel :
1. Créez ou sélectionnez un dashboard d'erreurs en temps réel.
2. Ajoutez un nouveau widget ou modifiez un existant (assurez-vous qu'il inclut la métrique d'erreur d'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 de corps de réponse non chiffrés 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-la 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 dashboard d'erreurs en temps réel, l'élément de corps de réponse non chiffré peut être utilisé pour grouper les erreurs d'API par valeurs distinctes d'un chemin JSON sélectionné :
1. Créez ou sélectionnez un Dashboard d'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 d'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 d'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 segment” depuis le tableau de widget 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. Ensuite, il devient facile de :
- Analyser ce contexte dans d'autres modules (par ex. dans l'Impact Quantification) car il sera persistant.
- Enregistrer cela comme un segment afin que vous puissiez l'utiliser pour un widget dans un dashboard régulier, ou ailleurs.