Afficher les données d'un message avec la vue Debug

Cette page s'applique à Apigee et à Apigee hybrid.

Consultez la documentation d' Apigee Edge.

Points abordés

Dans ce tutoriel, vous allez apprendre à effectuer les opérations suivantes :

• Consulter les en-têtes et le contenu du corps de la réponse.
• Afficher les messages d'erreur.

Prérequis

Avant de commencer ce tutoriel, procédez comme suit :

• Assurez-vous que curl est installé sur votre ordinateur pour effectuer des appels d'API à partir de la ligne de commande.
• Suivez les étapes de la section Avant de commencer.
• Ajoutez une règle SpikeArrest à votre proxy. La règle SpikeArrest est une règle qui limite le nombre de requêtes pouvant être envoyées à votre proxy d'API. Votre proxy doit comporter au moins une règle.

Afficher les données du message

La vue Debug de l'éditeur de proxys Apigee vous permet d'afficher les en-têtes, les variables, les objets et d'autres détails tels que le temps de réponse dans le flux de requêtes et de réponses du proxy d'API. La vue Debug vous permet également de voir comment une requête ou une réponse change lorsqu'elle est traitée par un proxy d'API. Pour obtenir une description plus détaillée de la vue Debug, consultez Utiliser la vue Debug.

Cette page explique comment utiliser la vue Debug pour voir ce qui se passe lorsque le taux de la règle SpikeArrest est dépassé.

Remarque : L'outil Debug est disponible dans l'UI Apigee. Certaines actions de débogage peuvent être effectuées à l'aide de l'API, comme décrit dans les onglets suivants.

Pour utiliser la vue "Debug" dans l'UI Apigee afin de voir ce qui se passe lorsque le taux de la règle SpikeArrest est dépassé :

1. Dans la console Google Cloud , accédez à la page Développement de proxys > Proxys d'API.

   Accéder aux proxys d'API

2. Assurez-vous que le nom de votre organisation est sélectionné dans le sélecteur de projet du volet de la console  Google Cloud . Le nom de l'organisation est identique à celui de votre projet Google Cloud .
3. Cliquez sur le nom du proxy d'API que vous souhaitez déboguer.
4. Cliquez sur l'onglet Develop (Développer).
5. Cliquez sur la règle Règles > SpikeArrest.
6. Dans le volet "Modifier", remplacez Rate (Tarif) par 1pm (1 €/min).
7. Cliquez sur Enregistrer.Cela vous permettra d'afficher les appels d'API ayant réussi et ceux ayant échoué (au-delà de la limite).
8. Déployez le proxy mis à jour.
9. Cliquez sur l'onglet Debug (Débogage).
10. Cliquez sur Démarrer une session de débogage.

    Dans la boîte de dialogue :

    1. Sélectionnez l'environnement dans lequel vous souhaitez exécuter la session de débogage.

    2. (Facultatif) Dans la liste Filtre, sélectionnez un filtre à appliquer à toutes les transactions de la session de débogage que vous créez. La valeur par défaut est None (All transactions) (Aucun), qui inclut toutes les transactions des données de débogage.

       Pour plus d'informations sur l'utilisation des filtres, consultez Utiliser des filtres dans une session de débogage. Pour en savoir plus sur les filtres intégrés, consultez Utiliser des filtres prédéfinis.

    3. Cliquez sur Démarrer.

11. Appelez à nouveau le proxy d'API à l'aide de curl (ou avec l'URL dans un navigateur Web) plusieurs fois jusqu'à ce que vous voyiez au moins une réponse 200 et une réponse 429 dans le volet Transactions.

    
    Remarque : Le code d'état HTTP pour le dépassement de la limitation du débit est 429 Too many requests.

12. Cliquez sur une transaction 429. Dans le volet Carte des transactions, un schéma de flux s'affiche, y compris une règle SpikeArrest avec une icône d'erreur.

    

13. Cliquez sur l'icône Erreur. Le volet Propriétés de l'erreur s'affiche.

    

Vous pouvez cliquer sur les boutons Précédent et Suivant pour vous déplacer entre les étapes du flux et afficher les détails de chaque étape.

Pour télécharger l'intégralité de la session de débogage en un seul document, cliquez sur Télécharger la session. Une session de débogage est supprimée dans les 24 heures suivant sa fin. Par conséquent, si vous souhaitez afficher la session au-delà de cette période, vous devez la télécharger avant.