Descripción general de la depuración

Estás viendo la documentación de Apigee X.
Consulta la documentación de Apigee Edge.

La depuración es una herramienta para solucionar problemas y supervisar proxies de API que se ejecutan en Apigee. La herramienta de depuración te permite sondear los detalles de cada paso a través de un flujo de proxy de API. Apigee te permite recopilar 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/respuesta, junto con las transformaciones que se aplican en el momento de la ejecución de la política. Esto es importante para depurar y solucionar problemas durante el desarrollo y la implementación de proxy de API.

Usa la depuración

Crea y administra sesiones de depuración con la herramienta de depuración mediante la IU o API, como se describe en Usa la depuración. Como alternativa, puedes descargar sesiones de depuración, verlas y analizarlas sin conexión, como se describe en Usa la depuración sin conexión.

Asistencia de Apigee para el uso de la depuración

By default, Apigee allows Apigee Support to use the Debug tool on your API proxies to provide support.

Note the following:

  • Apigee Support has read-only permission to Debug data.
  • Apigee Support may request that you run a trace to capture information about an issue, and that you provide the trace session ID or a link to the trace session so that Support may review the captured trace. Since saved trace sessions are valid for only 24 hours, we recommend that you download the trace session and attach it to the case opened with Support to enable offline viewing.

Para usuarios híbridos de Apigee

Si usas Apigee Hybrid, revisa las siguientes secciones.

Arquitectura de depuración

A continuación, se ilustra el proceso de creación de una sesión de depuración nueva:

Vista de alto nivel de una solicitud para iniciar una sesión de depuración:1. Inicias una solicitud para iniciar una sesión de depuración mediante la IU o la API.
    2. El plano de administración emite una solicitud de creación de sesión de depuración en el plano del entorno de ejecución mediante el modelo de Pub/Sub.
    3. Synchronizer, que se suscribe a las notificaciones de sesión, propaga la solicitud de creación a Message Processor.
    4. Los MP recopilan datos de depuración y los transmiten a un Pod de recopilación de datos.
    5. fluentd escribe de inmediato los datos de depuración en el sistema de archivos del Pod.
    6. UDCA consulta el sistema de archivos del Pod para encontrar nuevos archivos de datos.
    7. Cuando se encuentra un archivo de datos nuevo, UDCA lo sube al servicio de UAP.
    8. A continuación, puedes acceder a los datos mediante los servicios de Apigee, como la IU de Apigee Hybrid o las API de Apigee.

Los datos de depuración se conservan en el plano de administración durante un máximo de 24 horas.

Requisitos previos

Si usas Apigee Hybrid, antes de poder usar la depuración, debes asegurarte de que se hayan configurado los siguientes elementos:

Cuentas de servicio:

  • apigee-synchronizer (función: Administrador de Apigee Synchronizer)
  • apigee-udca (función: agente de Apigee Analytics)

Para obtener más información sobre la versión híbrida 1.3, consulta Crea cuentas de servicio en tu plataforma de la siguiente manera:

Synchronizers: