Lo strumento di debug offline ti consente di visualizzare e analizzare le sessioni di debug "offline" che sono state
scaricate in precedenza
nella visualizzazione Debug dell'editor proxy. Una
sessione di debug salvata รจ essenzialmente una "registrazione" di una sessione di debug e puรฒ essere utile nei casi
in cui sono necessari la risoluzione dei problemi e ulteriori analisi. L'interfaccia utente dello strumento di debug offline รจ
simile alla visualizzazione Debug nell'editor proxy.
Per informazioni sull'interfaccia utente dello strumento di debug e sul download delle sessioni di debug, consulta Utilizzo di Debug.
UI di Cloud Console
Debug v2 (nuovo)
Per visualizzare i dati di debug scaricati utilizzando il debug offline:
Nota:quando scarichi una sessione di debug nella visualizzazione Debug dell'editor proxy, il nome del file scaricato ha il formato debug-{session ID}.json, dove {session id} รจ l'ID della sessione di debug. Tuttavia, puoi rinominare il file se vuoi.
L'interfaccia utente di Apigee carica i dati del file di debug e mostra tutte
le transazioni nell'elenco nel riquadro Transazioni.
Fai clic sulla riga della transazione nel riquadro Transazioni
per visualizzarla nella Mappa delle transazioni.
Da qui, puoi esplorare la sessione di debug come faresti per
una sessione di debug appena creata. Per saperne di piรน, consulta
Creazione di una sessione di debug.
Debug v1
Per visualizzare i dati di debug scaricati utilizzando il debug offline:
Seleziona Proxy API dalla visualizzazione principale.
Seleziona Sviluppa > Debug offline.
La visualizzazione Debug offline mostra:
Per caricare i dati nella visualizzazione Debug offline, fai clic sul
pulsante Apri sessione di debug
e seleziona un file di sessione di debug offline scaricato in precedenza
in formato JSON.
Nota:quando scarichi una sessione di debug nella visualizzazione Debug dell'editor proxy,
il nome del file di download ha il formato "debug-{session ID}.json", dove {session id}
รจ l'ID della sessione di debug. Tuttavia, se vuoi, puoi rinominare il file.
La UI di Apigee carica i dati del file di debug e visualizza una nuova riga per la transazione
nel riquadro a sinistra.
Fai clic sulla riga della transazione nel riquadro a sinistra per visualizzare un grafico di Gantt della transazione.
Da qui, puoi esplorare la sessione di debug proprio come faresti nella
visualizzazione Debug nel nuovo
editor proxy. Consulta la sezione "Visualizzazione del diagramma di Gantt per una richiesta e una risposta".
UI classica
Per visualizzare i dati di debug scaricati utilizzando il debug offline:
Seleziona Proxy API dalla visualizzazione principale.
Seleziona Sviluppa > Debug offline.
La visualizzazione Debug offline mostra:
Tieni presente le seguenti regioni della visualizzazione Debug offline:
File di debug:mostra il tipo di richiesta. Utilizza questa area per navigare tra le
richieste.
Opzioni di visualizzazione:mostra le opzioni di configurazione, come descritto in
Utilizzo di Debug.
Dettagli sessione di debug:mostra i dettagli della sessione di debug.
Mappa delle transazioni:mostra il percorso della richiesta tramite il proxy API. Questo
percorso รจ noto come mappa delle transazioni. Mostra le norme incontrate e
indica se si sono verificati errori durante l'esecuzione di queste norme.
Dettagli fase: mostra le intestazioni della richiesta attualmente selezionata.
Quando visualizzi i dati di debug nella UI di Apigee, puoi attivare/disattivare varie opzioni, ad esempio se visualizzare
i criteri disattivati o le variabili e le proprietร . Per saperne di piรน, consulta la sezione
Debug con lo strumento di debug.
Per caricare i dati nella visualizzazione Debug offline, fai clic sul
pulsante Scegli file nel riquadro a sinistra dello strumento Debug offline
e seleziona un file di sessione di traccia offline scaricato in precedenza in formato JSON.
Nota:non utilizzare il pulsante Scegli file nel riquadro a destra,
in quanto non accetta file JSON.
La UI di Apigee carica i dati del file di debug e li visualizza.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema รจ stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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."]]
