URI de solicitud 414 demasiado largo - 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 414 Request-URI Too Long 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 414 Request-URI Too Long

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

{
   "fault":{
      "faultstring":"request line size exceeding 7,168",
      "detail":{
         "errorcode":"protocol.http.TooBigLine"
      }
   }
}

Ten en cuenta que la faultstring del mensaje de error anterior contiene el límite permitido. para la línea de solicitud en Apigee Edge, que es 7168 bytes (7 KB).

Causas posibles

Este error ocurre si el tamaño de la línea de solicitud que envía la aplicación cliente a Apigee Edge como parte de la solicitud HTTP es mayor que el límite permitido en Apigee Edge.

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

Descripción de la línea de solicitud

Una solicitud HTTP típica consta de tres partes:

  1. Línea de solicitud
  2. ( Conjunto de encabezados HTTP)
  3. [ Cuerpo ]

La línea de solicitud consta de tres partes, como se muestra a continuación. 

Request-Line = <Method> <Request-URI> <HTTP-Version>

Cuando la aplicación cliente realiza una solicitud HTTP a un servidor, la primera línea que se dirige el servidor contiene la línea de solicitud que se describió anteriormente. Le sigue el encabezados y el cuerpo de la solicitud o la carga útil.

En la siguiente captura de pantalla de ejemplo, se muestra una solicitud curl típica, la Solicitud. (junto con la línea de solicitud) y la parte Respuesta.

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

  1. En el ejemplo anterior, la línea start (primera línea) en la solicitud también conocida como línea de solicitud, se define de la siguiente manera: 
    GET /test/ HTTP/1.1

    El tamaño de la línea de solicitud es ~19 bytes, ya que contiene 19 ASCII characters Dado que este se encuentra dentro del límite permitido en Apigee Edge, la solicitud se procesa sin errores y obtienes una respuesta exitosa.

  2. Del mismo modo, si observas faultstring en El mensaje de error que se muestra arriba contiene "request line size exceeding 7,168". Esto indica que la línea de solicitud en la solicitud HTTP que realizó el cliente superó 7,168 bytes.

Estas son las posibles causas de este error:

Causa Descripción Instrucciones de solución de problemas aplicables para
El tamaño de la carga útil de la solicitud supera el límite permitido El tamaño del URI de solicitud que envía la aplicación cliente como parte del protocolo HTTP supera el 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:

Supervisión de API

Para diagnosticar el error con la supervisión de API, haz lo siguiente:

  1. Accede a la IU de Apigee Edge como usuario con un el puesto adecuado.

  2. Cambia a la organización en la que quieres investigar el problema.

  3. Navega a Analyze > Supervisión de API > Investigar.
  4. Selecciona el período específico en el que observaste los errores.
  5. Traza Código de error en Tiempo.
  6. Selecciona una celda que tenga el código de falla protocol.http.TooBigLine y código de estado 414, como se muestra a continuación:

    ( ver imagen más grande)

  7. Verás la información sobre el código de falla protocol.http.TooBigline. como se muestra a continuación:

    ( ver imagen más grande)

  8. Haz clic en Ver registros y expande la fila de la solicitud con errores:

    ( ver imagen más grande)

  9. En la ventana Registros, observa los siguientes detalles:

    • Código de estado: 414
    • Fuente del error: apigee
    • Código de error: protocol.http.TooBigLine.
    • Longitud de la solicitud(bytes): 7244 (> 7KB)
  10. Si la Fuente del error tiene el valor apigee o MP, la Fault Code tiene el valor protocol.http.TooBigLine y Request-Length es mayor a 7 KB, entonces, eso indica que la solicitud HTTP del cliente tiene un URI de solicitud mayor que el límite permitido en Apigee.

Herramienta de seguimiento

NGINX

Para diagnosticar el error con los registros de acceso de NGINX, haz lo siguiente:

  1. Si eres un usuario de la nube privada, puedes usar los registros de acceso de NGINX para Determinar la información clave sobre los errores 414 de HTTP.

  2. Verifica los 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.

  3. Realiza una búsqueda para ver si hay algún error 414 durante una duración específica (si el problema ocurrió en el pasado) o si todavía hay solicitudes que fallan 414

  4. Si encuentras algún error 414 con el código X-Apigee-fault-code coincide con el valor de protocol.http.TooBigLine y, luego, determina el valor de X-Apigee-fault-source.

    La entrada de ejemplo anterior del registro de acceso de NGINX tiene los siguientes valores para X-Apigee-fault-code y X-Apigee-fault-source:

    Encabezados de respuesta Valor
    X-Apigee-fault-code protocol.http.TooBigLine
    X-Apigee-fault-source policy

    Ten en cuenta la longitud de la solicitud: 7244 (7.244 KB > límite permitido)

