502 Bozuk Ağ Geçidi - TooBigBody

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

Olası nedenler

Bu hata, hedef/arka uç sunucusu tarafından HTTP yanıtının bir parçası olarak Apigee Edge'e gönderilen yük boyutu, Apigee Edge'deki izin verilen sınırı aştığında oluşur.

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 yük boyutu, izin verilen sınırdan daha büyük

Teşhis

1. API İzleme, Trace aracı veya NGINX erişim günlükleri kullanılarak gözlemlenen hatanın Hata Kodunu, Hata Kaynağını ve Yanıt Yükü Boyutunu belirleyin. Bu işlem, Yaygın teşhis adımları bölümünde 1. senaryo ile açıklanmıştır.
2. Hata Kaynağı target değerine sahipse bu, hedef/arka uç sunucusu tarafından Apigee'ye gönderilen yanıt yükü boyutunun Apigee Edge'deki izin verilen sınırdan daha büyük olduğunu gösterir.
3. 1. adımda belirlenen Yanıt Yükü Boyutu'nu doğrulayın.
   • Yük boyutu, izin verilen 10 MB sınırını aşıyorsa hatanın nedeni budur.
   • Yük boyutu, izin verilen sınır olan yaklaşık 10 MB ise yanıt yükünün sıkıştırılmış biçimde iletilmesi mümkündür. Neden: Yanıt yük boyutu, sıkıştırma açıldıktan sonra izin verilen sınırı aşıyor.
4. Aşağıdaki adımları uygulayarak gerçek yanıtı kontrol edip yanıt yükü boyutunun gerçekten de izin verilen 10 MB sınırından büyük olduğunu doğrulayın:
   1. Hedef/arka uç sunucusuna yapılan gerçek isteğe erişiminiz yoksa Çözüm bölümüne gidin.
   2. Hedef/arka uç sunucusuna yapılan gerçek isteğe erişiminiz varsa aşağıdaki adımları uygulayın:
      1. Herkese açık bulut/özel bulut kullanıcısıysanız arka uç sunucusundan veya arka uç sunucusuna istekte bulunmanıza izin verilen başka bir makineden doğrudan arka uç sunucusuna istekte bulunun.
      2. Özel bulut kullanıcısıysanız isteği Mesaj İşleyicilerden birinden arka uç sunucusuna da gönderebilirsiniz.
      3. Yanıtla iletilen yükün boyutunu Content-Length başlığını kontrol ederek doğrulayın.
      4. Yükün boyutunun Apigee Edge'de izin verilen sınırdan fazla olduğunu görürseniz sorunun nedeni budur.

   Arka uç sunucusundan örnek yanıt:

   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>

   Yukarıdaki örnekte, Apigee Edge'de izin verilen sınırı aştığı için bu hataya neden olan Content-Length: 11534336 (which is ~11 MB) öğesini görebilirsiniz.

Çözünürlük

Çözünürlük bölümüne bakın.

Neden: Yanıt yük boyutu, sıkıştırma açıldıktan sonra izin verilen sınırı aşıyor.

Yanıt yükü sıkıştırılmış biçimde gönderilirse ve yanıt başlığı Content-Encoding gzip, olarak ayarlanırsa Apigee yanıt yükünü açar. Apigee, sıkıştırmayı açma işlemi sırasında yük boyutunun Apigee Edge'de izin verilen sınırdan daha büyük olduğunu tespit ederse sıkıştırmayı açma işlemine devam etmez ve hemen 502 Bad Gateway ile protocol.http.TooBigBody hata koduyla yanıt verir.

Teşhis

1. API İzleme, İzleme Aracı veya NGINX Erişim günlükleri kullanılarak gözlemlenen hata için Hata Kodunu, Hata Kaynağını ve Yanıt Yükü boyutunu belirleyin. Bu işlem, Genel teşhis adımları bölümünde 2. senaryo ile açıklanmıştır.
2. Fault Source değeri target ise bu, hedef/arka uç uygulaması tarafından Apigee'ye gönderilen yanıt yükü boyutunun Apigee Edge'de izin verilen sınırdan daha büyük olduğunu gösterir.
3. 1. adımda belirlenen Yanıt Yükü Boyutu'nu doğrulayın.
   • Yük boyutu, izin verilen 10 MB sınırını aşıyorsa hatanın nedeni budur.
   • Yük boyutu, izin verilen sınır olan ~10 MB ise yanıt yükünün sıkıştırılmış biçimde iletilmesi mümkündür. Bu durumda, sıkıştırılmış yanıt yükünün sıkıştırılmamış boyutunu kontrol edin.
