G/Ç zaman aşımını yapılandırmayla ilgili en iyi uygulamalar

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

İstemci uygulamaları tarafından yapılan API istekleri, arka uç hizmetlerine ulaşmadan önce Apigee Edge'deki çeşitli bileşenlerden geçer. Çoğu istemci uygulaması, bu isteklere verilen yanıtların zamanında alınmasını bekler.

Zamanında yanıt verilmesi için API isteklerinin geçtiği her bileşende G/Ç zaman aşımı değerleri ayarlanır. Akıştaki bileşenlerden herhangi biri, önceki bileşenden daha fazla zaman alırsa önceki bileşen zaman aşımına uğrar ve 504 Ağ Geçidi Zaman Aşımı hataları ile yanıt verir.

Zaman aşımını yapılandırırken değerler, bileşenlerin her birinde son derece dikkatli bir şekilde yapılandırılmalıdır. Aksi takdirde, 504 Ağ Geçidi Zaman Aşımı hatalarına neden olabilir.

Bu belgede, Apigee Edge'de API isteklerinin akışı için kullanılan çeşitli bileşenlerde G/Ç zaman aşımını yapılandırmayla ilgili en iyi uygulamalar açıklanmaktadır.

G/Ç zaman aşımını yapılandırmayla ilgili en iyi uygulamalar