Causa: El tamaño de la carga útil de la solicitud supera el límite permitido

Diagnóstico

  1. Determina el Fault Code, la Fault Source y el Request-Length size del tamaño de la 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.
  2. Si la Fuente del error tiene el valor apigee o MP, este indica que el tamaño de la solicitud enviada por la aplicación cliente a Apigee es mayor que el límite permitido en Apigee Edge.
  3. Puedes validar que el tamaño de la línea de solicitud haya superado el límite permitido de 7 KB mediante una de las siguientes opciones: 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 faultstring. El faultstring indica que el tamaño de la línea de solicitud superó el límite permitido de 7 KB.

    Ejemplo de mensaje de error:

    "faultstring":"request line size exceeding 7,168"

    Solicitud real

    Para validar con la solicitud real, haz lo siguiente:

    Si tienes acceso a la solicitud real que realizó la aplicación cliente, Luego, sigue estos pasos:

    1. Verifica el tamaño del URI que se pasó en la solicitud.

    2. Si observas que el tamaño del URI es mayor que el límite permitido en Apigee Edge, entonces la causa del problema.

      Solicitud de muestra:

      curl http://<hostalias>/testtoobigline?_qparam=000000000000000000……..000000<trimmed> -k -X POST

      En el caso anterior, el valor del parámetro de consulta qparam es superior a 7 KB, es decir, contiene más de 7,000 caracteres ASCII.

      Si usas otro cliente, puedes revisar sus registros intenta averiguar el tamaño de la línea de solicitud 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 usuario de la Nube privada, puedes usar los registros de Message Processor para valide si el tamaño de la línea de solicitud superó el límite permitido en Apigee Edge.

    1. Revisa los registros de Message Processor:

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

    2. Realiza una búsqueda para ver si hay algún error 414 durante un Si el problema ocurrió en el pasado o si hay solicitudes Sigue fallando con 414. Puedes usar las siguientes cadenas de búsqueda. 
      grep -ri "exceeding"

      grep -ri "RequestURITooLong"
    3. Encontrarás líneas de system.log similares a las siguientes: 
      2021-07-12 08:53:31,461  NIOThread@0 ERROR ADAPTORS.HTTP.FLOW -
AbstractRequestListener.onException() : Request:null, uri:null,
message Id:null, exception:com.apigee.errors.http.user.RequestURITooLong{
code = protocol.http.TooBigLine, message = request line size exceeding 7,168,
associated contexts = []}, context:Context@366f4217
input=ClientInputChannel(SSLClientChannel[Accepted: Remote:192.168.195.90:8443
Local:192.168.67.23:34256]@301912 useCount=1 bytesRead=0 bytesWritten=45849
age=2254670ms lastIO=0ms isOpen=true)

      El texto message = request line size exceeding 7,168 en la anterior mensaje de error indica que el tamaño del URI de solicitud es superior a 7 KB. Por lo tanto, Apigee Edge arroja la excepción com.apigee.errors.http.user.RequestURITooLong y devoluciones Código de estado 414 con código de falla protocol.http.TooBigline a las aplicaciones cliente.

Solución

Corregir tamaño

Opción 1 (recomendada): Corrige la aplicación cliente para que no envíe un tamaño de URI de solicitud mayor que el límite permitido

  1. Analiza el motivo por el que el cliente específico envía un tamaño de URI de solicitud superior al límite permitido, según se define en Límites.

  2. Si no es lo deseable, modifica la aplicación cliente para que envíe el URI de solicitud. inferior al límite permitido.

    En el ejemplo anterior, puedes corregir el problema pasando la consulta larga como parte del cuerpo de la solicitud o de la carga útil, en lugar de pasarlos como parte del solicitar una URL, como se muestra a continuación:

    curl https://<host>/testtoobigline -k -X GET -d '{_qparam=000000000000000000<trimmed>}' -v
  3. Si es deseable y quieres enviar un URI más que el límite permitido, dirígete a la opciones siguientes.

CwC

Opción 2 : Usa la propiedad CwC para aumentar el límite de la línea de solicitud

Apigee proporciona un CwC que le permite aumentar el límite de tamaño de la línea de solicitud. Para obtener más información, consulta Cómo establecer el límite de líneas de solicitud en Message Processor

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 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 HTTPRequest.line.limit tenga con un nuevo valor en Message Processors.

  1. En la máquina del procesador de mensajes, busca la propiedad. HTTPRequest.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 "HTTPRequest.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:HTTPRequest.line.limit=7k

  3. En el resultado de ejemplo anterior, ten en cuenta que la propiedad HTTPRequest.line.limit se estableció con el valor 7k en http.properties.

    Esto indica que el límite para el tamaño de la línea de solicitud configurado en Apigee para Cloud es de 7 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 414
  • 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 414

  • 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