502 Bad Gateway - TooBigLine

Estás viendo la documentación de Apigee Edge.
Ir a la documentación de Apigee X. info

Síntoma

La aplicación cliente obtiene un código de estado HTTP 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, es posible que observes 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 que envía el servidor de destino o backend a Apigee Edge como parte de la respuesta HTTP es mayor que el límite máximo permitido en Apigee Edge.

Antes de analizar las posibles causas de este error, comprendamos qué significa la línea de respuesta y cómo verificar su tamaño.

Información sobre la línea de respuesta

Una respuesta HTTP típica consta de tres partes:

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

La línea de respuesta consta de tres partes: la versión del protocolo seguida de un código de estado numérico y su 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 que se envía representa la línea de respuesta como se describió anteriormente. A continuación, se incluyen los encabezados y el cuerpo o la carga útil de la respuesta.En la siguiente captura de pantalla de ejemplo, se muestra una solicitud curl típica, la parte de solicitud y la parte de respuesta (junto con la línea de respuesta).

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

1. En el ejemplo que se analizó anteriormente, la línea start (primera línea) de la respuesta, también denominada 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. Como está dentro del límite permitido en Apigee Edge, Apigee Edge devuelve la respuesta al cliente sin errores.

2. Del mismo modo, si observas el 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 superó los 2,048 bytes.

Información sobre la línea de respuesta grande

Según la definición de la línea de estado (denominada línea de respuesta aquí) y las solicitudes y respuestas 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 alcancemos el límite. Sin embargo, estos son algunos casos posibles en los que puedes superar este límite:

1. El servidor de destino o backend no es un sistema HTTP. Es posible que responda con una respuesta que no sea HTTP respuesta.
2. El servidor de destino o backend tiene problemas y envía una línea de respuesta larga como parte de la respuesta HTTP.

Obtén más información sobre esto en Obtener el error protocol.http.TooBigLine, "response line size exceeding 2,048.

Estas son las posibles causas del error:

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 mayor que el límite permitido

Diagnóstico

1. Determina el código de falla y la fuente de falla del error observado con la Supervisión de API , la herramienta Trace o los registros de acceso de NGINX, como se explica en Pasos comunes de diagnóstico.
2. Si la fuente de falla 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 superó el límite permitido de 2 KB con uno 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.

   Mensaje de error de ejemplo:

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

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

   Solicitud real

   Para validar con la solicitud real, haz lo siguiente:

   Si tienes acceso a la solicitud real realizada a la aplicación del servidor de destino o backend, realiza los siguientes pasos:

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

      Respuesta de ejemplo del servidor de destino o 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, la línea de respuesta HTTP/1.1 200 1111…<trimmed>...11111111 es mayor que 2 KB, es decir, contiene más de 2 K caracteres ASCII.

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

   Registros de Message Processor

   Para validar con los registros de Message Processor, haz lo siguiente:

   Si eres usuario de la nube privada, puedes usar los registros de Message Processor para validar si el tamaño de la línea de respuesta superó el límite permitido en Apigee Edge.

   1. Determina el ID del mensaje de la solicitud fallida con la Supervisión de API, la herramienta Trace, o los registros de acceso de NGINX, como se explica en Pasos comunes de diagnóstico.

   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 mensaje de error anterior indica que el tamaño de la línea de respuesta es superior a 2 KB. Por lo tanto, Apigee Edge muestra la excepción y devuelve 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 líneas de solicitud o respuesta cuyos tamaños sean mayores que el límite permitido, como se documenta para el límite de línea de solicitud o respuesta en Límites de Apigee Edge.

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

¿Cómo verificar el límite actual?

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

1. En la máquina de Message Processor, busca la propiedad HTTPResponse.line.limit en el /opt/apigee/edge-message-processor/conf directorio y verifica qué valor se estableció, 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 para el tamaño de la línea de respuesta configurado en Apigee para la nube privada es de 2 KB.

Si aún necesitas asistencia de Asistencia de Apigee, consulta Debes recopilar información de diagnóstico.

Se debe recopilar información de diagnóstico

Recopila la siguiente información de diagnóstico y, luego, comunícate con 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
• Comando curl completo que se usó para reproducir el error 502
• Archivo de seguimiento de las solicitudes a la API

Si eres 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 seguimiento de las solicitudes a la API fallidas
• Comando curl completo que se usó para reproducir el error 502

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

  Donde: ORG, ENV y PORT# se reemplazan por valores reales.

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