503 Hizmet Kullanılamıyor - Arka uç sunucusu tarafından erken kapatma

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

Belirti

İstemci uygulaması, bir API proxy çağrısının ardından Service Unavailable mesajıyla birlikte bir HTTP yanıt durumu 503 alır.

Hata mesajı

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

HTTP/1.1 503 Service Unavailable

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

{
   "fault": {
      "faultstring": "The Service is temporarily unavailable",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.ServiceUnavailable"
       }
    }
}

Olası nedenler

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

Başarısız olan isteğin ileti kimliğini belirleyin.

Neden: Hedef sunucu bağlantıyı erken kapatıyor

Teşhis

1. Herkese Açık Bulut veya Private Cloud kullanıcısıysanız:
   1. İzleme aracını kullanın (Yaygın teşhis adımları bölümünde açıklandığı gibi) ve Analytics Verileri Kaydedildi bölmesinde aşağıdakilerin her ikisinin de ayarlandığını doğrulayın:
      • X-Apigee.fault-code: messaging.adaptors.http.flow.ServiceUnavailable
      • X-Apigee.fault-source: target

      

   2. İzleme aracını kullanın (Yaygın teşhis adımları bölümünde açıklandığı gibi) ve TARGET_REQ_FLOW durum özelliğinden hemen sonra Hata bölmesinde aşağıdakilerin her ikisinin de ayarlandığını doğrulayın:
      • error.class: com.apigee.errors.http.server.ServiceUnavailableException
      • error.cause: Broken pipe

      

   3. Daha ayrıntılı inceleme için tcpdump kullanma bölümüne gidin.
2. Private Cloud kullanıcısıysanız:
   • Başarısız olan isteğin ileti kimliğini belirleyin.
   • Mesaj İşleyici günlüğünde ileti kimliğini arayın (/opt/apigee/var/log/edge-message-processor/logs/system.log).
   • Aşağıdaki istisnalardan birini görürsünüz:

     1. istisna: java.io.IOException: Broken pipe occurred while writing to channel ClientOutputChannel

     2021-01-30 15:31:14,693 org:anotherorg env:prod api:myproxy
     rev:1 messageid:myorg-opdk-test-1-30312-13747-1  NIOThread@1
     INFO  HTTP.SERVICE - ExceptionHandler.handleException() :
     Exception java.io.IOException: Broken pipe occurred while writing to channel
     ClientOutputChannel(ClientChannel[Connected:
     Remote:IP:PORT Local:0.0.0.0:42828]@8380 useCount=1
     bytesRead=0 bytesWritten=76295 age=2012ms  lastIO=2ms  isOpen=false)

     veya

     2. istisna: onExceptionWrite exception: {}
     java.io.IOException: Broken pipe

     2021-01-31 15:29:37,438 org:anotherorg env:prod api:503-test
     rev:1 messageid:leonyoung-opdk-test-1-18604-13978-1
     NIOThread@0 ERROR HTTP.CLIENT - HTTPClient$Context$2.onException() :
     ClientChannel[Connected: Remote:IP:PORT
     Local:0.0.0.0:57880]@8569 useCount=1 bytesRead=0 bytesWritten=76295 age=3180ms  lastIO=2
     ms  isOpen=false.onExceptionWrite exception: {}
     java.io.IOException: Broken pipe

   • Bu iki istisna da, Mesaj İşleyici istek yükünü arka uç sunucusuna yazmaya devam ederken bağlantının arka uç sunucusu tarafından erken kapatıldığını gösterir. Bu nedenle, Mesaj İşleyici java.io.IOException: Broken pipe istisnasını oluşturur.
   • Remote:IP:PORT , çözümlenen arka uç sunucusu IP adresini ve bağlantı noktası numarasını gösterir.
   • Yukarıdaki hata mesajındaki bytesWritten=76295 özelliği, bağlantı erken kapatıldığında Mesaj İşleyici'nin arka uç sunucusuna 76295 baytlık bir yük gönderdiğini gösterir.
   • Bu özellikbytesRead=0 , Mesaj İşleyici'nin arka uç sunucusundan herhangi bir veri (yanıt) almadığını gösterir.
   • Bu sorunu daha ayrıntılı bir şekilde incelemek için tcpdump arka uç sunucusunda veya mesaj işlemcisinde toplayın ve aşağıda açıklandığı şekilde analiz edin.

