502 Bad Gateway - TooBigLine

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

Síntoma

La aplicación cliente obtiene un código de estado HTTP de 502 Bad Gateway con el código de error. protocol.http.TooBigLine como respuesta a las llamadas a la API.

Mensaje de error

La aplicación cliente obtiene el siguiente código de respuesta:

HTTP/1.1 502 Bad Gateway

Además, puedes observar el siguiente mensaje de error:

{
   "fault":{
      "faultstring":"response line size exceeding 2,048",
      "detail":{
         "errorcode":"protocol.http.TooBigLine"
      }
   }
}

Causas posibles

Este error se produce si el tamaño de la línea de respuesta enviado por el servidor de destino o backend a Apigee El perímetro como parte de la respuesta HTTP es mayor que el máximo permitido. límite en Apigee Edge.

Antes de analizar las posibles causas de este error, veamos cuál es la línea de respuesta y cómo comprobar su tamaño.

Comprensión de la línea de respuesta

Una respuesta HTTP típica consta de tres partes:

1. Estado-Línea (denominada Línea de respuesta en Apigee)
2. ( Conjunto de encabezados HTTP)
3. [ Cuerpo ]

La línea de respuesta consta de tres partes: versión del protocolo seguida de un valor numérico código de estado y la frase textual asociada, como se muestra a continuación:

Response-Line   = <HTTP-Version> <Status-Code> <Reason-Phrase>

Cuando la aplicación del servidor de destino o backend envía una respuesta HTTP, la primera línea enviado representa la línea de respuesta, como se describió anteriormente. Le sigue el encabezados y el cuerpo/carga útil de la respuesta.En la siguiente captura de pantalla de ejemplo, se muestra curl, las partes Request y Response (junto con las línea de respuesta).

Información sobre el tamaño de la línea de respuesta

1. En el ejemplo anterior, la línea start (primera línea) en la respuesta también llamada línea de respuesta es la siguiente:

   HTTP/1.1 200 OK
   

   Esta línea de respuesta tiene un tamaño de ~15 bytes, ya que contiene 15 ASCII characters. Dado que este se encuentra dentro del límite permitido en Apigee Edge, la respuesta se devuelve al cliente sin ninguna errores de Apigee Edge.

2. Del mismo modo, si observas faultstring en El mensaje de error que se muestra arriba contiene "response line size exceeding 2,048". Esto indica que la línea de respuesta de la respuesta HTTP que envió el servidor de destino o backend supera los 2,048 bytes.

Comprensión de la línea de respuesta extensa

Según la definición de Estado-Línea (aquí aquí denominada Línea de respuesta) y solicitudes HTTP típicas el tamaño sería mucho menor que el límite predeterminado definido de 2 K en Apigee Edge, por lo que es posible que no alcanzar el límite. Sin embargo, estas son algunas situaciones posibles en las que podrías exceder este límite:

1. El servidor de destino o backend no es un sistema HTTP. Podría responder con un mensaje que no es HTTP respuesta.
2. El servidor de destino o backend tiene problemas y envía una línea de respuesta larga como parte del mensaje respuesta.

Obtén más información sobre este tema en Se obtiene el error protocolo.http.TooBigLine, “tamaño de la línea de respuesta que supera 2,048.

Estas son las posibles causas del error:

Causa	Descripción	Instrucciones de solución de problemas aplicables para
El tamaño de la línea de respuesta supera el límite permitido	El tamaño de la línea de respuesta que envía el servidor de destino o backend como parte del La respuesta HTTP a Apigee Edge es mayor que la límite permitido en Apigee Edge	Usuarios perimetrales de nubes públicas y privadas

Pasos comunes de diagnóstico

Usa una de las siguientes herramientas o técnicas para diagnosticar este error:

Causa: El tamaño de la línea de respuesta es superior al límite permitido

Diagnóstico

1. Determina el código de error y la fuente de errores del error observado con la API. Monitoring, la herramienta de seguimiento o los registros de acceso de NGINX como se explica en Pasos comunes del diagnóstico.
2. Si la Fuente del error tiene el valor target, esto indica que El tamaño de la línea de respuesta que envía la aplicación del servidor de destino o backend a Apigee es mayor que el límite permitido en Apigee Edge.

