502 Bad Gateway - TooBigLine

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

Sintomo

L'applicazione client riceve un codice di stato HTTP 502 Bad Gateway con il codice di errore protocol.http.TooBigLine come risposta alle chiamate API.

Messaggio di errore

L'applicazione client riceve il seguente codice di risposta:

HTTP/1.1 502 Bad Gateway

Inoltre, potresti visualizzare il seguente messaggio di errore:

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

Possibili cause

Questo errore si verifica se le dimensioni della riga di risposta inviata dal server di destinazione/backend ad Apigee Edge come parte della risposta HTTP sono maggiori del limite massimo consentito in Apigee Edge.

Prima di esaminare le possibili cause di questo errore, cerchiamo di capire cosa significa la riga di risposta e come verificarne le dimensioni.

Informazioni sulla riga di risposta

Una risposta HTTP tipica è composta da tre parti:

1. Riga di stato (denominata riga di risposta in Apigee)
2. ( Set di intestazioni HTTP )
3. [ Corpo ]

La riga di risposta è composta da tre parti: versione del protocollo seguita da un codice di stato numerico e dalla relativa frase testuale , come mostrato di seguito:

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

Quando un'applicazione server di destinazione/backend invia una risposta HTTP, la prima riga che è inviata rappresenta la riga di risposta come descritto sopra. Seguono le intestazioni e il corpo/payload della risposta.Lo screenshot di esempio seguente mostra una tipica richiesta curl, la parte Richiesta e la parte Risposta (insieme alla riga di risposta).

Informazioni sulle dimensioni della riga di risposta

1. Nell'esempio discusso sopra, la riga start (prima riga) nella risposta, denominata anche riga di risposta , è la seguente:

   HTTP/1.1 200 OK

   Questa riga di risposta ha una dimensione di ~15 bytes perché contiene 15 ASCII characters. Poiché rientra nel limite consentito in Apigee Edge, la risposta viene inviata al client senza errori da Apigee Edge.

2. Allo stesso modo, se esamini il faultstring nel messaggio di errore mostrato sopra, contiene "response line size exceeding 2,048". Ciò indica che la riga di risposta nella risposta HTTP inviata dal server di destinazione/backend ha superato i 2048 byte.

Informazioni sulla riga di risposta di grandi dimensioni

In base alla definizione di riga di stato (denominata riga di risposta qui) e alle richieste e risposte HTTP tipiche, le dimensioni sarebbero molto inferiori al limite predefinito di 2 K in Apigee Edge, quindi potremmo non raggiungere il limite. Tuttavia, ecco alcuni possibili scenari in cui potresti superare questo limite:

1. Il server di destinazione/backend non è un sistema HTTP. Potrebbe rispondere con una risposta non HTTP response.
2. Il server di destinazione/backend presenta problemi e invia una riga di risposta lunga come parte della risposta HTTP risposta.

Scopri di più in Ricevere l'errore protocol.http.TooBigLine, "response line size exceeding 2,048.

Di seguito sono riportate le possibili cause dell'errore:

Passaggi comuni per la diagnosi

Utilizza uno dei seguenti strumenti/tecniche per diagnosticare questo errore:

Causa: le dimensioni della riga di risposta sono maggiori del limite consentito

Diagnosi

1. Determina il codice di errore e l'origine errore per l'errore osservato utilizzando il monitoraggio delle API lo strumento Traccia o i log degli accessi NGINX, come spiegato in Passaggi comuni per la diagnosi.
2. Se Origine errore ha il valore target, significa che le dimensioni della riga di risposta inviata dall'applicazione server di destinazione/backend ad Apigee sono maggiori del limite consentito in Apigee Edge.