4. Aşağıdaki yöntemlerden birini kullanarak hedef/arka uçtan gelen yanıtın sıkıştırılmış biçimde gönderilip gönderilmediğini ve sıkıştırılmamış boyutun izin verilen sınırdan büyük olup olmadığını doğrulayabilirsiniz:

   Trace

   Trace aracını kullanma:

   1. Başarısız olan istek için izleme yakaladıysanız İzleme ve
      1. target.received.content.length değerini belirleyin.
      2. İstemciden gelen istekte Content-Encoding: gzip başlığının bulunup bulunmadığını doğrulayın.
   2. target.received.content.length değeri izin verilen 10 MB sınırına yakınsa ve yanıt başlığı Content-Encoding: gzip ise bu hatanın nedeni budur.

   Gerçek istek

   Gerçek isteği kullanma:

   1. Hedef/arka uç sunucusuna yapılan gerçek isteğe erişiminiz yoksa Çözüm bölümüne gidin.
   2. Hedef/arka uç sunucusuna yapılan gerçek isteğe erişiminiz varsa aşağıdaki adımları uygulayın:
      1. Yanıtta iletilen yükün boyutunu ve yanıtta gönderilen Content-Encoding üstbilgisini doğrulayın.
      2. Yanıt başlığının Content-Encoding, gzip olarak ayarlandığını ve yükün sıkıştırılmamış boyutunun Apigee Edge'de izin verilen sınırdan fazla olduğunu görürseniz bu hatanın nedeni budur.

         Arka uç sunucusundan alınan örnek yanıt:

         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>

         Yukarıdaki örnekte, Content-Encoding: gzip üstbilgisi gönderiliyor ve yanıttaki testzippedfile.gz dosyasının boyutu sınırdan küçük olmasına rağmen sıkıştırılmamış testzippedfile dosyasının boyutu yaklaşık 15 MB.

   Mesaj işleyici günlükleri

   Mesaj İşleyici günlüklerini kullanma:

   1. Özel bulut kullanıcısıysanız HTTP 502 hatalarıyla ilgili temel bilgileri belirlemek için Mesaj İşleyici günlüklerini kullanabilirsiniz.

   2. Mesaj İşleyici günlüklerini kontrol edin

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

   3. Belirli bir süre boyunca 502 hataları olup olmadığını (sorun geçmişte yaşandıysa) veya 502 ile hâlâ başarısız olan istekler olup olmadığını kontrol edin. Aşağıdaki arama dizelerini kullanabilirsiniz:

      grep -ri "chunkCount"
      

      grep -ri "BadGateway: Body buffer overflow"
      

   4. Aşağıdakine benzer system.log satırları görürsünüz (TotalRead ve chunkCount sizin durumunuzda farklı olabilir):

      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. Sıkıştırmayı açma işlemi sırasında, İleti İşleyici toplam okunan bayt sayısının 10 MB'tan fazla olduğunu belirlediği anda durur ve aşağıdaki satırı yazdırır:

      Message is too large. TotalRead 10489856 chunkCount 2571

      Bu, Yanıt Yükü Boyutu'nun 10 MB'tan büyük olduğu ve Apigee'nin, boyut 10 MB sınırını aşmaya başladığında hata kodu olarak protocol.http.TooBigBody ile hatayı gösterdiği anlamına gelir.

Çözünürlük

Sınırlar

Apigee, istemci uygulamasının ve arka uç sunucusunun, Apigee Edge Sınırları'nda Request/response size için belirtilen izin verilen sınırı aşan yük boyutları göndermemesini bekler.

1. Herkese açık bulut kullanıcısıysanız istek ve yanıt yükü boyutu için maksimum sınır, Request/response size için Apigee Edge Sınırları'nda belirtildiği gibidir.
2. Özel bulut kullanıcısıysanız istek ve yanıt yükü boyutu için varsayılan maksimum limiti değiştirmiş olabilirsiniz (önerilen bir uygulama olmasa da). Geçerli sınırı kontrol etme başlıklı makaledeki talimatları uygulayarak maksimum istek yükü boyutu sınırını belirleyebilirsiniz.

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

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

1. Mesaj İşleyici makinesinde HTTPResponse.body.buffer.limit özelliğini /opt/apigee/edge-message- processor/conf dizininde arayın ve aşağıda gösterildiği gibi hangi değerin ayarlandığını kontrol edin:

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

3. Yukarıdaki örnek çıktıda, HTTPResponse.body.buffer.limit özelliğinin http.properties içinde 10m değeriyle ayarlandığını unutmayın.

   Bu, Private Cloud için Apigee'de yapılandırılan istek yükü boyutu sınırının 10 MB olduğunu gösterir.

Apigee Destek Ekibi'nden hâlâ yardıma ihtiyacınız varsa Teşhis bilgilerini toplama 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ı
• Hedef/arka uç sunucudan gelen yanıtın tam çıktısı ve yükün boyutu

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 tam curl komutu
• Hedef/arka uç sunucudan gelen yanıtın tam çıktısı ve yükün boyutu

• 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