3. Puedes validar que el tamaño de la línea de respuesta haya superado el límite permitido de 2 KB con una de los siguientes métodos:

   Mensaje de error

   Para validar con el mensaje de error, haz lo siguiente:

   Si tienes acceso al mensaje de error completo que recibiste de Apigee Edge, consulta el faultstring

   Ejemplo de mensaje de error:

   "faultstring":"response line size exceeding 2,048"
   

   El faultstring anterior indica que el tamaño de la línea de respuesta superó el tamaño permitido con un límite de 2 KB.

   Solicitud real

   Para validar con la solicitud real, haz lo siguiente:

   Si tienes acceso a la solicitud real que se realizó al servidor de destino o backend y realiza los siguientes pasos:

   1. Verifica el tamaño de la línea de respuesta
   2. Si observas que el tamaño del URI es mayor que el límite permitido en Apigee Edge, esa es la causa del el problema.

      Respuesta de muestra del servidor de destino/backend:

      curl -v http://HOSTALIAS/test
      

      *   Trying 3.2.1.4...
      * TCP_NODELAY set
      * Connected to <hostalias> (3.2.1.4) port 80 (#0)
      > GET /test HTTP/1.1
      > Host: HOSTALIAS
      > User-Agent: curl/7.64.1
      > Accept: */*
      >
      < HTTP/1.1 200 1111…<trimmed>...11111111
      < Date: Mon, 26 Jul 2021 07:07:18 GMT
      < Content-Type: application/json
      < Content-Length: 269
      < Connection: keep-alive
      < Server: gunicorn/19.9.0
      < Access-Control-Allow-Origin: *
      < Access-Control-Allow-Credentials: true
      <
      {
      <Response Body>
      }
      * Connection #0 to host <hostalias> left intact
      * Closing connection 0
      

      En el caso anterior, el HTTP/1.1 200 1111…<trimmed>...11111111 de la línea de respuesta es mayor que 2 KB, es decir, contiene más de 2,000 caracteres ASCII.

      Si usas otro cliente, puedes revisar los registros del cliente y tratar de para averiguar el tamaño de la línea de respuesta que se envía a Apigee Edge.

   Registros del procesador de mensajes

   Para realizar la validación con los registros de Message Processor, haz lo siguiente:

   Si eres un usuario de la nube privada, puedes usar los registros del procesador de mensajes para lo siguiente: valide si el tamaño de la línea de respuesta superó el límite permitido en Apigee Edge.

   1. Determinar el ID del mensaje de la solicitud con errores usando la supervisión de API, la herramienta Trace o NGINX, como se explica en Pasos de diagnóstico comunes.

   2. Busca el ID del mensaje en el registro de Message Processor:

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

   3. Encontrarás líneas de system.log similares a las siguientes:

      2021-07-26 06:45:41,451 org:myorg env:prod api:testtoobigline rev:1 messageid:r-5110240-1
      NIOThread@1 ERROR HTTP.CLIENT - HTTPClient$Context$3.onException() :
      ClientChannel[Connected: Remote:3.2.1.2:80 Local:192.168.205.251:44398]@20592
      useCount=1 bytesRead=0 bytesWritten=201 age=144ms  lastIO=0ms  isOpen=true.onExceptionRead
      exception: {}
      com.apigee.errors.http.server.BadGateway: response line size exceeding 2,048
      at <snipped>
      
      2021-07-26 06:45:41,451 org:myorg env:prod api:testtoobigline rev:1
      messageid:r-5110240-1  NIOThread@1 ERROR ADAPTORS.HTTP.FLOW -
      AbstractResponseListener.onException() : AbstractResponseListener.onError
      (HTTPResponse@6a5d6c33, response line size exceeding 2,048)
      

      El texto message = response line size exceeding 2,048 en el ejemplo anterior indica que el tamaño de la línea de respuesta supera los 2 KB. Por lo tanto, Apigee Edge arroja la excepción y muestra un código de estado 502 con el código de falla protocol.http.TooBigline a las aplicaciones cliente.

Solución

Límites

Apigee espera que la aplicación cliente y el servidor de backend no envíen solicitudes ni líneas de respuesta cuyos tamaños sean superiores al límite permitido que se documenta para Límite de líneas de solicitud/respuesta en Límites de Apigee Edge.

1. Si eres usuario de la nube pública, el límite máximo de solicitudes y El tamaño de la línea de respuesta es el que se documenta para Tamaño de la línea de respuesta/solicitud en Límites de Apigee Edge.
2. Si eres un usuario de la nube privada, es posible que hayas modificado el valor máximo predeterminado límite para el tamaño de la solicitud y la línea de respuesta (aunque no es una práctica recomendada). Para determinar el límite máximo de tamaño de la línea de respuesta, siga las instrucciones en Cómo verificar el límite actual.

¿Cómo puedo verificar el límite actual?

En esta sección, se explica cómo verificar que la propiedad HTTPResponse.line.limit tenga con un nuevo valor en Message Processors.

1. En la máquina del procesador de mensajes, busca la propiedad. HTTPResponse.line.limit en directorio /opt/apigee/edge-message-processor/conf y verifica en ve qué valor se configuró, como se muestra a continuación:

   grep -ri "HTTPResponse.line.limit" /opt/apigee/edge-message-processor/conf
   

2. El resultado de muestra del comando anterior es el siguiente:

   /opt/apigee/edge-message-processor/conf/http.properties:HTTPResponse.line.limit=2k
   

3. En el resultado de ejemplo anterior, observa que la propiedad HTTPResponse.line.limit se estableció con el valor 2k en http.properties.

   Esto indica que el límite de tamaño de la línea de respuesta configurado en Apigee para Cloud es de 2 KB.

Si aún necesitas ayuda del equipo de asistencia de Apigee, ve a Se debe recopilar información de diagnóstico.

Se debe recopilar información de diagnóstico

Obtén la siguiente información de diagnóstico y, luego, comunícate con el equipo de asistencia de Apigee Edge:

Si eres usuario de la nube pública, proporciona la siguiente información:

• Nombre de la organización
• Nombre del entorno
• Nombre del proxy de API
• Completa el comando curl que se usa para reproducir el error 502
• Archivo de seguimiento de las solicitudes a la API

Si eres un usuario de la Nube privada, proporciona la siguiente información:

• Mensaje de error completo observado para las solicitudes fallidas
• Nombre de la organización
• Nombre del entorno
• Paquete de proxy de API
• Archivo de registro de las solicitudes a la API con errores
• Completa el comando curl que se usa para reproducir el error 502

• Registros de acceso de NGINX /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  Dónde: ORG, ENV y PORT# se reemplazan por valores reales.

• Registros del sistema del procesador de mensajes /opt/apigee/var/log/edge-message-processor/logs/system.log