503 Service AVAILABLE - NoActiveTargets

Estás viendo la documentación de Apigee Edge.
Ve a la Documentación de Apigee X. información

Videos

Para obtener más información sobre los errores 503, consulta los siguientes videos:

Síntoma

La aplicación cliente recibe el código de estado de respuesta HTTP 503 con el el mensaje Service Unavailable y el código de error NoActiveTargets para las solicitudes del proxy de API.

Mensaje de error

Verás la siguiente respuesta de error:

HTTP/1.1 503 Service Unavailable
  

Verás el siguiente mensaje de error en la respuesta HTTP:

{
   "fault": {
      "faultstring": "The Service is temporarily unavailable",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.NoActiveTargets"
       }
    }
}
  

Causas posibles

Por lo general, se observa la respuesta HTTP 503 Service Unavailable con el código de error NoActiveTargets cuando usas uno o más servidores de destino en la configuración del extremo de destino en tu proxy de API.

En la siguiente tabla, se enumeran las posibles causas del error 503 Service Unavailable con el código de error de respuesta NoActiveTargets:

Causa: El servidor de destino está inhabilitado

Si todos los servidores de destino especificados en la configuración del extremo de destino están inhabilitados, Obtendrás una respuesta 503 Service Unavailable con el código de error NoActiveTargets.

Diagnóstico

1. Determina el nombre del servidor de destino que se utiliza en el extremo de destino específico Configuración del proxy de API con errores mediante una de las siguientes maneras:
1. Si hay un solo extremo de destino, verifica ese extremo de destino específico.
2. Si hay varios extremos de destino y no estás seguro de cuál de ellos inhabilitó el servidor de destino, sigue estos pasos:
1. Habilita la sesión de seguimiento, realiza la llamada a la API y reproduce el problema - 503 Servicio no disponible.
2. Desde el seguimiento, navega a Target Request Flow Started y determina el nombre del extremo de destino como se muestra a continuación:



2. Cuando hayas identificado el extremo de destino, obtén el nombre del servidor de destino utilizado en la configuración del extremo de destino, tal como se muestra en el siguiente ejemplo:

   <TargetEndpoint name="default">>
     <HTTPTargetConnection>
       <LoadBalancer>
         <Server name="demo-target" />
       </LoadBalancer>
       <Path>/test</Path>
     </HTTPTargetConnection>
   </TargetEndpoint>
         

   En el ejemplo anterior, hay un único servidor de destino llamado demo-target.

3. Obtén la definición de cada uno de los servidores de destino que se usan en el extremo de destino mediante la IU de Edge o la llamada a la API de Edge.

   IU de Edge

   Para obtener la definición con la IU de Edge, haz lo siguiente:

   1. Navega a Administrador > Entornos > Servidores de destino.
   2. Selecciona el entorno específico en el que ves la falla.
   3. Busca el nombre del servidor de destino específico para obtener la definición del servidor de destino.

      Por ejemplo, escribe el nombre del servidor de destino demo-target y verás su definición como se muestra a continuación:

      

      Observa que el servidor de destino demo-target tiene un alias de host y el puerto #, y que SSL está habilitado. Sin embargo, el servidor de destino está inhabilitado , lo que se indica cuando el elemento HABILITADO está inhabilitado.

   API de Edge

   Para obtener la definición con la API de Edge, sigue estos pasos:

   Utiliza el Obtén la API de TargetServer para obtener la definición del servidor de destino.

   Resultado de la definición del servidor de destino

   <TargetServer name="demo-target">
     <Host>demo-target.apigee.net</Host>
     <Port>443</Port>
     <IsEnabled>false</IsEnabled>
     <SSLInfo>
         <Enabled>true</Enabled>
     </SSLInfo>
   </TargetServer>
             

   El resultado de la API de Apigee muestra que el servidor de destino demo-target está inhabilitado. ya que el elemento IsEnabled se establece en falso.

   Dado que el servidor de destino está inhabilitado, el procesador de mensajes enviará 503 Service No disponible con el código de error NoActiveTargets inmediatamente como respuesta al cliente.

Solución

Asegúrate de que los servidores de destino específicos que se usaron en la configuración del extremo de destino de tu API Los proxies siempre están habilitados.

<TargetServer name="demo-target">
  <Host>demo-target.apigee.net</Host>
  <Port>443</Port>
  <IsEnabled>true</IsEnabled>
  <SSLInfo>
      <Enabled>true</Enabled>
  </SSLInfo>
</TargetServer>
        

Si el problema persiste, ve a Se debe recopilar información de diagnóstico.

Diagnostica problemas con la supervisión de API

La supervisión de API permite aislar problemas áreas con rapidez para diagnosticar problemas de errores, latencia y rendimiento, y su fuente, como los proxies de API, destinos de backend o la plataforma de API.

Analizar una situación de ejemplo que demuestra cómo solucionar problemas 5xx con tus APIs con la supervisión de API. Por ejemplo: te recomendamos configurar una alerta para que se te notifique cuando la cantidad de messaging.adaptors.http.flow.NoActiveTargets de errores exceden un umbral en particular.

Se debe recopilar información de diagnóstico

Si el problema persiste, incluso después de seguir las instrucciones anteriores, reúne la siguiente y la información de diagnóstico. Comunícate con el equipo de asistencia de Apigee y compártelas:

1. Si eres usuario de la nube pública, proporciona la siguiente información:
1. Nombre de la organización
2. Nombre del entorno
3. Nombre del proxy de API
4. Completar el comando curl para reproducir el error
5. Archivo de seguimiento que contiene las solicitudes con 503 Service Unavailable con el código de error NoActiveTargets
2. Si eres usuario de la nube privada, proporciona la siguiente información:
   1. Se observó un mensaje de error completo
   2. Nombre del entorno
   3. Paquete de proxy de API
   4. Archivo de seguimiento que contiene las solicitudes con 503 Service Unavailable con el código de error NoActiveTargets
   5. Registros de acceso de NGINX

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

   6. Registros del procesador de mensajes

      (/opt/apigee/var/log/edge-message-processor/logs/system.log)