API de depuración

Gracias a la compatibilidad con Trace API, puede supervisar el ciclo de vida completo de las solicitudes en tiempo de ejecución dentro de webMethods API Gateway. Puede realizar el seguimiento de cualquier solicitud en tiempo de ejecución. La inspección de las solicitudes fallidas en tiempo de ejecución le ayuda a depurar y solucionar problemas de sus llamadas a la API. Sólo puede rastrear las llamadas a las API REST, SOAP y OData.

Al activar el rastreador para una API, puede ver la lista de solicitudes en tiempo de ejecución que invocaron la API. Para cada solicitud, puede ver los siguientes detalles.

  • La lista de políticas que se invocaron en cada etapa.
  • Tiempo de ejecución de la etapa y sus correspondientes políticas.
  • Política configurada en el momento de la invocación.
  • Valores que se pasaron como entrada antes de la ejecución de las políticas y valores que se transformaron al final de la ejecución de las políticas.
  • Condiciones y transformaciones que se aplicaron y realizaron en el momento de la invocación.
  • Registro del servidor capturado en el momento de la invocación.

A continuación se exponen algunas consideraciones importantes a la hora de rastrear una API.

  • Cuando se crea una nueva versión de API a partir de una API para la que el seguimiento está activado, por defecto el seguimiento está desactivado en la nueva API versionada.
  • Cuando importa una API con la opción Sobrescribir seleccionada como All o Custom - API, y si la API que existe después de importar la API, por defecto la traza está desactivada. Activar el rastreo explícitamente.
  • Cuando se promociona una API con la opción Sobrescribe activos excepto alias que ya existen en las etapas de destino seleccionadas, por defecto, después de promocionar la API a la instancia de destino, la traza se desactiva. Activar el rastreo explícitamente.
  • Cuando se activa el trazador, puede producirse una degradación del rendimiento. Para evitarlo, API Gateway limita el número de solicitudes de rastreo procesadas a una solicitud por segundo y nodo. Esto ayuda a racionalizar la avalancha de tráfico que hay que rastrear. Las demás solicitudes que llegan durante este tiempo se descartan y no se rastrean.
  • Las últimas 100 solicitudes de rastreo en tiempo de ejecución se conservan y el resto se descartan. Es decir, se conservan los datos de rastreo del último minuto y se descartan los demás. Todos los documentos de seguimiento se envían como una única solicitud masiva, por lo que cualquier solicitud de seguimiento tiene un retraso mínimo de 5s para mostrarse en la interfaz de usuario.
  • webMethods API Gateway no admite el rastreo de políticas y reglas de protección frente a amenazas.
  • webMethods API Gateway no soporta el rastreo para grupos Microgateway.

Las siguientes políticas forman parte de la API de rastreo.

  • Transporte
    • Activar HTTP / HTTPS
    • Establecer tipo de soporte
  • Identificar y acceder
    • autorizar a usuarios
    • Identificar y autorizar
    • Extensión personalizada
  • Proceso de la solicitud
    • Invocar webMethods IS
    • Solicitar transformación
    • Máscara de datos
    • Extensión personalizada
  • Direccionamiento
    • Enrutamiento directo
    • Encabezado personalizado HTTP
    • Autenticación de salida - Transporte
    • Extensión personalizada
  • Proceso de respuestas
    • Invocar webMethods IS
    • Respuesta Transformación
    • CORS
    • Máscara de datos
    • Extensión personalizada
  • Gestión de errores
    • Máscara de datos
    • Extensión personalizada
Nota: Puede activar o desactivar el rastreo para una API utilizando la API REST de Gestión de Servicios. Para más detalles, consulte Gestión de servicios.