G/Ç zaman aşımını yapılandırırken aşağıdaki en iyi uygulamaları göz önünde bulundurun:

  • Birinci bileşen: API isteği akışındaki ilk bileşende, yani Apigee Edge'deki İstemci Uygulaması her zaman en yüksek zaman aşımını kullanın.
  • Son bileşen: API istek akışındaki son bileşende (Apigee Edge'deki Arka Uç Hizmeti) her zaman en düşük zaman aşımını kullanın.
  • Bileşenler arasında: Her bileşende yapılandırılan zaman aşımı değerinde, akıştaki ilk bileşen ile son bileşen arasında en az 2-3 saniyelik bir fark olduğundan emin olun.
  • Yönlendirici: Yönlendirici üzerinde yapılandırmak yerine belirli bir sanal ana makine için G/Ç zaman aşımı değerinin yapılandırılması (değiştirilmesi) her zaman iyi bir uygulamadır. Bu, yeni zaman aşımı değerinin, Yönlendirici tarafından sunulan tüm API Proxy'lerini değil, yalnızca belirli sanal ana makineyi kullanan API Proxy'lerini etkilemesini sağlar.

    Yalnızca yeni G/Ç zaman aşımı değerinin Yönlendiricide çalışan tüm API Proxy'leri için gerekli veya geçerli olduğundan emin olduğunuzda yönlendiricideki G/Ç zaman aşımını yapılandırın (değiştirin).

  • Mesaj İşleyici: G/Ç zaman aşımı değerini Mesaj İşleyicide yapılandırmak yerine belirli bir API proxy'si için yapılandırmak (değiştirmek) her zaman iyi bir uygulamadır. Bu, yeni zaman aşımı değerinin Mesaj İşleyici tarafından sunulan tüm API proxy'lerini değil, yalnızca belirli API proxy'sini etkilemesini sağlar.

    Yalnızca yeni G/Ç zaman aşımı değerinin Mesaj İşleyici'de çalışan tüm API Proxy'leri için gerekli veya geçerli olduğundan kesinlikle emin olduğunuzda Mesaj İşleyici'deki G/Ç zaman aşımını yapılandırın (değiştirin).

Örnek senaryolar

Bu bölümdeki senaryolar, G/Ç zaman aşımı değerlerini doğru şekilde nasıl belirleyeceğinizi anlamanıza yardımcı olabilir.

1. Senaryo: Doğrudan istemci uygulamalarından Apigee Edge'e yapılan istekler

Bu bölümde, istemci uygulaması ile Apigee Edge ve Apigee Edge ile arka uç sunucunuz arasında ara bileşen bulunmayan Apigee Edge kurulumunda zaman aşımı değerlerini ayarlarken izlenecek en iyi uygulamalar açıklanmaktadır.

Ara bileşen içermeyen örnek Apigee kurulumu

İstemciden başlayıp Yönlendirici'ye, ardından Mesaj İşleyici'ye ve ardından Arka Uç Sunucusu'na giden akış

Apigee Edge, yukarıdaki şemada gösterildiği gibi ara bileşen olmadan ayarlandıysa aşağıdaki en iyi uygulamalardan yararlanın:

  1. Akıştaki ilk bileşen istemci uygulamasıdır. İstemcide en yüksek zaman aşımı değeri ayarlanmalıdır.
  2. Arka uç sunucusu, akıştaki son bileşendir. En düşük zaman aşımı değeri arka uç sunucuda ayarlanmalıdır.
  3. Her bir bileşendeki zaman aşımı değerlerini aşağıdaki sırayla yapılandırın:

    İstemcide zaman aşımını, Yönlendirici'yi, ardından Mesaj İşleyiciyi ve sonra Arka Uç Sunucusu'nu yapılandırın

    Aşağıdaki örnekte, sorunlardan kaçınmak için çeşitli bileşenlerde yukarıda verilen yönergeler doğrultusunda ayarlanan zaman aşımı değerleri gösterilmektedir:

    İstemcide 60. saniyede zaman aşımını, ardından 57. saniyede Yönlendiriciyi, 55. saniyede Mesaj İşleyiciyi, sonra da 52. saniyede Arka Uç Sunucusu'nu yapılandırın

2. Senaryo: Ara bileşenler aracılığıyla istemci uygulamalarından Apigee Edge'e yapılan istekler

Bu bölümde, istemci uygulaması ile Apigee Edge ve ayrıca Apigee Edge ile arka uç sunucunuz arasında bir veya daha fazla ara bileşen bulunan Apigee Edge kurulumunda zaman aşımı değerlerini ayarlarken izlenecek en iyi uygulamalar açıklanmaktadır.

Ara bileşenler yük dengeleyici, içerik yayınlama ağı (CDN), NGINX vb. olabilir.

İstemci ile Apigee Edge arasında ve Apigee Edge ile arka uç sunucusu arasında bir ara bileşene sahip örnek Apigee kurulumu

İstemciden başlayıp Ara Bileşen 1'e, ardından Yönlendirici'ye, Mesaj İşleyici'ye, ardından Orta Bileşen 2'ye ve ardından Arka Uç Sunucu'ya giden akış

Apigee Edge yukarıdaki şemada gösterildiği gibi bir veya daha fazla ara bileşenle ayarlandıysa aşağıdaki en iyi uygulamalardan yararlanın:

  1. Akıştaki ilk bileşen istemci uygulamasıdır. En yüksek zaman aşımı değeri istemcide ayarlanmalıdır.
  2. Arka uç sunucusu, akıştaki son bileşendir. En düşük zaman aşımı değeri arka uç sunucuda ayarlanmalıdır.
  3. Ara bileşenler de dahil olmak üzere bileşenlerin her birindeki zaman aşımı değerlerini aşağıdaki sırayla yapılandırın:

    İstemcide zaman aşımını, ardından Ara Bileşen 1, Yönlendirici, Mesaj İşleyici, Ara Bileşen 2 ve ardından Arka Uç Sunucusu'nu yapılandırın

    Aşağıdaki örnekte, sorunlardan kaçınmak için çeşitli bileşenlerde yukarıda verilen yönergeler doğrultusunda ayarlanan zaman aşımı değerleri gösterilmektedir:

    İstemcide zaman aşımını 63 saniyede, ardından Ara Bileşen 1'in 60. saniyesinde, ardından Yönlendirici 57. saniyede, sonra Mesaj İşleyici 55. saniyede, sonra Ara Bileşen 2'nin 52. saniyesinde, sonra da Arka Uç Sunucusu 59. saniyede yapılandırın