Tutorial: Depuración de las API con el seguimiento de solicitudes
En este tutorial se describe cómo inspeccionar (realizar un seguimiento) del procesamiento de solicitudes en Azure API Management para ayudarle a depurar y solucionar los problemas de la API.
En este tutorial, aprenderá a:
- Realizar el seguimiento de una llamada de ejemplo
- Revisar los pasos del procesamiento de solicitudes
Requisitos previos
- Conocer la terminología de API Management de Azure.
- Complete el siguiente inicio rápido: Creación de una instancia de Azure API Management.
- Realice el siguiente tutorial: Importación y publicación de la primera API.
Comprobación del valor Permitir seguimiento
Se debe habilitar el valor Permitir seguimiento para la suscripción que se usa para la API. Si usa la suscripción integrada de acceso a todo, este valor está habilitado de forma predeterminada. Para comprobarlo en el portal, vaya a la instancia de API Management y seleccione Suscripciones.
Realizar el seguimiento de una llamada
- Inicie sesión en Azure Portal y vaya a la instancia de API Management.
- Seleccione API.
- Seleccione Demo Conference API en la lista de API.
- Seleccione la pestaña Prueba.
- Seleccione la operación GetSpeakers.
- Confirme que el encabezado de la solicitud HTTP incluye Ocp-Apim-Trace: True y un valor válido para Ocp-Apim-Subscription-Key. Si no es así, seleccione + Agregar encabezado para agregar el encabezado.
- Seleccione Enviar para realizar una llamada API.
Sugerencia
Si Ocp-Apim-Subscription-Key no se rellena automáticamente en la solicitud HTTP, puede recuperarla en el portal. Seleccione Suscripciones y abra el menú contextual ( ... ) de la suscripción. Seleccione Mostrar u ocultar claves. También puede regenerar claves si es necesario. Después, agregue una clave al encabezado.
Revisión de la información de seguimiento
Una vez finalizada la llamada, vaya a la pestaña Seguimiento en Respuesta HTTP.
Seleccione cualquiera de los siguientes vínculos para saltar a la información de seguimiento detallada: entrada, back-end, salida.
Entrada: muestra la solicitud original API Management recibida del autor de llamada y las directivas aplicadas a la solicitud. Por ejemplo, si agregó directivas en Tutorial: Transformación y protección de una API, aparecerán aquí.
Back-end: muestra las solicitudes que API Management envió al back-end de la API y la respuesta que recibió.
Salida: muestra todas las directivas que se aplican a la respuesta antes de enviarla de vuelta al autor de llamada.
Sugerencia
Cada paso muestra también el tiempo transcurrido desde que API Management recibe la solicitud.
En la pestaña Mensaje, el encabezado ocp-apim-trace-location muestra la ubicación de los datos de seguimiento almacenados en Azure Blob Storage. Si es necesario, vaya a esta ubicación para recuperar el seguimiento.
Pasos siguientes
En este tutorial, ha aprendido a:
- Realizar el seguimiento de una llamada de ejemplo
- Revisar los pasos del procesamiento de solicitudes
Avance hasta el siguiente tutorial: