503 Service Available - Backend Server

Herramienta de Trace

1. Habilita la sesión de seguimiento, y realiza la llamada a la API para reproducir el problema: 503 Servicio no disponible.
2. Selecciona una de las solicitudes con errores y examina el seguimiento.
3. Navega por las distintas fases del seguimiento y ubica dónde se produjo el error.
4. Si descubres que el error 503 se muestra como respuesta del servidor de destino, la causa del error 503 es el servidor de destino.

   Esta es una captura de pantalla de seguimiento de muestra que muestra la respuesta 503 Servicio no disponible recibida del servidor de destino:

   
5. Haz clic en la fase Respuesta recibida del servidor de destino y revisa las secciones Encabezados de respuesta y Contenido de la respuesta para ver si tienen información útil:
   • Los encabezados de respuesta pueden contener el encabezado del servidor, que indica desde dónde se envió la respuesta de error.
   • El contenido de la respuesta puede contener información adicional sobre por qué el servidor de destino envió el código de respuesta 503.
   
6. Para confirmar que el error 503 proviene del servidor de destino, verifica los valores de X-Apigee-fault-source y X-Apigee-fault-code en la fase AX (datos de estadísticas registrados) en el seguimiento con los pasos que se indican a continuación:
   1. Haz clic en la fase AX (datos de estadísticas registrados) como se muestra en la siguiente captura de pantalla: .
   2. Desplázate hacia abajo por los detalles de la fase hasta la sección Encabezados de respuesta y determina los valores de X-Apigee-fault-code y X-Apigee-fault-source como se muestra a continuación:
   3. Si los valores de X-Apigee-fault-source y X-Apigee-fault-code coinciden con los valores que se muestran en la siguiente tabla, puedes confirmar que el error 503 proviene del servidor de destino:

      Encabezados de respuesta	Valor
      X-Apigee-fault-source	objetivo
      X-Apigee-fault-code	messaging.adaptors.http.flow.ErrorResponseCode

7. Verifica si usas el encadenamiento de proxy, es decir, si el servidor o el extremo de destino es invocando otro proxy en Apigee. Para determinar esto, haz lo siguiente:
   1. Vuelve a la fase Solicitud enviada al servidor de destino y haz clic en el botón Mostrar Curl y determina el alias de host del servidor de destino.
   2. Si el alias de host del servidor de destino apunta a un alias de host virtual, entonces es encadenamiento de proxy. En este caso, debes repetir todos los pasos anteriores para el proxy encadenado hasta que determines qué está causando realmente el error 503 Servicio no disponible. En estos casos, el error 503 Servicio no disponible también puede ocurrir en otros proxies encadenados en otras etapas, que se pueden diagnosticar con esta guía.
   3. Si el alias de host del servidor de destino apunta a tu servidor de backend, ve a Solución.

Registros de acceso de NGINX

También puedes consultar los registros de acceso de NGINX para determinar si el servidor de backend envió el código de estado 503. Esto es particularmente útil si el problema ocurrió en el pasado o si el problema es intermitente y no puedes capturar el seguimiento en la IU. Sigue estos pasos para determinar esta información de los registros de acceso de NGINX:

1. Verifica los registros de acceso de NGINX.

   /opt/apigee/var/log/edge-router/nginx/<org>~<env>.<port#>_access_log

2. Busca errores 503 para el proxy de API específico durante un período determinado (si el problema ocurrió en el pasado) o para cualquier solicitud que aún falle con 503.
3. Si hay errores 503, verifica si el error proviene del servidor de backend. Si los valores de X-Apigee-fault-source y X-Apigee-fault-code coinciden con los valores que se muestran en la siguiente tabla, el error 503 proviene del servidor de backend:

   Encabezados de respuesta	Valor
   X-Apigee-fault-source	objetivo
   X-Apigee-fault-code	messaging.adaptors.http.flow.ErrorResponseCode

   Esta es una entrada de muestra que muestra el error 503 causado por el servidor de destino:

   
4. Revisa el proxy de API específico y asegúrate de usar el encadenamiento de proxy es decir, si el servidor o el extremo de destino no invoca otro proxy en Apigee. Si usas el encadenamiento de proxy, debes repetir todos los pasos anteriores para el proxy encadenado hasta que determines qué está causando realmente el error 503 Servicio no disponible. En estos casos, el error 503 Servicio no disponible también puede ocurrir en otros proxies encadenados en otras etapas, que se pueden diagnosticar con esta guía.
5. Si confirmas que no usas el encadenamiento de proxy y que el error 503 proviene de tu servidor de backend, ve a Solución.

Llamada al servidor de backend

Puedes realizar una llamada directa al servidor de backend y verificar que obtengas la misma respuesta 503 Servicio no disponible que se recibió cuando se realizó la solicitud a través de Apigee Edge.

1. Asegúrate de tener todos los encabezados, los parámetros de consulta y las credenciales necesarios que se deben pasar al servidor de backend como parte de la solicitud.
2. Si se puede acceder al servicio de backend de forma pública, puedes usar el comando curl, Postman o cualquier otro cliente de REST y llamar a la API del servidor de backend directamente.
3. Si solo se puede acceder al servidor de backend desde los Message Processors, puedes usar el comando curl, Postman o cualquier otro cliente de REST y llamar a la API del servidor de backend directamente desde el Message Processor.
4. Verifica que el servicio de backend muestre el error 503 Servicio no disponible.