tcpdump'ı kullanma

1. Aşağıdaki komutlarla arka uç sunucusunda veya Mesaj İşleyici'de bir tcpdump yakalayın:

   Arka uç sunucusunda tcpdump toplama komutu:

   tcpdump -i any -s 0 host MP_IP_ADDRESS -w FILE_NAME
   

   Mesaj işleyicide tcpdump toplama komutu:

   tcpdump -i any -s 0 host BACKEND_HOSTNAME -w FILE_NAME
   

2. Yakalanan tcpdump öğelerini analiz edin:

   Örnek tcpdump çıkışı (Mesaj İşleyici'de toplanmıştır):

   

   Yukarıdaki tcpdump içinde şunları görebilirsiniz:

   1. 4 paketinde, Mesaj İşleyici, arka uç sunucusuna POST isteği gönderdi.
   2. 5, 8, 9, 10, 11 paketinde, mesaj işlemci, istek yükünü arka uç sunucuya göndermeye devam etti.
   3. 6 ve 7 paketlerinde, arka uç sunucusu, Mesaj İşleyici'den alınan istek yükünün bir bölümü için ACK ile yanıt verdi.
   4. Ancak 12 paketinde, alınan uygulama veri paketleri için ACK ile yanıt vermek ve ardından yanıt yüküyle yanıt vermek yerine arka uç sunucusu, bağlantının kapatılmasını başlatan bir FIN ACK ile yanıt veriyor.
   5. Bu, Mesaj İşleyici istek yükünü göndermeye devam ederken arka uç sunucunun bağlantıyı erken kapattığını açıkça gösterir.
   6. Bu durum, Mesaj İşleyici'nin bir IOException: Broken Pipe hata kaydetmesine ve istemciye 503 döndürmesine neden olur.

Çözünürlük

1. Arka uç sunucu tarafındaki erken bağlantı kesilmesi sorununu analiz edip düzeltmek için uygulama ve/veya ağ ekiplerinizle birlikte çalışın.
2. Arka uç sunucu uygulamasının, isteğin tamamı alınmadan önce bağlantının zaman aşımına uğramadığından veya bağlantıyı sıfırlamadığından emin olun.
3. Apigee ile arka uç sunucusu arasında herhangi bir ara ağ cihazınız veya katmanınız varsa tüm istek yükü alınmadan önce zaman aşımına uğramadıklarından emin olun.

Sorun devam ederse Toplanması gereken teşhis bilgileri bölümüne gidin.

Teşhis bilgilerini toplamalıdır

Yukarıdaki talimatları uyguladıktan sonra sorun devam ederse aşağıdaki teşhis bilgilerini toplayın ve 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ı
• 503 hatasını yeniden oluşturmak için curl komutunu tamamlayın.
• 503 Service Unavailable hatasıyla ilgili isteği içeren izleme dosyası
• 503 hataları şu anda oluşmuyorsa geçmişte 503 hatalarının oluştuğu zaman aralığını saat dilimi bilgisiyle birlikte belirtin.

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ı
• Gözlemlediğiniz kuruluş, ortam adı ve API proxy adı 503 hataları
• API proxy paketi
• 503 Service Unavailable hatası içeren istekleri içeren izleme dosyası
• NGINX erişim günlükleri
  /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log
• Mesaj işleyici günlükleri
  /opt/apigee/var/log/edge-message-processor/logs/system.log
• 503 hatalarının oluştuğu saat dilimi bilgisiyle birlikte zaman aralığı
• Hata oluştuğunda Mesaj İşleyiciler ve arka uç sunucusunda toplanan Tcpdumps