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 protocol.http.TooBigBody hata koduyla birlikte 502 Bad Gateway HTTP durum 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'de izin verilen sınırdan büyükse ortaya çıkar.

Hatanın olası nedenleri aşağıda açıklanmıştır:

Neden	Açıklama	Şunun için geçerli sorun giderme talimatları:
Yanıt yükü boyutu, izin verilen sınırdan büyük	Hedef/arka uç sunucusu tarafından Apigee'ye HTTP yanıtının bir parçası olarak gönderilen yük boyutu, Apigee'de izin verilen sınırın üzerindedir.	Edge Herkese Açık ve Özel Bulut kullanıcıları
Sıkıştırmayı açma sonrasında yanıt yükü boyutu, izin verilen sınırı aşıyor	Apigee'ye HTTP yanıtının bir parçası olarak hedef/arka uç sunucusu tarafından sıkıştırılmış biçimde gönderilen yük boyutu, Apigee tarafından sıkıştırıldığında izin verilen sınırı aşıyor.	Edge Herkese Açık ve Özel Bulut kullanıcıları

Yaygın 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 büyük

Teşhis

1. API İzleme, Trace aracı veya NGINX erişim günlükleri kullanılarak gözlemlenen hata için Hata Kodu, Hata Kaynağı ve Yanıt Yük Boyutu'nu, 1. Senaryo ile Yaygın teşhis adımları bölümünde açıklandığı şekilde belirleyin.
2. Hata Kaynağı target değerine sahipse hedef/arka uç sunucusu tarafından Apigee'ye gönderilen yanıt yükü boyutunun Apigee Edge'de izin verilen sınırdan daha büyük olduğu anlamına gelir.
3. 1. adımda belirlenen Yanıt Yük Boyutu'nu doğrulayın.
   • Yük boyutu 10 MB'tan büyükse hatanın nedeni budur.
   • Yük boyutu izin verilen sınır olan yaklaşık 10 MB ise yanıt yükü sıkıştırılmış biçimde aktarılabilir. Neden: Yanıt yükü boyutu, sıkıştırma açma işleminden sonra izin verilen sınırı aşıyor bölümüne gidin.
4. Aşağıdaki adımları uygulayıp gerçek yanıtı kontrol ederek yanıt yükü boyutunun gerçekten 10 MB'tan fazla izin verilen sınır olduğunu doğrulayın:
   1. Hedef/arka uç sunucusuna yapılan asıl isteğe erişiminiz yoksa Çözüm'e 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/Private Cloud kullanıcısıysanız arka uç sunucusuna veya arka uç sunucusuna istekte bulunmasına izin verilen başka bir makineden doğrudan arka uç sunucusuna istek gönderin.
      2. Private Cloud kullanıcısıysanız Mesaj İşleyicilerinin birinden arka uç sunucuya istek gönderebilirsiniz.
      3. Content-Length (İçerik Uzunluğu) başlığını kontrol ederek yanıtta iletilen yükün boyutunu doğrulayın.
      4. Yükün boyutunun Apigee Edge'de izin verilen sınırın üzerinde olduğunu görürseniz sorunun nedeni budur.

   Arka uç sunucudan gelen ö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ığından bu hatanın nedeninin Content-Length: 11534336 (which is ~11 MB) olduğunu görebilirsiniz.

Çözünürlük

Çözünürlük başlıklı makaleyi inceleyin.

Neden: Sıkıştırmayı açma sonrasında Yanıt Yük Boyutu 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 yanıt yükünü açar. Sıkıştırmayı açma işlemi sırasında Apigee, yük boyutunun Apigee Edge'de izin verilen sınırın üzerinde olduğunu tespit ederse sıkıştırmayı açma işlemini daha da durdurur ve hemen 502 Bad Gateway ve protocol.http.TooBigBody hata koduyla yanıt verir.

Teşhis

1. API İzleme,İzleme Aracı veya NGINX Erişim günlüklerini kullanarak gözlemlenen hata için Hata Kodu, Hata Kaynağı ve Yanıt Yükü boyutunu 2. Senaryo ile Yaygın teşhis adımları bölümünde açıklandığı şekilde belirleyin.
2. Hata Kaynağı target değerine sahipse 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ğu anlamına gelir.
3. 1. adımda belirlenen Yanıt Yük Boyutu'nu doğrulayın.
   • Yük boyutu 10 MB'tan büyükse hatanın nedeni budur.
   • Yük boyutu izin verilen sınır olan yaklaşık 10 MB ise yanıt yükü sıkıştırılmış biçimde aktarılabilir. Bu durumda, sıkıştırılmış yanıt yükünün sıkıştırılmamış boyutunu kontrol edin.
