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

Solo los clientes pueden activar una sesión de depuración, pero la asistencia de Apigee puede acceder a las sesiones de depuración anteriores que no se borraron durante el curso de un caso de asistencia para ayudar a solucionar problemas específicos del proxy.

Ten en cuenta lo siguiente:

  • El equipo de asistencia de Apigee tiene permiso de solo lectura para los datos de depuración.
  • La Asistencia de Apigee puede solicitar que ejecutes una depuración para capturar información sobre un problema y que proporciones el ID de la sesión de depuración o un vínculo a la sesión de depuración para que la asistencia pueda revisar la depuración capturada. Dado que las sesiones de depuración guardadas son válidas durante solo 24 horas, te recomendamos que descargues la sesión de depuración y la adjuntes al caso abierto con el equipo de asistencia para habilitar la visualización sin conexión.

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: