Backend 404 veya 500 döndüğünde özel bir hata sayfası gösterebilir miyim?

Kısa cevap

Evet, HTTP vService'te. Show Content for Backend Service Errors aksiyonunda Error Codes listesinden hata kodu (ör. 404) seçilir, gösterilecek Content Page ve Status Code belirlenir; Kurum Servisi bu kodu döndürdüğünde istemci sunucunun sayfası yerine özel sayfayı görür. Status code varsayılan 200 geldiği için asıl kod seçilir; 404 ve 500 kendi kodlarıyla dönecekse her kod için ayrı aksiyon eklenir. Kullanıcıyı başka bir adrese göndermek için Redirect for Backend Service Errors, yola göre farklı içerik için On Response aşamasında Status Code koşuluyla Show Content kullanılır.

Sorun: Sunucunun Hata Sayfası Teknik Ayrıntı Gösteriyor

Uygulama sunucuları hata durumunda kendi varsayılan sayfalarını döndürür; bu sayfalar her uygulamada farklı görünür, bazen sürüm bilgisi ya da hata ayrıntısı içerir. Kurum Servisinin yapılandırmasına dokunmadan, yanıt TR7'den geçerken kurumsal bir hata sayfasıyla değiştirilir.

Çözüm: Üç Yöntem

Üç yöntem de yalnızca Kurum Servisinden dönen yanıtlara uygulanır. Sunucuya hiç ulaşılamadığında TR7'nin kendi ürettiği 502/503/504 için TR7'nin kendi ürettiği 503/502/504 hataları için özel sayfa gösterebilir miyim? sayfasına bakılır.

Durumunuz	Uygun yöntem
Seçili hata kodlarında bütün yollar için aynı özel sayfa	Yöntem 1: Show Content for Backend Service Errors
Hata kodunda kullanıcıyı başka bir adrese göndermek	Yöntem 2: Redirect for Backend Service Errors
Yola ya da başka koşula göre farklı sayfa (ör. /api/ için JSON)	Yöntem 3: Show content (On response) + Status code koşulu

Yöntem 1: Show Content for Backend Service Errors Önerilen

• Nasıl çalışır Kurum Servisinden dönen yanıtın kodu seçili kodlardan biriyse yanıt, seçilen sayfa ve Status code ile değiştirilir; aksiyon koşul almaz.
• Nerede açılırLoad Balancer → Actions → Show Content for Backend Service Errors
• Gereksinim Hata sayfası Content Pages'te
• vService tipi HTTP

Adım adım yapılandırma

1

Adım 1 Content Pages formunu aç

Load Balancer → Profiles → Content Pages → Add tıklanır (nasıl eklenir).

2

Adım 2 Sayfayı hazırla

Content Page Name, Content Type (varsayılan text/html) ve Content girilir. Bu aksiyon yanıta karakter kümesi eklemediğinden Türkçe karakterler için sayfanın head bölümüne <meta charset="utf-8"> yazılır.

3

Adım 3 Sayfayı kaydet

Add tıklanır.

4

Adım 4 Aksiyon formunu aç

Load Balancer → Actions → Add tıklanır (nasıl eklenir).

5

Adım 5 Aksiyon adını ve tipini gir

Action Name girilir, Action Type = Show Content for Backend Service Errors seçilir.

6

Adım 6 404 için sayfayı tanımla

Error Codes = 404, Content Page = 3. adımdaki sayfa, Status Code = 404 (varsayılan 200). Error codes listesinde birden fazla kod seçilebilir; ancak hepsi bu aksiyonun tek Status code değeriyle döner.

7

Adım 7 Aksiyonu kaydet

Add tıklanır.

8

Adım 8 500 için ikinci aksiyonu ekle

4–7. adımlar Error Codes = 500, Status Code = 500 ile tekrarlanır.

9

Adım 9 vService'i düzenle

Load Balancer → Load Balancer vService List ekranında HTTP vService seçilip Edit tıklanır.

10

Adım 10 Aksiyonları Actions alanına ekle

Details → Actions alanında iki aksiyon da seçilir.

11

Adım 11 Kaydet

Save tıklanır. Değişiklik açık bağlantılar kopmadan uygulanır; cluster'da varsayılan auto-sync ile eş cihaza da gönderilir (Manual Sync Mode açıksa Synchronize ile). Kurum Servisi tarafında değişiklik gerekmez.

Doğrulama

1Yanıtİstemci tarafı

curl -i https://www.example.com/olmayan-sayfa

BeklenenHTTP/1.1 404 + özel sayfa

2LogTR7 tarafı

HTTP Logs ekranında istek 404 koduyla görünür.

BeklenenDurum kodu 404

Yöntem 2: Redirect for Backend Service Errors

• Nasıl çalışır Seçili kodlardan biri dönen isteklerde istemci başka bir adrese 302 ile yönlendirilir; Kurum Servisinin hata sayfası istemciye gitmez.
• Nerede açılırLoad Balancer → Actions → Redirect for Backend Service Errors
• Gereksinim Yönlendirilecek sayfa (ör. arama ya da destek sayfası) yönlendirme döngüsü kurmayacak biçimde var olmalı
• vService tipi HTTP