3. Puoi verificare che le dimensioni della riga di risposta abbiano superato il limite consentito di 2 KB utilizzando uno dei seguenti metodi:

   Messaggio di errore

   Per eseguire la convalida utilizzando il messaggio di errore:

   Se hai accesso al messaggio di errore completo ricevuto da Apigee Edge, consulta il faultstring.

   Messaggio di errore di esempio:

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

   La faultstring riportata sopra indica che le dimensioni della riga di risposta hanno superato il limite consentito di 2 KB.

   Richiesta effettiva

   Per eseguire la convalida utilizzando la richiesta effettiva:

   Se hai accesso alla richiesta effettiva effettuata all'applicazione server di destinazione/backend segui questi passaggi:

   1. Verifica le dimensioni della riga di risposta
   2. Se le dimensioni dell'URI superano il limite consentito in Apigee Edge, questa è la causa del problema.

      Risposta di esempio dal server di destinazione/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

      Nel caso precedente, la riga di risposta HTTP/1.1 200 1111…<trimmed>...11111111 è maggiore di 2 KB, ovvero contiene più di 2 K caratteri ASCII.

      Se utilizzi un altro client, puoi esaminare i log del client e provare a scoprire le dimensioni della riga di risposta inviata ad Apigee Edge.

   Log del processore di messaggi

   Per eseguire la convalida utilizzando i log del processore di messaggi:

   Se sei un utente di Private Cloud, puoi utilizzare i log del processore di messaggi per verificare se le dimensioni della riga di risposta hanno superato il limite consentito in Apigee Edge.

   1. Determina l'ID messaggio della richiesta non riuscita utilizzando il monitoraggio delle API, lo strumento Traccia o i log degli accessi NGINX, come spiegato in Passaggi comuni per la diagnosi.

   2. Cerca l'ID messaggio nel log del processore di messaggi:

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

   3. Troverai righe da system.log simili alle seguenti:

      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)

      Il testo message = response line size exceeding 2,048 nel messaggio di errore riportato sopra indica che le dimensioni della riga di risposta sono maggiori di 2 KB. Di conseguenza, Apigee Edge genera l'eccezione e restituisce un codice di stato 502 con codice di errore protocol.http.TooBigline alle applicazioni client.

Risoluzione

Limiti

Apigee si aspetta che l'applicazione client e il server di backend non inviino righe di richiesta/risposta le cui dimensioni superino il limite consentito, come documentato per Limite della riga di richiesta/risposta in Limiti di Apigee Edge.

1. Se sei un utente di Public Cloud, il limite massimo per le dimensioni della riga di richiesta e risposta è documentato per Dimensioni della riga di richiesta/risposta in Limiti di Apigee Edge.
2. Se sei un utente di Private Cloud, potresti aver modificato il limite massimo predefinito per le dimensioni della riga di richiesta e risposta (anche se non è una pratica consigliata). Puoi determinare il limite massimo delle dimensioni della riga di risposta seguendo le istruzioni riportate in Come controllare il limite attuale.

Come controllare il limite attuale?

Questa sezione spiega come verificare che la proprietà HTTPResponse.line.limit sia stata aggiornata con un nuovo valore nei processori di messaggi.

1. Nella macchina del processore di messaggi, cerca la proprietà HTTPResponse.line.limit nella directory /opt/apigee/edge-message-processor/conf e controlla il valore impostato, come mostrato di seguito:

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

2. Il risultato di esempio del comando riportato sopra è il seguente:

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

3. Nell'output di esempio riportato sopra, nota che la proprietà HTTPResponse.line.limit è stata impostata con il valore 2k in http.properties.

   Ciò indica che il limite per le dimensioni della riga di risposta configurato in Apigee per Private Cloud è 2 KB.

Se hai ancora bisogno dell'assistenza del supporto Apigee, vai a Raccogliere le informazioni di diagnostica necessarie.

Raccogliere le informazioni di diagnostica necessarie

Raccogli le seguenti informazioni di diagnostica e poi contatta il supporto Apigee Edge:

Se sei un utente di Public Cloud, fornisci le seguenti informazioni:

• Nome organizzazione
• Nome ambiente
• Nome proxy API
• Comando curl completo utilizzato per riprodurre l'errore 502
• File di traccia per le richieste API

Se sei un utente di Private Cloud, fornisci le seguenti informazioni:

• Messaggio di errore completo osservato per le richieste non riuscite
• Nome organizzazione
• Nome ambiente
• Bundle del proxy API
• File di traccia per le richieste API non riuscite
• Comando curl completo utilizzato per riprodurre l'errore 502

• Log degli accessi NGINX /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  Dove: ORG, ENV e PORT# vengono sostituiti con i valori effettivi.

• Log di sistema del processore di messaggi /opt/apigee/var/log/edge-message-processor/logs/system.log