Descripción general de Trace

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

Trace es una herramienta para solucionar problemas y supervisar proxies de API que se ejecutan en Apigee. Trace te permite sondear los detalles de cada paso a través de un flujo de proxy de API. Apigee te permite recopilar datos de seguimiento, 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 Trace

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

Asistencia de Apigee para el uso de Trace

De forma predeterminada, Apigee permite que la Asistencia de Apigee use la herramienta Trace en los proxies de API para proporcionar asistencia.

Ten en cuenta lo siguiente:

  • La asistencia de Apigee tiene permiso de solo lectura para los datos de Trace.
  • El equipo de asistencia de Apigee puede solicitar que ejecutes un seguimiento para recopilar información sobre un problema y que proporciones el ID de sesión de seguimiento o un vínculo a la sesión de seguimiento para permitirles revisar el seguimiento capturado. Dado que las sesiones de seguimiento guardadas son válidas durante solo 24 horas, te recomendamos que descargues la sesión de seguimiento 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 Trace

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 seguimiento y los transmiten a un Pod de recopilación de datos.
    5. fluentd escribe de inmediato los datos de seguimiento 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 Trace se conservan en el plano de administración durante un máximo de 24 horas.

Requisitos previos

Si utilizas Apigee Hybrid, debes asegurarte de que los siguientes ajustes estén configurados para usar Trace:

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: