502 Bozuk Ağ Geçidi - TooBigLine

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

Belirti

İstemci uygulaması, API çağrılarına yanıt olarak 502 Bad Gateway HTTP durum kodunu ve protocol.http.TooBigLine hata kodunu alır.

Hata mesajı

İstemci uygulaması aşağıdaki yanıt kodunu alır:

HTTP/1.1 502 Bad Gateway

Ayrıca aşağıdaki hata mesajını da görebilirsiniz:

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

Olası nedenler

Bu hata, hedef/arka uç sunucu tarafından HTTP yanıtının bir parçası olarak Apigee Edge'e gönderilen Response-Line boyutu, Apigee Edge'deki izin verilen maksimum sınırdan büyükse oluşur.

Bu hatanın olası nedenlerine bakmadan önce yanıt satırının ne anlama geldiğini ve boyutunun nasıl kontrol edileceğini öğrenelim.

Yanıt satırını anlama

Tipik bir HTTP yanıtı üç bölümden oluşur:

1. Durum satırı (Apigee'de Yanıt satırı olarak adlandırılır)
2. ( HTTP üstbilgileri kümesi)
3. [ Body ]

Yanıt satırı üç bölümden oluşur: Protokol sürümü, ardından sayısal durum kodu ve bunun ilişkili metin ifadesi (aşağıda gösterildiği gibi):

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

Hedef/arka uç sunucu uygulaması tarafından bir HTTP yanıtı gönderildiğinde, gönderilen ilk satır yukarıda açıklandığı gibi Response-Line'ı temsil eder. Bunu başlıklar ve yanıt gövdesi/yükü izler.Aşağıdaki örnek ekran görüntüsünde, tipik bir curl isteği, Request (İstek) bölümü ve Response (Yanıt) bölümü (Response-Line ile birlikte) gösterilmektedir.

Yanıt satırı boyutunu anlama

1. Yukarıda bahsedilen örnekte, yanıttaki başlangıç satırı (ilk satır) Response-Line olarak da adlandırılır ve şu şekildedir:

   HTTP/1.1 200 OK

   Bu yanıt satırı, 15 ASCII characters içerdiğinden ~15 bytes boyutundadır. Bu, Apigee Edge'deki izin verilen sınır içinde olduğundan yanıt, Apigee Edge tarafından herhangi bir hata olmadan istemciye geri gönderilir.

2. Benzer şekilde, yukarıda gösterilen hata mesajındaki faultstring simgesinde "response line size exceeding 2,048" bulunur. Bu,hedef/arka uç sunucu tarafından gönderilen HTTP yanıtındaki Response-Line'ın 2.048 baytı aştığını gösterir.

Büyük yanıt satırını anlama

Status-Line (burada Response-Line olarak adlandırılır) ve tipik HTTP istekleri ile yanıtın tanımına göre boyut, Apigee Edge'de tanımlanan 2 K varsayılan sınırından çok daha küçük olacaktır. Bu nedenle, sınıra ulaşmayabiliriz. Ancak bu sınırı aşabileceğiniz bazı olası senaryolar aşağıda verilmiştir:

1. Hedef/arka uç sunucusu bir HTTP sistemi değildir. HTTP dışı bir yanıt veriyor olabilir.
2. Hedef/arka uç sunucusunda sorunlar var ve HTTP yanıtının bir parçası olarak uzun bir yanıt satırı gönderiyor.

Bu konu hakkında daha fazla bilgiyi Getting error protocol.http.TooBigLine, "response line size exceeding 2,048 başlıklı makalede bulabilirsiniz.

Bu hatanın olası nedenleri şunlardır:

Sık karşılaşılan teşhis adımları

Bu hatayı teşhis etmek için aşağıdaki araçlardan/tekniklerden birini kullanın:

Neden: Yanıt satırı boyutu, izin verilen sınırın üzerinde

Teşhis

1. API İzleme, İzleme Aracı veya NGINX erişim günlükleri kullanılarak gözlemlenen hatanın Hata Kodunu ve Hata Kaynağını belirleyin. Bu işlem, Genel teşhis adımları bölümünde açıklanmıştır.
2. Hata Kaynağı değeri target ise bu, hedef/arka uç sunucu uygulaması tarafından Apigee'ye gönderilen yanıt satırı boyutunun Apigee Edge'de izin verilen sınırdan daha büyük olduğunu gösterir.

3. Aşağıdaki yöntemlerden birini kullanarak yanıt satırı boyutunun izin verilen 2 KB sınırını aştığını doğrulayabilirsiniz:

   Hata mesajı

   Hata mesajını kullanarak doğrulamak için:

   Apigee Edge'den alınan hata mesajının tamamına erişiminiz varsa faultstring bölümüne bakın.

   Örnek hata mesajı:

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

   Yukarıdaki faultstring, yanıt satırı boyutunun izin verilen 2 KB sınırını aştığını gösterir.

   Gerçek istek

   Gerçek isteği kullanarak doğrulamak için:

   Hedef/arka uç sunucu uygulamasına yapılan gerçek isteğe erişiminiz varsa aşağıdaki adımları uygulayın:

   1. Yanıt satırının boyutunu doğrulama
   2. URI'nin boyutunun Apigee Edge'de izin verilen sınırdan daha büyük olduğunu fark ederseniz sorunun nedeni budur.

      Hedef/arka uç sunucusundan örnek yanıt:

      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

      Yukarıdaki örnekte, yanıt satırı HTTP/1.1 200 1111…<trimmed>...11111111 2 KB'tan büyük, yani 2.000'den fazla ASCII karakteri içeriyor.

      Başka bir istemci kullanıyorsanız istemci günlüklerini inceleyebilir ve Apigee Edge'e gönderilen yanıt satırının boyutunu bulmaya çalışabilirsiniz.

   Mesaj işleyici günlükleri

   Mesaj İşleyici günlüklerini kullanarak doğrulamak için:

   Özel Cloud kullanıcısıysanız yanıt satırı boyutunun Apigee Edge'de izin verilen sınırı aşıp aşmadığını doğrulamak için Mesaj İşleyici günlüklerini kullanabilirsiniz.

   1. Genel teşhis adımları bölümünde açıklandığı gibi, API İzleme, İzleme aracı veya NGINX erişim günlüklerini kullanarak başarısız olan isteğin ileti kimliğini belirleyin.

   2. Mesaj İşleyici günlüğünde ileti kimliğini arayın:

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

   3. system.log ile ilgili aşağıdaki gibi satırlar görürsünüz:

      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)

      Yukarıdaki hata mesajında yer alan message = response line size exceeding 2,048 metni, yanıt satırı boyutunun 2 KB'tan büyük olduğunu gösterir. Bu nedenle, Apigee Edge istisna oluşturur ve istemci uygulamalarına hata kodu protocol.http.TooBigline ile birlikte 502 durum kodunu döndürür.

Çözünürlük

Sınırlar

Apigee, istemci uygulamasının ve arka uç sunucusunun, Apigee Edge Sınırları'ndaki İstek/Yanıt Satırı Sınırı için belgelendiği gibi, boyutları izin verilen sınırı aşan İstek/Yanıt Satırları göndermemesini bekler.

1. Herkese açık bulut kullanıcısıysanız İstek ve Yanıt Satırı boyutu için maksimum sınır, Apigee Edge Sınırları'nda İstek/Yanıt Satırı boyutu için belirtilen sınırdır.
2. Özel bulut kullanıcısıysanız İstek ve Yanıt satırı boyutu için varsayılan maksimum sınırı değiştirmiş olabilirsiniz (önerilen bir uygulama olmasa da). Mevcut sınırı kontrol etme başlıklı makaledeki talimatları uygulayarak maksimum yanıt satırı boyutu sınırını belirleyebilirsiniz.

Mevcut sınır nasıl kontrol edilir?

Bu bölümde, tesisin HTTPResponse.line.limit Mesaj İşleyiciler'de yeni bir değerle güncellendiğinin nasıl doğrulanacağı açıklanmaktadır.

1. Mesaj İşleyici makinesinde, HTTPResponse.line.limit özelliğini /opt/apigee/edge-message-processor/conf dizininde arayın ve aşağıdaki gibi hangi değerin ayarlandığını kontrol edin:

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

2. Yukarıdaki komutun örnek sonucu aşağıdaki gibidir:

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

3. Yukarıdaki örnek çıktıda, HTTPResponse.line.limit özelliğinin http.properties içinde 2k değeriyle ayarlandığını unutmayın.

   Bu, Private Cloud için Apigee'de yapılandırılan yanıt satırı boyutu sınırının 2 KB olduğunu gösterir.

Apigee Destek Ekibi'nden hâlâ yardıma ihtiyacınız varsa Toplanması gereken teşhis bilgileri başlıklı makaleyi inceleyin.

Teşhis bilgilerini toplamalıdır

Aşağıdaki teşhis bilgilerini toplayın ve ardından Apigee Edge Destek Ekibi ile iletişime geçin:

Herkese açık bulut kullanıcısıysanız aşağıdaki bilgileri sağlayın:

• Kuruluş adı
• Ortam adı
• API proxy'si adı
• 502 hatasını yeniden oluşturmak için kullanılan tam curl komutu
• API istekleri için izleme dosyası

Private Cloud kullanıcısıysanız aşağıdaki bilgileri sağlayın:

• Başarısız olan istekler için gözlemlenen hata mesajının tamamı
• Kuruluş adı
• Ortam adı
• API proxy paketi
• Başarısız olan API isteklerinin izleme dosyası
• 502 hatasını yeniden oluşturmak için kullanılan curl komutunun tamamı

• NGINX erişim günlükleri /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  Nerede: ORG, ENV ve PORT# gerçek değerlerle değiştirilir.

• Mesaj İşleyici sistem günlükleri /opt/apigee/var/log/edge-message-processor/logs/system.log