Adım adım yapılandırma

1

Adım 1 Aksiyon formunu aç

Load Balancer → Actions → Add tıklanır.

2

Adım 2 Aksiyon tipini seç

Action Type = Redirect for Backend Service Errors seçilir.

3

Adım 3 Kodları ve adresi gir

Error Codes = 404; Redirect Location = /arama. Alan fx ile Smart Variable destekler; örneğin /arama?kaynak= arkasına Path/page of the request [URI] eklenerek bulunamayan yol arama sayfasına taşınır.

4

Adım 4 Aksiyonu kaydet

Add tıklanır.

5

Adım 5 vService'i düzenle

vService Edit ile açılır.

6

Adım 6 Aksiyonu Actions alanına ekle

Details → Actions alanında aksiyon seçilir.

7

Adım 7 Kaydet

Save tıklanır.

Doğrulama

1Yanıtİstemci tarafı

curl -sI https://www.example.com/olmayan-sayfa

Beklenen302 + Location: /arama…

Yöntem 3: Show Content (On Response) + Status Code Koşulu

• Nasıl çalışır Yanıt aşamasında çalışan Show content, Status code koşulu ve başka koşullarla birlikte yalnızca istenen isteklerde içerik döndürür; örneğin /api/ altında 500 dönen isteklere JSON, diğerlerine HTML.
• Nerede açılırLoad Balancer → Conditions → Status Code · Actions → Show Content
• Gereksinim Status code koşulu yalnızca On response aşamasında seçilebilir
• vService tipi HTTP

Adım adım yapılandırma

1

Adım 1 JSON sayfasını hazırla

Yöntem 1'in 1–3. adımlarıyla Content Type = application/json, Content = {"error":"internal_error"} olan bir sayfa eklenir (Content Pages profili nedir; kendi HTML sayfamı nasıl hazırlarım?).

2

Adım 2 Koşul formunu aç

Load Balancer → Conditions → Add tıklanır (nasıl eklenir).

3

Adım 3 Status code koşulunu tanımla

Criteria = Status Code, Operator = Equals to (varsayılan), değer 500 girilir.

4

Adım 4 Koşulu kaydet

Add tıklanır.

5

Adım 5 İkinci koşul formunu aç

Load Balancer → Conditions → Add ile ikinci koşul formu açılır.

6

Adım 6 Yol koşulunu tanımla

Criteria = Path, eşleştirme Start, değer /api/ girilir.

7

Adım 7 Yol koşulunu kaydet

Add tıklanır.

8

Adım 8 Aksiyon formunu aç

Load Balancer → Actions → Add tıklanır.

9

Adım 9 Aksiyon tipini seç

Action Type = Show Content seçilir.

10

Adım 10 Yanıt aşamasında içeriği tanımla

Execution Level = On response; Content page = JSON sayfası; Status code = 500; Conditions alanında iki koşul and ile seçilir (özel hata sayfaları senaryosu).

11

Adım 11 Aksiyonu kaydet

Add tıklanır.

12

Adım 12 vService'i düzenle

vService Edit ile açılır.

13

Adım 13 Aksiyonu Actions alanına ekle

Details → Actions alanında aksiyon seçilir.

14

Adım 14 Kaydet

Save tıklanır.

Doğrulama

1Yanıtİstemci tarafı

500 dönen bir API yolu curl -i https://www.example.com/api/rapor ile istenir.

BeklenenHTTP/1.1 500 + {"error":"internal_error"}

Sık Yapılan Hatalar

Status code varsayılanı 200'dür

Status code değiştirilmezse 404 ve 500 yanıtları istemciye 200 koduyla gider; arama motorları hata sayfasını içerik sanar, izleme araçları hatayı görmez. Her aksiyonda asıl hata kodu seçilir.

• TR7'nin ürettiği hataları bu aksiyonla beklemek. Kurum Servisine ulaşılamadığında dönen 502/503/504 bu aksiyonların değil Show Content for Traffic Manager Errors ve Redirect for Traffic Manager Errors aksiyonlarının kapsamıdır.
• Birden çok kodu tek aksiyonda toplayıp kodları korumayı beklemek. Tek aksiyondaki bütün kodlar aynı Status code ile döner; kodlar korunacaksa her kod için ayrı aksiyon eklenir.
• Hiç kod seçmeden kaydetmek. Error codes boşken aksiyon hiçbir yanıtı değiştirmez.
• Türkçe karakterleri unutmak. Show Content for Backend Service Errors yanıtına karakter kümesi eklenmez; sayfaya <meta charset="utf-8"> yazılır.

Dokümantasyonda nasıl yapılır

• Show Content for Backend Service Errors · Error Codes
• Show Content for Backend Service Errors · Status Code
• Redirect for Backend Service Errors · Redirect Location
• Show Content · Kurum Servisi hatalarında özel sayfa

İlgili sorular

• TR7'nin kendi ürettiği 503/502/504 hataları için özel sayfa gösterebilir miyim?
• Hata durumunda sayfa göstermek mi, yönlendirmek mi daha doğru?
• Content Pages profili nedir; kendi HTML sayfamı nasıl hazırlarım?