502 Bad Gateway - TooBigBody

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.TooBigBody 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":"Body buffer overflow",
      "detail":{
         "errorcode":"protocol.http.TooBigBody"
      }
   }
}

Causas posibles

Este error ocurre si el tamaño de la carga útil que envía el servidor de destino o backend a Apigee Edge como parte de la respuesta HTTP supera el límite permitido en Apigee Edge.

Estas son las posibles causas del error:

Causa	Descripción	Instrucciones de solución de problemas aplicables para
El tamaño de la carga útil de la respuesta supera el límite permitido	El tamaño de la carga útil que envía el servidor de destino o backend como parte de la respuesta HTTP a Apigee se supera el límite permitido en Apigee.	Usuarios perimetrales de nubes públicas y privadas
El tamaño de la carga útil de la respuesta supera el límite permitido descompresión	El tamaño de la carga útil que envía el servidor de destino o backend en formato comprimido como parte de HTTP supera el límite permitido cuando Apigee lo descomprime.	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 carga útil de la respuesta es superior al límite permitido

Diagnóstico

1. Determina el Código de falla, Fuente del error y Tamaño de la carga útil de la respuesta para el error observado con la supervisión de API, la herramienta de seguimiento o los registros de acceso de NGINX, como se explica en Pasos comunes del diagnóstico en la situación 1
2. Si la fuente del error tiene el valor target, esto indica que la respuesta de carga útil que envía el servidor de destino o backend a Apigee es mayor que el límite permitido en Apigee Edge.
3. Verifica el tamaño de la carga útil de la respuesta como se determina en el paso 1.
   • Si el tamaño de la carga útil > Límite permitido de 10 MB, esa es la causa del error.
   • Si el límite permitido del tamaño de la carga útil es de ~10 MB, es posible que la respuesta la carga útil se pasan en formato comprimido. Ir a Causa: El tamaño de la carga útil de la respuesta supera el límite permitido después de la descompresión.
4. Valida que el tamaño de la carga útil de la respuesta sea realmente > Límite permitido de 10 MB. Para ello, consulta el una respuesta real mediante los siguientes pasos:
   1. Si no tienes acceso a la solicitud real que se hizo al servidor de destino o backend, luego ve a Resolución.
   2. Si tienes acceso a la solicitud real realizada al servidor de destino o backend, sigue estos pasos:
      1. Si eres un usuario de nube pública o privada, envía una solicitud directamente a el servidor de backend desde el servidor de backend o cualquier otra máquina desde la que tienen permitido realizar la solicitud al servidor backend.
      2. Si eres un usuario de la nube privada, también puedes realizar la solicitud al de backend desde uno de los procesadores de mensajes.
      3. Para verificar el tamaño de la carga útil pasada en la respuesta, consulta el Encabezado Content-Length
      4. Si descubres que el tamaño de la carga útil es mayor que el límite permitido en Apigee Edge, esa es la causa de la problema.

   Respuesta de muestra del servidor de backend:

   curl -v https://BACKENDSERVER-HOSTNAME/testfile
   

   * About to connect() to 10.14.0.10 port 9000 (#0)
   *   Trying 10.14.0.10...
   * Connected to 10.14.0.10 (10.148.0.10) port 9000 (#0)
   > GET /testfile HTTP/1.1
   > User-Agent: curl/7.29.0
   > Host: 10.14.0.10:9000
   > Accept: */*
   >
   < HTTP/1.1 200 OK
   < Accept-Ranges: bytes
   < Content-Length: 11534336
   < Content-Type: application/octet-stream
   < Last-Modified: Wed, 30 Jun 2021 08:18:02 GMT
   < Date: Wed, 30 Jun 2021 09:22:41 GMT
   <
   ----snipped----
   <Response Body>
   

   En el ejemplo anterior, puedes ver que Content-Length: 11534336 (which is ~11 MB), que es la causa de este error, ya que supera el límite permitido en Apigee Edge.

Solución

Consulta la Resolución.

Causa: El tamaño de la carga útil de la respuesta supera el límite permitido después de descompresión

Si la carga útil de la respuesta se envía en formato comprimido y el encabezado de respuesta Content-Encoding está configurado como gzip, Apigee descomprime la respuesta. la carga útil útil. Durante el proceso de descompresión, si Apigee determina que el tamaño de la carga útil es mayor que el límite permitido en Apigee Edge, luego se detendrá más se descomprime y responde inmediatamente con 502 Bad Gateway y el código de error protocol.http.TooBigBody.

Diagnóstico

1. Determina el código de falla, la fuente del error y el tamaño de la carga útil de respuesta para el error observado con la supervisión de API, la herramienta de seguimiento o los registros de acceso NGINX, como se explica en Pasos comunes del diagnóstico en la situación 2
2. Si la Fuente del error tiene el valor target, esto indica que el tamaño de la carga útil de respuesta enviada por la aplicación de destino o backend a Apigee es mayor que el límite permitido en Apigee Edge.
3. Verifica el tamaño de la carga útil de la respuesta como se determina en el paso 1.
   • Si el tamaño de la carga útil > el límite permitido de 10 MB, esa es la causa del error.
   • Si el tamaño de la carga útil es de aproximadamente 10 MB, es posible que la carga útil de respuesta sea se pasan en formato comprimido. En este caso, comprueba el tamaño descomprimido de la imagen útil de respuesta rápida.
4. Puedes validar si la respuesta del destino o backend se envió en un formato comprimido y el tamaño sin comprimir superó el límite permitido mediante una de las siguientes opciones métodos:

   Trace

   Usa la herramienta Trace:

   1. Si has capturado un seguimiento de la solicitud errónea, consulta los pasos detallados en Trace y
      .
      1. Determina el valor de target.received.content.length
      2. Verifica si la solicitud del cliente contenía la Codificación de contenido: gzip
   2. Si el valor de target.received.content.length es de aproximadamente los 10 MB permitidos y el encabezado de respuesta Content-Encoding: gzip, entonces la causa de este error.

   Solicitud real

   A través de una solicitud real:

   1. Si no tienes acceso a la solicitud real que se hizo al servidor de destino o backend, luego ve a Resolución.
   2. Si tienes acceso a la solicitud real realizada al servidor de destino o backend, realiza los siguientes pasos:
      1. Verifica el tamaño de la carga útil pasada en la respuesta junto con el Encabezado Content-Encoding enviado en la respuesta.
      2. Si notas que el encabezado de respuesta Content-Encoding está configurado como gzip y el tamaño sin comprimir de la carga útil es mayor que el límite permitido en Apigee Edge, esa es la causa de este error.

         Respuesta de muestra recibida del servidor de backend:

         curl -v https://BACKENDSERVER-HOSTNAME/testzippedfile.gz
         

         * About to connect() to 10.1.0.10 port 9000 (#0)
         *   Trying 10.1.0.10...
         * Connected to 10.1.0.10 (10.1.0.10) port 9000 (#0)
         > GET /testzippedfile.gz HTTP/1.1
         > User-Agent: curl/7.29.0
         > Host: 10.1.0.10:9000
         > Accept: */*
         >
         < HTTP/1.1 200 OK
         < Accept-Ranges: bytes
         < Content-Encoding: gzip
         < Content-Type: application/x-gzip
         < Last-Modified: Wed, 30 Jun 2021 08:18:02 GMT
         < Testheader: test
         < Date: Wed, 07 Jul 2021 10:14:16 GMT
         < Transfer-Encoding: chunked
         <
         ----snipped----
         <Response Body>
         

         En el caso anterior, se envía el encabezado Content-Encoding: gzip. el tamaño del archivo testzippedfile.gz en la respuesta es menor que el límite; sin embargo, el tamaño del archivo descomprimido testzippedfile no ~15 MB.

   Registros del procesador de mensajes

   Usa los registros de Message Processor:

   1. Si eres un usuario de la nube privada, puedes usar los registros del procesador de mensajes para lo siguiente: Determinar la información clave sobre los errores 502 de HTTP.

   2. Revisa los registros de Message Processor

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

   3. Realiza una búsqueda para ver si hay algún error 502 durante una duración específica (si el problema ocurrió en el pasado) o si todavía hay solicitudes que fallan 502 Puedes usar las siguientes cadenas de búsqueda:

      grep -ri "chunkCount"
      

      grep -ri "BadGateway: Body buffer overflow"
      

   4. Encontrarás líneas de system.log similares a las que se muestran a continuación (TotalRead y chunkCount pueden variar en tu caso):

      2021-07-07 09:40:47,012  NIOThread@7 ERROR HTTP.SERVICE -
      TrackingInputChannel.checkMessageBodyTooLarge() : Message is too large.
      TotalRead 10489856 chunkCount 2571
      
      2021-07-07 09:40:47,012  NIOThread@7 ERROR HTTP.CLIENT -
      HTTPClient$Context.onInputException() :
      ClientInputChannel(ClientChannel[Connected:
      Remote:10.148.0.10:9000 Local:10.148.0.9:42240]@9155
      useCount=1 bytesRead=0 bytesWritten=182 age=23ms  lastIO=0ms
      isOpen=true).onExceptionRead exception: {}
      com.apigee.errors.http.server.BadGateway: Body buffer overflow
      
      2021-07-07 09:40:47,012  NIOThread@7 ERROR
      ADAPTORS.HTTP.FLOW - AbstractResponseListener.onException() :
      AbstractResponseListener.onError(HTTPResponse@77cbd7c4,
      Body buffer overflow)
      

   5. Durante el proceso de descompresión, tan pronto como el Message Processor determina la el total de bytes leídos es mayor que 10 MB, se detiene e imprime la siguiente línea:

      Message is too large. TotalRead 10489856 chunkCount 2571

      Esto implica que el Tamaño de la carga útil de la respuesta es superior a 10 MB y que Apigee arroja un error cuando el tamaño comienza a exceder el límite de 10 MB con el código de falla como protocol.http.TooBigBody

Solución

Límites

Apigee espera que la aplicación cliente y el servidor de backend no envíen tamaños de cargas útiles superiores a el límite permitido según se documenta para Request/response size en Límites de Apigee Edge.

1. Si eres un usuario de la nube pública, el límite máximo para la solicitud y la respuesta el tamaño de la carga útil es el que se documenta para Request/response size 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 carga útil de las solicitudes y respuestas (aunque no es una práctica recomendada). Para determinar el límite máximo del tamaño de la carga útil de la solicitud, sigue 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 Se actualizó HTTPResponse.body.buffer.limit con un nuevo valor en el campo Mensaje Procesadores.

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

   grep -ri "HTTPResponse.body.buffer.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.body.buffer.limit=10m
   

3. En el resultado de ejemplo anterior, observa que la propiedad Se estableció HTTPResponse.body.buffer.limit con el valor 10m en http.properties

   Esto indica que el límite del tamaño de la carga útil de la solicitud configurado en Apigee para La nube privada es de 10 MB.

Si aún necesitas asistencia 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
• Resultado completo de la respuesta del servidor de destino o backend junto con el tamaño de la carga útil

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
• Resultado completo de la respuesta del servidor de destino o backend junto con el tamaño de la carga útil

• 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