503 Hizmet Kullanılamıyor

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

Videolar

503 hatalarıyla ilgili daha fazla bilgi için aşağıdaki videolara bakın:

Video	Açıklama
DNS sorunu nedeniyle 503 Hizmet Kullanılamıyor Hatası ile ilgili sorunları giderme ve bu hatayı çözme	Aşağıdakiler hakkında bilgi edinin: Apigee Edge'de DNS çözümlemesi ve ağ ile ilgili sorunlardan kaynaklanan 503 Hizmet Kullanılamıyor hatası DNS çözümleme sorunundan kaynaklanan gerçek zamanlı 503 Hizmet Kullanılamıyor hatasıyla ilgili sorunları giderme ve çözme
Ağ sorunu nedeniyle 503 Hizmet Kullanılamıyor Hatası ile ilgili sorunları giderme ve bu hatayı çözme	Apigee Edge'de ağ sorunundan kaynaklanan gerçek zamanlı 503 Hizmet Kullanılamıyor Hatası ile ilgili sorunları giderme ve çözme

Belirti

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

Hata mesajları

Şu 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

messaging.adaptors.http.flow.ServiceUnavailable hata koduyla 503 Service Kullanılamıyor HTTP yanıtı, Apigee Edge'in Mesaj İşleyicisi arka uç sunucusuyla iletişim kurarken bağlantı zaman aşımına, yanlış ana makine adı veya SSL el sıkışma hataları nedeniyle hatalarla karşılaşırsa oluşur.

503 Hizmet Kullanılamıyor yanıtının olası nedenleri şunlardır:

Neden	Açıklama	Sorun giderme adımlarını kimler uygulayabilir?
Yanlış DNS çözümlemesinden kaynaklanan bağlantı hataları	Hedef sunucunun DNS çözümlemesi, bağlantı hatalarına neden olan bozuk IP adreslerine neden oldu.	Edge Private Cloud kullanıcıları
Bağlantı hataları	Ağ veya bağlantı sorunları, istemcinin sunucuya bağlanmasını engelliyor.	Edge Private Cloud kullanıcıları
Hatalı hedef sunucu ana makine adı	Belirtilen hedef sunucu ana makinesi yanlış veya istenmeyen karakterler (ör. boşluk) içeriyor.	Edge Herkese Açık ve Özel Bulut kullanıcıları
SSL el sıkışma hataları	İstemci ile sunucu arasındaki TLS/SSL el sıkışması başarısız oldu. (Bu sınıftaki sorun giderme işlemleri ayrı bir konuda ele alınmıştır.)	Edge Herkese Açık ve Özel Bulut kullanıcıları

Yaygın teşhis adımları

Başarısız isteğin ileti kimliğini belirleme

Yanlış DNS çözümlemesinden kaynaklanan bağlantı hataları

Teşhis

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

   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ında çözülmüş 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ı'na gidin.
4. IP adresi geçersizse bunun nedeni büyük olasılıkla DNS çözümlemeyle ilgili sorunlar olabilir.
5. Başarısız olan birkaç API isteği daha için 3. ve 4. adımı tekrarlayın ve aynı IP adresini veya başka geçersiz IP adreslerini görüp görmediğinizi doğrulayın.
6. İleti İşleyici günlüğünde (/opt/apigee/var/log/edge-message-processor/logs/system.log) DNS Yenile anahtar sözcüğünü içeren iletileri arayın. İleti İşleyici'de DNS önbelleğine ara sıra hatalı veya geçersiz IP adreslerinin 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ı veya /etc/resolv.conf politikasında yapılandırılan alan adı sunucularıyla ilgili herhangi bir sorun oluştuğunda ortaya çıkabilir.
   
   Genellikle DNS çözümlemesini gerçekleştirecek şekilde yapılandırılmış bir veya daha fazla yetkili DNS sunucusu olabilir. Yetkili DNS sunucusu yoksa /etc/resolv.conf yapılandırma ayarına geri döner ve DNS çözümlemesini uygun şekilde gerçekleştirir. Örneğin: /etc/resolv.conf belirli alan adı sunucularını kullanacak şekilde yapılandırılmışsa DNS çözümlemesi için bu alan adı sunucuları kullanılır.
8. /etc/resolv.conf politikasında belirtilen yetkili DNS sunucuları veya ad sunucularıyla ilgili herhangi bir sorun varsa arka uç sunucusunun ana makine adları hatalı/geçersiz IP adreslerine çözümlenir. Bu durumda hatalı/geçersiz IP adresleri, İleti İşleyici'nin DNS önbelleğinde depolanır.
   1. /etc/resolv.conf politikasında belirtilen yetkili DNS sunucuları veya ad sunucularıyla ilgili sorun devam ederse bozuk/geçersiz IP adresleri, İleti İşleyici'nin DNS önbelleğinde kalmaya devam eder. Hatalı IP adresleri, İleti İşleyici'nin DNS önbelleğinde depolandığı sürece, belirli bir arka uç sunucusunu kullanan tüm bu API'lere yönelik istekler 503 hatasıyla başarısız olur.
   2. /etc/resolv.conf politikasında belirtilen yetkili DNS sunucuları veya ad sunucularıyla ilgili sorun aralıklı olarak yaşanıyorsa iyi ve kötü IP adresleri aralıklı olarak DNS önbelleğinde depolanır. Bu durumda, belirli arka uç sunucusunu kullanan tüm API'ler için aralıklı olarak 503 hataları görürsünüz.
9. DNS sunucularıyla ilgili sorun devam ediyorsa, kesintisiz hatalar görürsünüz. DNS sunucularıyla ilgili sorun aralıklı olarak oluşuyorsa, aralıklarla meydana gelen hatalar görürsünüz. Yani arka uç sunucusu ana makine adı, hatalı IP adreslerine çözümlendiğinde 503 hataları görürsünüz. Arka uç sunucusu ana makine adları iyi IP adreslerine çözümlendiğinde ise başarılı yanıtlar olduğunu görürsünüz.

Çözünürlük

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

1. Yetkili DNS sunucularınızla veya /etc/resolv.conf politikasında belirtilen alan adı sunucularınızla ilgili bir sorun varsa bu sorunu gidermek için sorunu ilgili sunucuyla düzeltin.
2. İleti İşleyicileri bulunan sistemlerde /etc/resolv.conf bölümündeki yapılandırmayla ilgili sorun varsa yapılandırma sorununu düzeltin.

Bağlantı hataları

Apigee Edge Mesaj İşleyicisi bir arka uç sunucusuna bağlanmaya çalıştığında ve aşağıdaki sorunlardan biri ortaya çıktığında bağlantı hatası oluşur:

• İleti İş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 isteğin ileti kimliğini belirleyin.
2. Mesaj İşleyici günlüğünde (/opt/apigee/var/log/edge-message-processor/logs/system.log) ilgili istek mesajı kimliğini arayın. Aşağıdaki hataları görebilirsiniz:
   1. onConnectTimeout hatası, Mesaj İşleyicinin önceden ayarlanmış bağlantı zaman aşımı süresi içinde arka uç sunucusuna bağlanamadığını belirtir.

      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 reddedildi (Bağlantı reddedildi) 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, Mesaj İşleyicilerin her birinden doğrudan belirli arka uç sunucusuna bağlanıp bağlanamadığınızı kontrol edin:
   1. Arka uç sunucusu tek bir IP adresine çözümlenirse aşağıdaki komutu kullanın:

      telnet BackendServer-IPaddress 443
                

   2. Arka uç sunucusu birden fazla IP adresine çözümlenirse telnet komutunda arka uç sunucunun ana makine adını aşağıda gösterildiği 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 bir arka uç sunucusunda izin verilenler listesine eklenmemiş olması olabilir.

Çözünürlük

Edge Mesaj İşleyicilerinden gelen trafiğin arka uç sunucunuza erişmesine izin vermek için ilgili arka uç sunucusunda Mesaj İşleyici'nin IP adreslerine erişim verin. Örneğin, Linux'ta, Mesaj İşleyicinin IP adreslerinden gelen trafiğe izin vermek için arka uç sunucudaki iptables komutunu 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 Desteği ile iletişime geçin.

Hedef sunucu ana makine adı yanlış

Teşhis

Hedef sunucuda belirtilen ana makine adı yanlışsa şu hata koduyla birlikte 503 Hizmet Kullanılamıyor yanıtı 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 ya da ö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 inceleyip hedef sunucu ana makine adının doğru şekilde oluşturulduğundan emin olun.

SSL el sıkışma hataları

Sorun giderme başucu kitabının tamamı TLS/SSL el sıkışma hatalarına ayrılmıştır. SSL El Sıkışma Hataları başlıklı makaleye göz atın.

Sorunun kaynağını belirleme

Gelen (kuzey giden) veya giden (güne giden) bağlantıda belirli türlerde hatalar oluşabilir. İstemci uygulaması ile Edge arasında bir gelen (kuzine giden) hatası oluşur. Edge ile arka uç hedef sunucusu arasında giden (güne giden) bir hata oluşur. Bu tür sorunları teşhis etmek için yapmanız gereken ilk şey hatanın kuzey sınırında mı yoksa güneydeki bağlantıda mı ortaya çıktığını belirlemektir.

Kuzey ve güneye yönelik bağlantıları anlama

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

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

Edge Herkese Açık Bulut kullanıcısıysanız muhtemelen Yönlendirici veya Mesaj İşleyici gibi dahili bileşenlerden haberdar değilsinizdir. Bu dahili bileşenler, Herkese Açık Bulut kullanıcıları tarafından görülemez veya bunlara erişilemez. Mümkün olduğu durumlarda, sorunu incelemek için bu bileşenlere doğrudan erişim gerektirmeyen alternatif yollar sunarız.

Aşağıdaki şekilde Apigee Edge'in kuzeye ve güneye bağlantıları gösterilmektedir.

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

Kuzey sınırında mı yoksa güneye giden bağlantıda mı 503 Hizmet Kullanılamıyor hatasının oluşup oluşmadığını belirlemek için aşağıdaki prosedürlerden birini kullanın.