L'outil de débogage hors connexion vous permet d'afficher et d'analyser les sessions de débogage "hors connexion" téléchargées précédemment dans la vue Débogage de l'éditeur de proxy. = Une session de débogage sauvegardée est essentiellement un "enregistrement" d'une session de débogage. Elle peut être utile dans les cas où un dépannage et une analyse plus approfondie sont nécessaires. L'interface utilisateur de l'outil de débogage hors connexion est semblable à la vue Débogage de l'éditeur de proxy.
Pour en savoir plus sur l'interface utilisateur de l'outil Debug et sur le téléchargement des sessions de débogage, consultez la section Utiliser Debug.
Interface utilisateur de la console Cloud
Déboguer v2 (nouveau)
Pour afficher les données de débogage téléchargées à l'aide d'Offline Debug, procédez comme suit :
Pour charger des données dans la vue Débogage hors connexion, cliquez sur Ouvrir la session de débogage, sélectionnez un fichier de session de débogage hors connexion
précédemment téléchargé au format JSON, puis cliquez sur Ouvrir.
Remarque : Lorsque vous téléchargez une session de débogage dans la vue Débogage de l'éditeur de proxy, le nom du fichier téléchargé se présente sous la forme debug-{session ID}.json, où {session id} correspond à l'ID de la session de débogage. Toutefois, vous pouvez renommer le fichier si vous le souhaitez.
L'interface utilisateur Apigee charge les données du fichier de débogage et affiche toutes les transactions de la liste dans le panneau Transactions.
Cliquez sur la ligne correspondant à la transaction dans le panneau Transactions pour afficher la transaction dans la carte des transactions.
Vous pouvez ensuite explorer la session de débogage comme vous le feriez pour une session de débogage nouvellement créée. Pour en savoir plus, consultez
Créer une session de débogage.
Déboguer v1
Pour afficher les données de débogage téléchargées à l'aide d'Offline Debug, procédez comme suit :
Pour charger des données dans la vue Débogage hors connexion, cliquez sur le bouton Ouvrir la session de débogage, puis sélectionnez un fichier de session de débogage hors connexion précédemment téléchargé au format JSON.
Remarque : Lorsque vous téléchargez une session de débogage dans la vue Débogage de l'éditeur de proxy, le nom du fichier de téléchargement se présente sous la forme "debug-{session ID}.json", où "{session id}" correspond à l'ID de la session de débogage. Toutefois, vous pouvez renommer le fichier si vous le souhaitez.
L'interface utilisateur Apigee charge les données du fichier de débogage et affiche une nouvelle ligne pour la transaction dans le panneau de gauche.
Cliquez sur la ligne correspondant à la transaction dans le panneau de gauche pour afficher un graphique de Gantt de la transaction.
Vous pouvez ensuite explorer la session de débogage comme vous le feriez dans la vue Débogage du nouvel éditeur de proxy. Consultez la section "Afficher le graphique de Gantt pour une requête et une réponse".
UI classique
Pour afficher les données de débogage téléchargées à l'aide d'Offline Debug, procédez comme suit :
Notez les régions suivantes de la vue Offline Debug :
Debug file (Fichier Debug) : affiche le type de requête. Utilisez cette zone pour parcourir les requêtes.
View Options (Options d'affichage) : affiche les options de configuration, comme décrit dans la section Utiliser Debug.
Debug Session Details (Détails de la session Debug) : affiche les détails de la session de débogage.
Transactions Map (Mappage de transactions) : indique le chemin de la requête via le proxy d'API. Ce chemin est appelé mappage de transactions. Il montre les règles rencontrées et indique si des erreurs se sont produites lors de leur exécution.
Phase Details (Détails de la phase) : affiche les en-têtes de requête pour la requête actuellement sélectionnée.
Lorsque vous affichez des données de débogage dans l'UI Apigee, vous pouvez activer/désactiver diverses options, par exemple afficher ou non les règles désactivées, ou les variables et propriétés. Pour en savoir plus, consultez Déboguer avec l'outil de débogage.
Pour charger des données dans la vue Offline Debug, cliquez sur le bouton Sélectionner un fichier dans le volet de gauche de l'outil Offline Debug, puis sélectionnez un fichier de session Trace au format JSON hors connexion téléchargé précédemment.
Remarque : N'utilisez pas le bouton Sélectionner un fichier dans le volet de droite, car il n'accepte pas les fichiers JSON.
L'interface utilisateur d'Apigee charge les données du fichier de débogage et les affiche :
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/19 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/19 (UTC)."],[[["\u003cp\u003eThe Offline Debug tool in Apigee and Apigee hybrid allows users to view and analyze previously downloaded debug sessions.\u003c/p\u003e\n"],["\u003cp\u003eUsers can access the Offline Debug tool via the Google Cloud console (Debug v1 or v2) or the Classic UI, with similar navigation structures across platforms.\u003c/p\u003e\n"],["\u003cp\u003eTo load a debug session in the Offline Debug tool, users must select a downloaded JSON file (typically named \u003ccode\u003edebug-{session ID}.json\u003c/code\u003e) via the "Open Debug Session" or "Choose File" button.\u003c/p\u003e\n"],["\u003cp\u003eOnce a debug session is loaded, users can explore the transaction details, including the transaction map and phase details, to troubleshoot and analyze API proxy behavior.\u003c/p\u003e\n"],["\u003cp\u003eThe Offline debug tool allows for analysis and debugging to occur even when the debug session is not actively running.\u003c/p\u003e\n"]]],[],null,["# Using Offline Debug\n\n*This page\napplies to **Apigee** and **Apigee hybrid**.*\n\n\n*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*\n\nThe Offline Debug tool lets you view and analyze \"offline\" debug sessions that were\n[previously downloaded](/apigee/docs/api-platform/debug/trace#downloading-a-debug-session)\nin the **Debug** view in the Proxy Editor. A\nsaved debug session is essentially a \"recording\" of a debug session, and can be useful for cases\nwhere troubleshooting and further analysis is required. The UI for the Offline Debug tool is\nsimilar to the **Debug** view in the Proxy Editor.\n\nTo learn about the Debug Tool UI and on downloading debug\nsessions, see [Using Debug](/apigee/docs/api-platform/debug/trace).\n**Note:** The Debug Tool is available in the Google Cloud console, the Classic UI, and some debug actions can be performed using the API as described in the following tabs. The Google Cloud console options are Debug v2 (new) and Debug v1 (released [07/01/2022](/apigee/docs/api-platform/release-notes#July_01_2022)). You can switch between versions of the Debug Tool in the Google Cloud console and the Classic UI. \n\n### Cloud Console UI\n\n### Debug v2 (new)\n\nTo view downloaded debug data using Offline Debug:\n\n1. Sign in to the [Google Cloud console](https://console.cloud.google.com/apigee).\n2. Select **Develop \\\u003e Offline Debug**.\n\n The **Offline Debug** view displays:\n3. To load data into the **Offline Debug** view, click\n **Open Debug Session** , select a\n [previously downloaded](/apigee/docs/api-platform/debug/trace#download) offline debug session file in JSON format,\n and then click **Open**.\n\n **Note:** When you download a debug session in the Proxy Editor\n **Debug** view, the name of the download file has the form\n `debug-{session ID}.json`, where `{session id}`\n is the ID of the debug session; however, you can rename the file\n if you wish.\n\n The Apigee UI loads the debug file's data and displays all of\n the transactions in the list in the **Transactions** panel.\n4. Click the row for the transaction in the **Transactions** panel to display the transaction in the **Transaction Map** .\n\nFrom here, you can explore the debug session just as you would for\na newly-created debug session. See\n[Creating a debug session](/apigee/docs/api-platform/debug/trace#creating-a-debug-session) for more information.\n\n### Debug v1\n\nTo view downloaded debug data using Offline Debug:\n\n1. Sign in to the [Google Cloud console](https://console.cloud.google.com/apigee).\n2. Select **API Proxies** from the main view.\n3. Select **Develop \\\u003e Offline Debug**.\n\n The **Offline Debug** view displays:\n\n4. To load data into the **Offline Debug** view, click the\n **Open Debug Session** button\n and select a [previously downloaded](/apigee/docs/api-platform/debug/trace#download)\n offline debug session file in JSON format.\n\n **Note:** When you download a debug session in the Proxy Editor **Debug** view,\n the name of the download file has the form 'debug-{session ID}.json', where {session id}\n is the ID of the debug session. However, you can rename the file if you wish.\n\n The Apigee UI loads the debug file's data and displays a new row for the transaction\n in the left-hand panel.\n\n5. Click the row for the transaction in the left-hand panel to display a Gantt chart of the transaction in a Gantt chart.\n\nFrom here, you can explore the debug session just as you would in the\n[**Debug** view in the new\nProxy Editor](/apigee/docs/api-platform/debug/trace#new-proxy-editor). See the section \"Viewing the Gantt chart for a request and response.\"\n\n### Classic UI\n\nTo view downloaded debug data using Offline Debug:\n\n1. Sign in to the [Apigee UI](https://apigee.google.com).\n2. Select **API Proxies** from the main view.\n3. Select **Develop \\\u003e Offline Debug**.\n\n The **Offline Debug** view displays:\n\n Note the following regions of the **Offline Debug** view:\n - **Debug file:** Displays the request type. Use this area to navigate among the requests.\n - **View Options:** Displays configuration options, as described in [Using Debug](/apigee/docs/api-platform/debug/trace).\n - **Debug Session Details:** Displays details about the debug session.\n - **Transactions Map:** Shows the path of the request through the API proxy; this path is known as the *transaction map*; it shows which policies were encountered and indicates if any errors occurred during the execution of those policies.\n - **Phase Details:** Shows the request headers for the currently selected request.\n\n When viewing debug data in the Apigee UI, you can toggle various options such as whether to\n view policies that are disabled or variables and properties. For more information, see\n [Debugging with the debug tool](/apigee/docs/api-platform/debug/trace#debuggingwithtrace).\n4. To load data into the **Offline Debug** view, click the\n **Choose File** button in the left-hand pane of the Offline Debug tool\n and select a previously downloaded offline trace session file in JSON format.\n\n **Note:** Do *not* use the **Choose File** button in the right-hand pane,\n as it does not accept JSON files.\n\n The Apigee UI loads the debug file's data and displays it."]]
