SSS
Smarter by Design.Simpler for Business
TR7Enterprise Application Delivery & Security Platform

Türkçe

English

Türkçe

English

Görünüm

İleri

Health Check'te JSON yanıtını alan bazında doğrulayabilir miyim (Content Check Mode: JSONata Expression)? ​

Kısa cevap

Evet. HTTP ya da HTTPS profilinde Content Check Mode alanında JSONata Expression seçilir ve JSONata Query alanına ifade yazılır (ör. body.status = "UP"). İfade status (durum kodu), headers (küçük harfli başlıklar), body (JSON ya da XML olarak ayrıştırılmış gövde) ve bodyRaw (ham gövde) değerlerini kullanır; sonuç doğru (truthy) ise içerik kontrolü başarılıdır. Expected Status Codes listesi ayrıca uygulanır. WEB-CLI'da --contentCheckMode jsonata ve --jsonataQuery ile yazılır.

Sorun: Sağlık Yanıtı Birden Fazla Bileşenin Durumunu Taşıyor ​

Modern uygulamaların sağlık adresleri çoğu zaman JSON döner: veritabanı, önbellek, kuyruk gibi bileşenlerin her biri için ayrı bir durum alanı bulunur. Sabit bir metin araması bu yapıyı güvenilir biçimde denetleyemez (alan sırası ve boşluklar değişebilir); belirli alanların değerine göre karar vermek gerekir. Aksi hâlde bir bileşeni çalışmayan sunucu trafik almaya devam eder.

Çözüm: 2 Yöntem ​

İki yöntem aynı ayarı farklı arayüzlerden yapar.

DurumunuzUygun yöntem
Profili arayüzden yapılandırıyorum; ifadeyi örnek yanıtta denemek istiyorumYöntem 1: JSONata Expression
Profili WEB-CLI'dan oluşturuyorum ya da güncelliyorumYöntem 2: WEB-CLI
  • Nasıl çalışır İfade her yanıtta değerlendirilir; sonuç doğru (true, boş olmayan metin, sıfır dışı sayı, nesne ya da dizi) ise içerik kontrolü başarılıdır. Sonuç yanlışsa "JSONata check returned false", ifade hatalıysa "JSONata evaluation error" ile denetim başarısız olur.
  • Nerede açılırLoad Balancer → Profiles → Health Checks → HTTP/HTTPS profili → Content Check Mode → JSONata Expression → JSONata Query
  • Gereksinim Sağlık adresinin JSON (ya da XML) dönmesi; profilin atanacağı bir Kurum Servisi
  • vService tipi Tümü

Adım adım yapılandırma ​

1
Adım 1 Health Checks ekranını aç

Sol alttaki TR7 logosuyla Configuration Menu açılır; Load Balancer → Profiles → Health Checks yolu izlenir.

2
Adım 2 Formu aç

Yeni profil için Add'e tıklanır; mevcut HTTP/HTTPS profili için profil seçilip Edit'e tıklanır.

3
Adım 3 Temel alanları gir

Yeni profilde Name girilir, Check Type alanında HTTP ya da HTTPS seçilir ve Path + Query alanına sağlık adresi yazılır (ör. /health). Mevcut profilde bu adım atlanır.

4
Adım 4 Modu seç

Content Check Mode alanında JSONata Expression seçilir; Expected Content Query alanının yerine JSONata Query alanı görünür.

5
Adım 5 İfadeyi yaz ve dene

İfade yazılır ve alanın editöründe örnek bir yanıt üzerinde denenir. Örnekler:

  • Bütün bileşenler UP: status = 200 and $exists(body.checks) and $count(body.checks[status != "UP"]) = 0
  • Durum kodu ve alan birlikte: status = 200 and body.status = "UP"
  • Başlık kontrolü: $contains(headers.`content-type`, "json")
6
Adım 6 Profili kaydet

Add (düzenlemede Edit) butonuna tıklanır; değişiklik profili kullanan bütün Kurum Servislerine uygulanır. Mevcut profil düzenlendiyse işlem burada biter.

7
Adım 7 Kurum Servisinin formunu aç

Yeni profil için Load Balancer → Backend Services ekranında Kurum Servisine sağ tıklanıp Edit seçilir.

8
Adım 8 Profili seç

Health Check alanında profil seçilir.

9
Adım 9 Kaydet

Edit butonuna tıklanır.

Doğrulama ​

1Sağlık durumuBackend Services listesi

Backend Services listesinin Health kolonundaki gösterge kontrol edilir; ifade sağlanmazsa önizlemedeki Health Check kartında JSONata hatası görünür (Health durumu göstergesi).

BeklenenOK (yeşil)

Yöntem 2: WEB-CLI ​

  • Nasıl çalışır Mod --contentCheckMode jsonata, ifade --jsonataQuery ile yazılır; --jsonataQuery yalnızca HTTP/HTTPS profilinde ve mod jsonata iken kullanılır.
  • Nerede açılır WEB-CLI → lb hc add / lb hc update (lb hc · HTTP ve HTTPS alanları)
  • Gereksinim WEB-CLI erişimi; ifade | karakteri içermemeli (WEB-CLI | işaretini komut ayırıcı sayar; böyle ifadeler arayüzden girilir)
  • vService tipi Tümü

Adım adım yapılandırma ​

1
Adım 1 Profili oluştur ya da güncelle

Yeni profil (checkType ve name zorunludur ve bu sırayla yazılır):

text
lb hc add checkType http name json-saglik --uri /health --contentCheckMode jsonata --jsonataQuery 'body.status = "UP"'

Mevcut bir HTTP/HTTPS profilinde (kimlik lb hc list çıktısından alınır):

text
lb hc update id <profil-kimliği> --contentCheckMode jsonata --jsonataQuery 'body.status = "UP"'
2
Adım 2 Profili ata
text
lb backend update id <backend-kimliği> --hc <profil-kimliği>

Doğrulama ​

1KayıtWEB-CLI

Profil kaydı görüntülenir.

Komutlb hc show <profil-kimliği>
BeklenencontentCheckMode jsonata, jsonataQuery body.status = "UP"

Sık Yapılan Hatalar ​

  • Gövdenin her zaman JSON olarak ayrıştırıldığını sanmak. Gövde, Content-Type json içeriyorsa ya da Content-Type yoksa JSON olarak ayrıştırılır; text/plain dönen JSON'da body.alan tanımsız olur, bu durumda $eval(bodyRaw).alan kullanılır.
  • Yokluk durumunu düşünmemek. $count(body.checks[status != "UP"]) = 0 ifadesi checks alanı hiç yoksa (ör. hata sayfası döndüğünde) da doğru döner; $exists(body.checks) and … ile alanın varlığı da denetlenir.
  • Başlık adlarını büyük harfle yazmak. headers içindeki adlar küçük harflidir.
  • Durum kodunu yalnızca ifadede denetlemek. Expected Status Codes listesi de ayrıca uygulanır.
  • Yalnızca true sonucun başarılı sayıldığını sanmak. Boş olmayan metin ya da sıfır dışı sayı da başarılı sayılır; ifade açık bir karşılaştırma içermelidir.

Dokümantasyonda nasıl yapılır

İlgili sorular