Debug es una herramienta para solucionar problemas y monitorizar proxies de API que se ejecutan en Apigee. La herramienta Depuración te permite comprobar los detalles de cada paso de un flujo de proxy de API.
Apigee te permite recoger datos de depuración, que muestran todo el flujo de solicitud/respuesta de tus proxies de API. Esto incluye todos los parámetros de solicitud y respuesta, así como las transformaciones que se les aplican en el momento de la ejecución de la política. Esto es importante para depurar y solucionar problemas durante el desarrollo y el despliegue de proxies de API.
Recogida y transmisión de datos de depuración
Los nodos de la pasarela de Apigee recogen datos de sesiones de depuración y los almacenan en caché internamente antes de transmitirlos al plano de control en la nube. Desde ahí, se comparte con la interfaz de usuario de la sesión de depuración para que los operadores puedan analizarla.
Si usas Enmascaramiento de depuración,
Apigee realiza el enmascaramiento en los nodos de la pasarela antes de transmitir los datos de depuración al
plano de control.
Usar la depuración
Crea y gestiona sesiones de depuración con la herramienta Depuración mediante la interfaz de usuario o la API, tal como se describe en el artículo Usar Depuración.
También puedes descargar sesiones de depuración y verlas y analizarlas sin conexión, tal como se describe en Usar la depuración sin conexión.
Uso de la depuración por parte del equipo de Asistencia de Apigee
Solo los clientes pueden activar una sesión de depuración, pero el equipo de Asistencia de Apigee puede acceder a sesiones de depuración anteriores no eliminadas durante el transcurso de un caso de asistencia para ayudar a solucionar problemas específicos de un proxy.
Ten en cuenta lo siguiente:
El equipo de Asistencia de Apigee tiene permiso de solo lectura para acceder a los datos de depuración.
El equipo de Asistencia de Apigee puede pedirte que ejecutes una depuración para obtener información sobre un problema y que proporciones el ID de la sesión de depuración o un enlace a ella para que pueda revisar la depuración capturada. Como las sesiones de depuración guardadas solo son válidas durante 24 horas, te recomendamos que descargues la sesión de depuración y la adjuntes al caso que hayas abierto con el equipo de Asistencia para poder verla sin conexión.
Para usuarios de Apigee Hybrid
Si usas Apigee hybrid, consulta las siguientes secciones.
Arquitectura de depuración
En la siguiente imagen se ilustra el proceso de creación de una sesión de depuración:
Los datos de depuración se conservan en el plano de gestión durante un máximo de 24 horas.
Requisitos de Apigee Hybrid
En esta sección se muestra información importante para los usuarios de Apigee Hybrid.
[[["Es fácil de entender","easyToUnderstand","thumb-up"],["Me ofreció una solución al problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Es difícil de entender","hardToUnderstand","thumb-down"],["La información o el código de muestra no son correctos","incorrectInformationOrSampleCode","thumb-down"],["Me faltan las muestras o la información que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-11 (UTC)."],[[["\u003cp\u003eThe Debug tool in Apigee and Apigee hybrid allows users to troubleshoot and monitor API proxies by providing detailed insights into each step of an API proxy flow.\u003c/p\u003e\n"],["\u003cp\u003eDebug data, which captures the entire request/response flow and transformations, is crucial for debugging during API proxy development and deployment.\u003c/p\u003e\n"],["\u003cp\u003eApigee Support can access past debug sessions to assist in troubleshooting proxy issues, although they have read-only permissions.\u003c/p\u003e\n"],["\u003cp\u003eFor Apigee hybrid v1.13.1 and later, the Debug tool is supported for new organizations with data residency enabled.\u003c/p\u003e\n"],["\u003cp\u003eDebug data is not available in real-time, and is saved for 24 hours.\u003c/p\u003e\n"]]],[],null,["*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\n| **Note:** For Apigee hybrid v1.13.1, the new data pipeline is supported for newly created Apigee hybrid organizations with [data residency](/apigee/docs/api-platform/get-started/drz-concepts) enabled. See [Configure hybrid to use the new data pipeline](/apigee/docs/hybrid/v1.13/data-collection-with-data-residency). For Hybrid 1.14 or later, the new data pipeline is the default for all Hybrid organizations regardless of whether or not data residency is enabled.\n\nDebug is a tool for troubleshooting and monitoring API proxies running on Apigee. The Debug tool\nlets you probe the details of each step\nthrough an API proxy flow.\nApigee lets you collect debug data, which shows the entire request/response flow of your\nAPI proxies. This includes all request/response parameters along with transformations applied to\nthem at policy execution time. This is important for debugging and troubleshooting during API proxy development and deployment.\n| In previous versions of Apigee, the Debug tool was referred to as the Trace tool.\n| **Terminology:** The terms *debug data* and *debug\n| session data* are used interchangeably.\n\nDebug data collection and transmission\n\nApigee gateway nodes collect debug session data and cache it internally,\nbefore transmitting that data to the control plane in the Cloud. From there it\nis shared to the debug session UI, for operators to analyze.\n\nIf you use [Debug masking](/apigee/docs/api-platform/security/data-masking),\nApigee performs the masking in the gateway nodes, before transmitting the debug data to the\ncontrol plane.\n\nUsing Debug\n\n\nCreate and manage debug sessions using the Debug tool using the UI or API, as described in\n[Using Debug](/apigee/docs/api-platform/debug/trace).\nAlternatively, you can download debug sessions and view and analyze them offline, as described in\n[Using Offline Debug](/apigee/docs/api-platform/debug/offline-trace).\n\nApigee Support use of Debug\n\n\nOnly customers can trigger a debug session, but Apigee Support can access non-deleted past debug sessions\nduring the course of a support case to help troubleshoot proxy-specific issues.\n\n\nNote the following:\n\n- Apigee Support has read-only permission to Debug data.\n- Apigee Support may request that you run a debug to capture information about an issue, and that you provide the debug session ID or a link to the debug session so that Support may review the captured debug. Since saved debug sessions are valid for only 24 hours, we recommend that you download the debug session and attach it to the case opened with Support to enable offline viewing.\n\nFor Apigee hybrid users **Note:** For Apigee hybrid v1.13.1 and later, the Debug tool is supported for newly created Apigee hybrid organizations with [data residency](/apigee/docs/api-platform/get-started/drz-concepts) enabled. See [Analytics and debug data collection with data residency](/apigee/docs/hybrid/v1.13/data-collection-with-data-residency).\n\n\nIf you are using Apigee hybrid, review the following sections.\n\nDebug architecture\n\nThe following illustrates the process of creating a new debug session:\n\n| **Note:** Because of the asynchronous nature of multiple pollings, debug data is not available in real time; instead, there is a slight delay.\n\nDebug data is persisted in the management plane for up to 24 hours.\n\nApigee hybrid requirements\n\nThis section lists important information for Apigee hybrid users.\n\nSupport for data residency\n\n- If you have a newly created Apigee hybrid v1.13.1 org with [data residency enabled](/apigee/docs/api-platform/get-started/drz-concepts), follow the steps in [Using data residency with Apigee hybrid](/apigee/docs/hybrid/v1.13/using-data-residency-with-apigee-hybrid).\n- Clocks on all Synchronizer nodes should be in sync and in UTC.\n\nOlder versions of Apigee hybrid do not support data residency.\n\nOther requirements\n\n- You must have the `apigee-udca` service account configured. See [Specify configuration overrides](./install-create-overrides#specify-configuration-overrides).\n- Clocks on all Synchronizer nodes should be in sync and in UTC."]]