4. 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ı aşağıdaki yöntemlerden birini kullanarak doğrulayabilirsiniz:

   Trace

   İzleme aracını kullanarak:

   1. Başarısız olan istek için bir iz yakaladıysanız İzleme ve
      1. target.received.content.length değerini belirleyin
      2. İstemciden gelen isteğin Content-Encoding: gzip üstbilgisini içerip içermediğini doğrulayın
   2. target.received.content.length değeri, izin verilen 10 MB'lık sınıra yakınsa ve yanıt başlığı Content-Encoding: gzip ise bu hatanın nedeni budur.

   Gerçek istek

   Gerçek isteği kullanarak:

   1. Hedef/arka uç sunucusuna yapılan asıl isteğe erişiminiz yoksa Çözüm'e 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 gönderilen Content-Encoding başlığıyla birlikte yanıtta iletilen yükün boyutunu doğrulayın.
      2. Content-Encoding yanıt başlığının gzip olarak ayarlandığını ve yükün sıkıştırılmamış boyutunun Apigee Edge'de izin verilen sınırın üzerinde olduğunu görüyorsanız bu hatanın nedeni budur.

         Arka uç sunucudan 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 başlığı gönderilir ve yanıttaki testzippedfile.gz dosyasının boyutu sınırdan küçük olsa da sıkıştırılmamış testzippedfile dosyasının boyutu yaklaşık 15 MB'tır.

   Mesaj İşleyici günlükleri

   İleti İşleyici günlüklerini kullanma:

   1. Private Cloud kullanıcısıysanız HTTP 502 hatalarıyla ilgili önemli bilgileri belirlemek için Mesaj İşleyici günlüklerini kullanabilirsiniz.

   2. Message Processor günlüklerini kontrol etme

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

   3. Belirli bir süre boyunca 502 hatası olup olmadığını (sorun geçmişte olduysa) veya 502 nedeniyle başarısız olan isteklerin olup olmadığını görmek için arama yapın. Aşağıdaki arama dizelerini kullanabilirsiniz:

      grep -ri "chunkCount"
      

      grep -ri "BadGateway: Body buffer overflow"
      

   4. system.log alanında aşağıdakine benzer satırlar bulacaksınız (sizin için TotalRead ve chunkCount 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, Mesaj İşleyici toplam okunan bayt miktarının 10 MB'tan büyük olduğunu belirler belirlemez 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 anlamına gelir ve boyut protocol.http.TooBigBody olarak hata koduyla 10 MB sınırını aşmaya başladığında Apigee hata verir.

Çözünürlük

Sınırlar

Apigee, istemci uygulamasının ve arka uç sunucusunun Apigee Edge Sınırları bölümünde Request/response size için belirtildiği üzere izin verilen sınırın üzerinde yük boyutu 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ı bölümünde belirtildiği şekildedir.
2. Private Cloud kullanıcısıysanız istek ve yanıt yükü boyutu için varsayılan maksimum sınırı 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.

Geçerli sınır nasıl kontrol edilir?

Bu bölümde, HTTPResponse.body.buffer.limit özelliğinin Mesaj İşleyicilerde yeni bir değerle güncellendiğini nasıl doğrulayacağınız açıklanmaktadır.

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

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

2. Yukarıdaki komuttan alınan örnek sonuç aşağıdaki gibidir:

   /opt/apigee/edge-message-processor/conf/http.properties:HTTPResponse.body.buffer.limit=10m
   

3. Yukarıdaki örnek çıkışta, HTTPResponse.body.buffer.limit özelliğinin http.properties içinde 10m değeriyle ayarlandığına dikkat edin.

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

Apigee Desteği'nden hâlâ yardıma ihtiyacınız varsa Teşhis bilgilerini toplamalısınız başlıklı makaleyi inceleyin.

Teşhis bilgileri toplanmalı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 adı
• 502 hatasını yeniden oluşturmak için kullanılan tam curl komutu
• API istekleri için izleme dosyası
• Yükün boyutuyla birlikte hedef/arka uç sunucusundan alınan yanıtın tam çıktısı

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

• Başarısız istekler için gözlemlenen tam hata mesajı
• Kuruluş adı
• Ortam adı
• API Proxy paketi
• Başarısız API istekleri için izleme dosyası
• 502 hatasını yeniden oluşturmak için kullanılan tam curl komutu
• Yükün boyutuyla birlikte hedef/arka uç sunucusundan alınan yanıtın tam çıktısı

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

  Yer: 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