503 Hizmet Kullanılamıyor

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

Videolar

503 hataları hakkında daha fazla bilgi edinmek için aşağıdaki videolara göz atın:

Belirti

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

Hata mesajları

Aşağıdaki hata mesajını görebilirsiniz:

HTTP/1.1 503 Service Unavailable
      

HTTP yanıtında aşağıdaki hata mesajını da görebilirsiniz:

Hizmet kullanılamıyor

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

Olası nedenler

Arka uç sunucuyla iletişim kurulurken bağlantı zaman aşımı, yanlış ana makine adı veya SSL el sıkışma hataları nedeniyle Apigee Edge'in Message Processor'ı hatalarla karşılaşırsa hata kodu messaging.adaptors.http.flow.ServiceUnavailable olan HTTP yanıtı 503 Service Unavailable oluşur.

503 Service Unavailable yanıtının olası nedenleri şunlardır:

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

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

Yanlış DNS çözümlemesi nedeniyle bağlantı hataları

Teşhis

1. Başarısız olan isteğin mesaj kimliğini belirleyin.
2. Mesaj İşleyici günlüğünde (/opt/apigee/var/log/edge-message-processor/logs/system.log) belirli istek iletisi kimliğini arayın. Aşağıdaki hataları görebilirsiniz:
   
   Bir onConnectTimeout hatası, Mesaj İşleyici'nin önceden ayarlanmış bağlantı zaman aşımı süresi (varsayılan: 3 saniye) içinde arka uç sunucusuna bağlanamadığını gösterir.

   2019-08-14 09:11:49,314 org:myorg env:prod api:Employees rev:1 messageid:mo-96cf6757a-9401-21-1 NIOThread@0 ERROR HTTP.CLIENT - HTTPClient$Context.onTimeout() : ClientChannel[Connected:]@164162 useCount=1 bytesRead=0 bytesWritten=0 age=3001ms lastIO=3001ms .onConnectTimeout connectAddress=www.abc.com/11.11.11.11  resolvedAddress=www.abc.com/22.22.22.22
   
   2019-08-14 09:11:49,333 org:myorg env:prod api:Employees rev:1 messageid:mo-96cf6757a-9401-21-1 NIOThread@0 ERROR ADAPTORS.HTTP.FLOW - RequestWriteListener.onTimeout() : RequestWriteListener.onTimeout(HTTPRequest@6b393600)
         

3. onConnectTimeout hatasındaki çözümlenen IP adresini not edin ve IP adresinin arka uç sunucunuz için geçerli olup olmadığını kontrol edin. IP adresi geçerliyse Bağlantı Hataları bölümüne gidin.
4. IP adresi geçersizse büyük olasılıkla DNS çözümleme ile ilgili sorunlardan kaynaklanıyordur.
5. Başarısız olan birkaç API isteği için 3. ve 4. adımları tekrarlayın ve aynı veya başka geçersiz IP adreslerini görüp görmediğinizi doğrulayın.
6. Anahtar kelime olarak DNS Yenileme'yi içeren mesajları bulmak için Mesaj İşleyici günlüğünde (/opt/apigee/var/log/edge-message-processor/logs/system.log) arama yapın. Kötü veya geçersiz IP adreslerinin, Mesaj İşleyici'deki DNS önbelleğine zaman zaman eklenip eklenmediğini kontrol edin.

   2019-08-14 09:11:49,314 org:myorg env:prod api:Employees rev:1 messageid:mo-96cf6757a-9401-21-1 NIOThread@0 INFO c.a.p.h.d.DNSCachedAddress - DNSCachedAddress.reportDifferences() : DNS Refresh for host: apitarget-uat.schemeweb.co.uk:4436. Added 2 IPs [www.abc.com/22.22.22.22, www.abc.com/33.33.33.33] Removed 1 IPs [www.abc.com/11.11.11.11]
         

7. Bu sorun, yetkili DNS sunucularında veya /etc/resolv.conf içinde yapılandırılan ad sunucularında sorun olması durumunda ortaya çıkabilir.
   
   Genellikle, DNS çözümlemesi gerçekleştirmek için bir veya daha fazla yetkili DNS sunucusu yapılandırılabilir. Yetkili DNS sunucusu yoksa /etc/resolv.conf bölümünde yapılandırılan ayarlar kullanılır ve DNS çözümlemesi uygun şekilde gerçekleştirilir. Örneğin: /etc/resolv.conf belirli ad sunucularını kullanacak şekilde yapılandırılmışsa DNS çözümlemesi yapmak için bu ad sunucuları kullanılır.
8. /etc/resolv.conf içinde belirtilen yetkili DNS sunucularında veya ad sunucularında herhangi bir sorun varsa arka uç sunucusu ana makine adları kötü/geçersiz IP adreslerine çözümlenir. Kötü/geçersiz IP adresleri daha sonra mesaj işleyicinin DNS önbelleğinde depolanır.
   1. /etc/resolv.conf içinde belirtilen yetkili DNS sunucuları veya alan adı sunucularıyla ilgili sorun devam ederse kötü/geçersiz IP adresleri, Mesaj İşleyici'nin DNS önbelleğinde kalmaya devam eder. Kötü IP adresleri, Mesaj İşleyicinin DNS önbelleğinde depolandığı sürece, belirli bir arka uç sunucuyu kullanan tüm API'lere yönelik istekler 503 hatasıyla başarısız olur.
   2. /etc/resolv.conf içinde belirtilen yetkili DNS sunucuları veya ad sunucularıyla ilgili sorun aralıklı olarak yaşanıyorsa iyi ve kötü IP adresleri DNS önbelleğinde aralıklı olarak depolanır. Bu durumda, belirli bir arka uç sunucusunu kullanan tüm API'lerde aralıklı olarak 503 hataları görürsünüz.
9. DNS sunucularıyla ilgili sorun devam ederse sürekli olarak başarısızlıklar görürsünüz. DNS sunucularıyla ilgili sorun aralıklı olarak yaşanıyorsa aralıklı hatalar görürsünüz. Yani, arka uç sunucusunun ana makine adı kötü IP adreslerine çözümlendiğinde 503 hataları görürsünüz. Ayrıca, arka uç sunucusu ana makine adları iyi IP adreslerine çözümlendiğinde başarılı yanıtlar alırsınız.

Çözünürlük

Lütfen işletim sistemi yöneticinizle birlikte çalışarak DNS sunucularıyla ilgili sorunları düzeltin.

1. /etc/resolv.conf içinde belirtilen yetkili DNS sunucularınız veya ad sunucularınızla ilgili bir sorun varsa bu sorunu gidermek için uygun sunucuyla ilgili sorunu düzeltin.
2. Mesaj işlemcilerinin bulunduğu sistemlerde /etc/resolv.conf yapılandırmasıyla ilgili bir sorun varsa yapılandırma sorununu düzeltin.

Bağlantı hataları

Apigee Edge Mesaj İşleyici bir arka uç sunucusuna bağlanmaya çalıştığında ve aşağıdaki sorunlardan biri oluştuğunda bağlantı hatası meydana gelir:

• Mesaj İşleyici, önceden ayarlanmış bağlantı zaman aşımı süresi içinde bağlanamıyor. (Varsayılan: 3 saniye)
• Arka uç sunucusu bağlantıyı reddediyor.

Teşhis

1. Başarısız olan isteğin mesaj kimliğini belirleyin.
2. Mesaj İşleyici günlüğünde (/opt/apigee/var/log/edge-message-processor/logs/system.log) belirli istek ileti kimliğini arayın. Aşağıdaki hataları görebilirsiniz:
   1. onConnectTimeout hatası, Mesaj İşlemcisinin önceden ayarlanmış bağlantı zaman aşımı süresi içinde arka uç sunucuya bağlanamadığını gösterir.

      2016-06-23 09:11:49,314 org:myorg env:prod api:Employees rev:1 messageid:mo-96cf6757a-9401-21-1 NIOThread@2 ERROR HTTP.CLIENT - HTTPClient$Context.onTimeout() : ClientChannel[C:]@10 useCount=1 bytesRead=0 bytesWritten=0 age=3001ms lastIO=3001ms .onConnectTimeout connectAddress=www.abc.com/11.11.11.11:80 resolvedAddress=www.abc.com/11.11.11.11
      2016-06-23 09:11:49,333 org:myorg env:prod api:Employees rev:1 messageid:mo-96cf6757a-9401-21-1 NIOThread@2 ERROR ADAPTORS.HTTP.FLOW - RequestWriteListener.onTimeout() : RequestWriteListener.onTimeout(HTTPRequest@6b393600)

   2. java.net.ConnectException: Connection refused hatası, bağlantının arka uç sunucusu tarafından reddedildiğini gösterir.

      14:40:16.531 +0530
      2016-06-17 09:10:16,531 org:myorg env:prod api:www.abc.com rev:1 rrt07eadn-22739-40983870-15 NIOThread@2 ERROR HTTP.CLIENT - HTTPClient$Context.onConnectFailure() : connect to www.abc.com:11.11.11.11:443 failed with exception {}
      java.net.ConnectException: Connection refused
      at sun.nio.ch.SocketChannelImpl.checkConnect(Native Method) ~[na:1.7.0_75]
      at sun.nio.ch.SocketChannelImpl.finishConnect(SocketChannelImpl.java:739) ~[na:1.7.0_75]
      at com.apigee.nio.ClientChannel.finishConnect(ClientChannel.java:121) ~[nio-1.0.0.jar:na]
      at com.apigee.nio.handlers.NIOThread.run(NIOThread.java:108) ~[nio-1.0.0.jar:na]

3. telnet komutunu kullanarak belirli bir arka uç sunucusuna her bir ileti işlemcisinden doğrudan bağlanıp bağlanamadığınızı kontrol edin:
   1. Arka uç sunucusu tek bir IP adresine çözümleniyorsa aşağıdaki komutu kullanın:

      telnet BackendServer-IPaddress 443
                

   2. Arka uç sunucusu birden fazla IP adresine çözümleniyorsa telnet komutunda arka uç sunucusunun ana makine adını aşağıdaki gibi kullanın:

      telnet BackendServer-HostName 443
                

4. Arka uç sunucusuna bağlanabiliyorsanız Connected to backend-server gibi bir mesaj görebilirsiniz. Arka uç sunucusuna bağlanamıyorsanız bunun nedeni, Mesaj İşleyicilerin IP adreslerinin belirli arka uç sunucusunda izin verilenler listesine eklenmemiş olması olabilir.

Çözünürlük

Uç Mesaj İşleyicileri'nden gelen trafiğin arka uç sunucunuza erişmesine izin vermek için belirli arka uç sunucusunda Mesaj İşleyicisi'nin IP adreslerine erişim izni verin. Örneğin, Linux'ta arka uç sunucusunda ileti işlemcisinin IP adreslerinden gelen trafiğe izin vermek için iptables'ı kullanabilirsiniz.

Sorun devam ederse sorunu belirlemek ve düzeltmek için ağ yöneticinizle birlikte çalışın. Apigee'den daha fazla yardıma ihtiyacınız olursa Apigee Destek Ekibi ile iletişime geçin.

Hedef sunucunun ana makine adı yanlış

Teşhis

Hedef sunucuda belirtilen ana makine adı yanlışsa 503 Service Unavailable yanıtını hata koduyla birlikte alabilirsiniz. messaging.adaptors.http.flow.ServiceUnavailable.

Çözünürlük

1. Hedef uç nokta yapılandırmasında veya hedef sunucu tanımında belirtilen hedef sunucu ana makine adının doğru olduğundan ve istenmeyen boşluk veya özel karakter içermediğinden emin olun.
2. Hedef sunucu ana makine adını dinamik olarak oluşturmak için herhangi bir AssignMessage/JavaScript politikası kullanıyorsanız politika tanımını ve kodu inceleyin ve hedef sunucu ana makine adının doğru şekilde oluşturulduğundan emin olun.

SSL el sıkışma hataları

TLS/SSL el sıkışma hatalarına yönelik eksiksiz bir sorun giderme kılavuzu bulunmaktadır. SSL El Sıkışma Hataları başlıklı makaleyi inceleyin.

Sorunun kaynağını belirleme

Belirli hata türleri gelen (kuzeye doğru) veya giden (güneye doğru) bağlantıda oluşabilir. İstemci uygulaması ile Edge arasında gelen (kuzeye giden) bir hata oluşur. Edge ile arka uç hedef sunucusu arasında giden (güney yönlü) bir hata oluşur. Bu tür sorunları teşhis etmek için ilk olarak hatanın kuzeye veya güneye giden bağlantıda mı oluştuğunu belirlemeniz gerekir.

Kuzeye ve güneye doğru bağlantıları anlama

Edge'de, gelen veya giden bağlantıda 503 Hizmet Kullanılamıyor hatasıyla karşılaşabilirsiniz:

• Gelen (veya kuzeye doğru) bağlantı: İstemci uygulaması ile Edge yönlendirici arasındaki bağlantı. Yönlendirici, sisteme yapılan gelen istekleri işleyen Apigee Edge bileşenidir.
• Giden (veya güneye doğru) bağlantı: Edge Mesaj İşleyici ile arka uç sunucusu arasındaki bağlantı. Mesaj İşleyici, API isteklerini arka uç hedef sunucularına yönlendiren Apigee Edge'in bir bileşenidir.

Edge Public Cloud kullanıcısıysanız yönlendirici veya mesaj işlemcisi gibi dahili bileşenlerin farkında olmayabilirsiniz. Bu dahili bileşenler, herkese açık bulut kullanıcıları tarafından görülemez veya bunlara erişilemez. Mümkün olduğunda, bu bileşenlere doğrudan erişim gerektirmeyen alternatif yöntemler sunarak sorunu araştırmanıza yardımcı oluruz.

Aşağıdaki şekilde, Apigee Edge için kuzeye ve güneye doğru bağlantılar gösterilmektedir.

503 Hizmet Kullanılamıyor hatasının nerede oluştuğunu belirleme

503 Hizmet Kullanılamıyor hatasının kuzey yönlü veya güney yönlü bağlantıda oluşup oluşmadığını belirlemek için aşağıdaki prosedürlerden birini kullanın.