Genel Bakış
7/24 İzleme
Performans Metrikleri
Erken Uyarı
Otomatik Bildirimler

API Sağlık Kontrolü ayarlar formu - Tüm yapılandırma alanları
API Sağlık Kontrolü Nedir?
Temel Kavram
API Sağlık Kontrolü, belirlediğiniz bir API endpoint’ine veya web servisine belirli aralıklarla otomatik olarak test istekleri gönderen bir izleme sistemidir.Ne Zaman Kullanılır?
Ne Zaman Kullanılır?
Kritik API İzleme
SLA Takibi
Performans İzleme
Uptime Monitoring
Nasıl Çalışır?
Nasıl Çalışır?
Yapılandırma
Zamanlama
Test Çalıştırma
Doğrulama
- Yanıt süresi kontrolü
- HTTP durum kodu kontrolü
- Yanıt içeriği kontrolü
- XPath/JSONPath kontrolleri
Sonuç Kaydetme
Bildirim
Hızlı Başlangıç
İlk Sağlık Kontrolünüzü Oluşturma
Menüden Erişim
Yeni Kontrol Oluştur
Temel Bilgileri Doldurun
- Ad: Kontrolünüz için bir isim (örn: “Ödeme API Kontrolü”)
- Açıklama: İsteğe bağlı açıklama
İstek Bilgilerini Girin
- HTTP Metodu: GET, POST, vb.
- URL: Test edilecek API endpoint’i
Zamanlama Ayarlayın
Kaydet
Yeni Sağlık Kontrolü Oluşturma
Adım 1: Temel Bilgiler
Ad - Zorunlu
Ad - Zorunlu
- Proje içinde benzersiz olmalıdır
- Boşlukla başlayamaz
- Sistem otomatik olarak ismin kullanılabilirliğini kontrol eder
Ödeme API İzlemeKullanıcı Servisi Health CheckÜçüncü Taraf Entegrasyon KontrolüAna Sayfa Erişilebilirlik Kontrolü
Açıklama - Opsiyonel
Açıklama - Opsiyonel
- Maksimum 1000 karakter
- Maksimum 1000 karakter
- Kontrolün amacını ve kapsamını açıklamak için kullanılır
- Liste sayfasında görüntülenir
Kritik ödeme API'sinin 7/24 izlenmesi için oluşturulmuşturMüşteri portalı ana sayfa erişilebilirlik kontrolüÜçüncü taraf servis sağlayıcı entegrasyonu izleme
Durum (Status) - Varsayılan: Aktif
Durum (Status) - Varsayılan: Aktif
- Aktif: Kontrol çalışır, zamanlanmış testler gönderilir
- Pasif: Kontrol durdurulur, test gönderilmez (geçmiş veriler korunur)
Adım 2: Zamanlama Ayarları
Sağlık kontrolünün ne sıklıkla çalışacağını belirleyin. Cron Expression kullanarak zamanlama yapılır.Yaygın Zamanlama Örnekleri
| Açıklama | Cron Expression | Kullanım Senaryosu |
|---|---|---|
| Her 5 dakikada bir | 0 */5 * ? * * | Kritik API’ler için (en yaygın) |
| Her 15 dakikada bir | 0 */15 * ? * * | Normal API’ler için |
| Her saat başı | 0 0 * ? * * | Test/Development ortamları için |
| Her gün saat 09:00 | 0 0 9 * ? * | Günlük raporlama için |
| Her hafta Pazartesi 09:00 | 0 0 9 ? * MON | Haftalık kontrol için |
Adım 3: İstek Ayarları
Bu bölümde test edilecek endpoint’in bilgilerini yapılandırırsınız.Koleksiyondan Seçin (Select From Collection) - Önerilen
Koleksiyondan Seçin (Select From Collection) - Önerilen
Butona Tıklayın
Koleksiyonu Seçin
Senaryoyu Seçin
Otomatik Doldurma
- Zaman kazanırsınız
- Tutarlı test senaryoları kullanırsınız
- Test senaryolarınızı merkezi olarak yönetebilirsiniz
HTTP Metodu (Method) - Zorunlu
HTTP Metodu (Method) - Zorunlu
GET
POST
PUT
DELETE
PATCH
HEAD
URL - Zorunlu
URL - Zorunlu
https://api.example.com/usershttps://api.example.com/payment/verifyhttp://localhost:8080/healthhttps://api.example.com/v1/products?category=electronics
Parametreler (Parameters) - Opsiyonel
Parametreler (Parameters) - Opsiyonel
- Parametre Adı:
userId - Parametre Değeri:
12345
https://api.example.com/users?userId=12345Başlıklar (Headers) - Opsiyonel
Başlıklar (Headers) - Opsiyonel
- Authorization:
Bearer token123veyaBasic base64encoded - Content-Type:
application/json,application/xml - X-API-Key:
your-api-key - Custom Headers: Özel header’lar
- Başlık Adı:
Authorization - Başlık Değeri:
Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Gövde (Body) - POST/PUT/PATCH için
Gövde (Body) - POST/PUT/PATCH için
- Raw: JSON, XML, Text
- Form URL Encoded: Form verileri
Adım 4: Doğrulama Ayarları
Doğrulama (Assertion) ayarları, test sonucunun başarılı sayılması için gerekli kontrolleri belirler.Zamanaşımı Kontrolü (Timeout Assertion)
Zamanaşımı Kontrolü (Timeout Assertion)
- İstek belirlenen süre içinde yanıtlanmalıdır
- Aksi halde test başarısız sayılır
HTTP Durum Kodu Kontrolü (Status Code Assertion)
HTTP Durum Kodu Kontrolü (Status Code Assertion)
Toggle'ı Aktif Edin
Status Code Girin
200 (OK)Yaygın Status Code’lar:200: Başarılı201: Oluşturuldu204: İçerik yok400: Hatalı istek401: Yetkisiz404: Bulunamadı500: Sunucu hatası
- Beklenen Status Code:
200 - Gerçek Status Code:
200→ ✅ Başarılı - Gerçek Status Code:
500→ ❌ Başarısız
Yanıt Gövdesi Kontrolü (Body Assertion)
Yanıt Gövdesi Kontrolü (Body Assertion)
Toggle'ı Aktif Edin
İçerik Girin
- Response’ta belirli bir metin olmalı:
"status": "success" - Response belirli bir değer içermeli:
"active": true - Response boş olmamalı
- Beklenen:
"status": "ok" - Gerçek:
{"status": "ok", "data": {...}}→ ✅ Başarılı - Gerçek:
{"status": "error"}→ ❌ Başarısız
XPath Kontrolü (XPath Assertion) - XML için
XPath Kontrolü (XPath Assertion) - XML için
Toggle'ı Aktif Edin
XPath Girin
Beklenen Değeri Girin
- XPath:
/response/status - Beklenen Sonuç:
success - Gerçek XML:
<response><status>success</status></response>→ ✅ Başarılı
JSONPath Kontrolü (JSONPath Assertion) - JSON için
JSONPath Kontrolü (JSONPath Assertion) - JSON için
Toggle'ı Aktif Edin
JSONPath Girin
Beklenen Değeri Girin
- JSONPath:
$.status - Beklenen Sonuç:
ok - Gerçek JSON:
{"status": "ok", "data": {...}}→ ✅ Başarılı
$.status: Root’taki status alanı$.data.items[0].id: İlk item’ın id’si$.user.name: User objesinin name alanı$.results[*].id: Tüm result’ların id’leri
Adım 5: Ayarlar
Zamanaşımı (Timeout) - Varsayılan: 30 saniye
Zamanaşımı (Timeout) - Varsayılan: 30 saniye
- Saniye cinsinden girilir
- Varsayılan değer:
30saniye - Bu süre içinde yanıt alınamazsa test başarısız sayılır
SSL Sertifikası (Enable Certificate)
SSL Sertifikası (Enable Certificate)
- Bu seçenek aktif edildiğinde, özel SSL sertifikası kullanılabilir
- Genellikle self-signed sertifikalar veya özel CA sertifikaları için kullanılır
Adım 6: Yeniden Deneme Ayarları (Retry Settings)
Geçici sorunlarda otomatik yeniden deneme yapmak için:Başarısızsa Yeniden Dene (Retry On Fail)
Başarısızsa Yeniden Dene (Retry On Fail)
Toggle'ı Aktif Edin
Sayı Seçin
1, 3, 5, veya 10- İlk istek başarısız olursa
- Belirlenen sayı kadar tekrar denenir
- Her deneme arasında bekleme yapılabilir (opsiyonel)
- Yeniden Deneme Sayısı:
3 - İlk istek başarısız → 1. yeniden deneme → başarısız → 2. yeniden deneme → başarısız → 3. yeniden deneme → başarılı → ✅ Başarılı
İstekler Arası Bekleme (Delay Between Requests)
İstekler Arası Bekleme (Delay Between Requests)
Toggle'ı Aktif Edin
Bekleme Süresi Girin
3 saniyeKullanım Senaryosu:- Sunucu yükünü azaltmak için
- Rate limiting’den kaçınmak için
- Geçici sorunların çözülmesi için zaman tanımak
- Yeniden Deneme Sayısı:
3 - Bekleme:
5saniye - İlk istek başarısız → 5 sn bekle → 1. yeniden deneme → başarısız → 5 sn bekle → 2. yeniden deneme → başarılı
Adım 7: Bildirim Alıcıları (Recipients)
Test başarısız olduğunda tetiklenecek bildirimleri yapılandırın:Bildirim Ekleme
Bildirim Ekle
Bildirim Türünü Seçin
- Email: Email bildirimi gönderir
- Webhook: HTTP POST isteği gönderir
- Slack: Slack kanalına mesaj gönderir
- SMS: SMS bildirimi gönderir
- Ve daha fazlası…
Yapılandırmayı Tamamlayın
- Düzenle: Bildirim bilgilerini güncellemek için menüden “Düzenle” seçin
- Sil: Bildirimi kaldırmak için menüden “Sil” seçin
- Aktif/Pasif: Toggle ile bildirimi aktif/pasif yapabilirsiniz
- Sağlık kontrolü adı
- Proxy adı (varsa)
- Hedef URL
- Hata mesajı
- Zaman damgası
- Test sonucu detayları
Adım 8: Kaydetme
Tüm bilgileri doldurduktan sonra:Validasyon Kontrolü
- ✅ Ad girilmiş ve kullanılabilir
- ✅ URL girilmiş
- ✅ Zamanlama ayarları yapılmış
- ✅ En az bir assertion aktif (önerilir)
Kaydet
Yönlendirme
Sonuçları İzleme ve Raporlama
Sonuçlar Sayfasına Erişim
Listeden Erişim
Menüden Erişim
Sonuçlar Sayfası Bölümleri
1. Üst Bilgi Bölümü
1. Üst Bilgi Bölümü
- Tarih Aralığı Seçici: Sonuçları belirli bir tarih aralığına göre filtreleyin
- Yenile Butonu: Sonuçları manuel olarak yenileyin
- HTTP Metodu ve URL: Test edilen endpoint bilgisi
2. Durum Özeti
2. Durum Özeti
- Zaman içindeki yanıt sürelerini gösteren çizgi grafik
- X ekseni: Tarih/Saat
- Y ekseni: Yanıt süresi (milisaniye)
- Y ekseni: Yanıt süresi (milisaniye)
- Grafik üzerinde hover yaparak detaylı bilgi görebilirsiniz
- Tüm testlerin ortalama yanıt süresi (milisaniye)
- Büyük ve kalın yazıyla gösterilir
- Performans değerlendirmesi için önemli bir metrik
- Başarılı testlerin toplam testlere oranı (yüzde)
- Yeşil: İyi performans (%95+)
- Sarı: Orta performans (%80-95)
- Kırmızı: Düşük başarı oranı (%80 altı)

Durum özeti ve test sonuçları tablosu
3. Test Sonuçları Tablosu
3. Test Sonuçları Tablosu
- İstek Gönderildi: Test isteğinin gönderildiği tarih ve saat
- İstek Tipi:
- İlk İstek: Normal test isteği
- Tekrar: Yeniden deneme isteği
- Yanıt Süresi: İsteğin yanıtlanma süresi (milisaniye)
- Teyitler: Yapılan kontroller ve sonuçları:
- ✅ Timeout: İstek zaman aşımına uğramadı
- ✅ Timeout: İstek zaman aşımına uğramadı
- ✅ Status Code: Beklenen HTTP status code döndü
- ✅ Result Body: Response body doğrulandı
- ✅ XPath: XPath kontrolü başarılı (XML için)
- ✅ JSONPath: JSONPath kontrolü başarılı (JSON için)
- Sonuç:
- 🟢 Başarılı: Tüm kontroller geçti
- 🔴 Başarısız: En az bir kontrol başarısız oldu
- Detay: Sonuç detaylarını JSON formatında görüntülemek için göz ikonu (👁️)
Sonuç Detaylarını Görüntüleme
Detay Butonuna Tıklayın
Detayları İnceleyin
- Request bilgileri (URL, method, headers, body)
- Response bilgileri (status code, headers, body)
- Assertion sonuçları (her bir kontrolün sonucu)
- Hata mesajları (varsa)
- Hata mesajları (varsa)
- Zaman damgaları
Tüm Sonuçları Silme
Sil Butonuna Tıklayın
Silme Tamamlandı
Sağlık Kontrolü Yönetimi
Liste Sayfası Özellikleri
Sağlık kontrolü listesi sayfasında tüm kontrollerinizi görüntüleyebilir ve yönetebilirsiniz.Arama ve Filtreleme
Arama ve Filtreleme
- İsim ile Arama: İsim alanına yazarak kontrolleri filtreleyebilirsiniz
- Açıklama ile Arama: Açıklama alanına yazarak arama yapabilirsiniz
- Proje Filtresi (Admin modunda): Birden fazla projeden kontrolleri görüntüleyebilirsiniz
- Temizle: Tüm filtreleri temizlemek için silgi ikonuna tıklayın
Tablo Sütunları
Tablo Sütunları
- Ad: Sağlık kontrolünün ismi (tıklanabilir, sonuç sayfasına gider)
- Açıklama: Kontrol açıklaması
- Hedef URL: Test edilen endpoint URL’i
- Durum: Aktif/Pasif durumu (toggle ile değiştirilebilir)
- Proje (Admin modunda): Kontrolün ait olduğu proje
- İşlemler: Menü butonu (⋮)
İşlemler Menüsü
İşlemler Menüsü
Durum Değiştirme
Durum Değiştirme
Toggle'a Tıklayın
Durum Güncellendi
Pasif Kontroller
En İyi Uygulamalar
1. İsimlendirme Kuralları
- Açıklayıcı İsimler Kullanın:
Ödeme API Kontrolügibi net isimler - Proje/Modül Öneki Ekleyin:
E-Ticaret - Ödeme APIgibi - Ortam Bilgisi Ekleyin:
Production - Kullanıcı APIgibi
2. Zamanlama Stratejisi
- Kritik API’ler: Her 5 dakikada bir kontrol edin
- Normal API’ler: Her 15-30 dakikada bir kontrol edin
- Test Ortamları: Her saat başı kontrol edin
- Sunucu yükünü göz önünde bulundurun
3. Assertion Kullanımı
- En az bir assertion kullanın (Status Code önerilir)
- Timeout assertion’ı mutlaka aktif edin
- Body assertion’larını dikkatli kullanın (değişken içerik varsa)
- JSONPath/XPath kullanarak spesifik kontroller yapın
4. Yeniden Deneme Stratejisi
- Geçici sorunlar için retry kullanın
- Retry sayısını makul tutun (3-5 arası)
- Delay kullanarak sunucu yükünü azaltın
- Rate limiting durumlarında delay’i artırın
5. Bildirim Yönetimi
- Kritik kontroller için email + SMS bildirimi kullanın
- Webhook kullanarak entegrasyon sistemlerinize bildirim gönderin
- Bildirim spam’inden kaçınmak için filtreleme yapın
- Bildirim grupları oluşturun
6. Performans İzleme
- Yanıt sürelerini düzenli olarak kontrol edin
- Başarı oranlarını takip edin (%95+ hedefleyin)
- Trend analizi yapın (grafikleri inceleyin)
- Anomali tespiti için eşik değerleri belirleyin
Sık Sorulan Sorular
Sağlık Kontrolü Ne Sıklıkla Çalışır?
Sağlık Kontrolü Ne Sıklıkla Çalışır?
0 */5 * ? * *→ Her 5 dakikada bir0 0 * ? * *→ Her saat başı0 0 9 * ? *→ Her gün saat 09:00
Kontrol Pasif Yapıldığında Ne Olur?
Kontrol Pasif Yapıldığında Ne Olur?
- Yeni test istekleri gönderilmez
- Mevcut zamanlanmış işler iptal edilir
- Geçmiş sonuçlar korunur ve görüntülenebilir
- Kontrol tekrar aktif yapıldığında normal çalışmaya devam eder
Yeniden Deneme Nasıl Çalışır?
Yeniden Deneme Nasıl Çalışır?
- İlk istek gönderilir
- Eğer başarısız olursa (herhangi bir assertion başarısız)
- Belirlediğiniz sayı kadar tekrar denenir
- İstekler arası bekleme varsa, belirtilen süre kadar beklenir
- Tüm denemeler başarısız olursa, sonuç “Başarısız” olarak kaydedilir
Bildirimler Ne Zaman Gönderilir?
Bildirimler Ne Zaman Gönderilir?
- Test başarısız olduğunda
- Her başarısız test için ayrı bildirim gönderilir
- Başarılı testlerde bildirim gönderilmez (varsayılan davranış)
Assertion Kontrolleri Nasıl Çalışır?
Assertion Kontrolleri Nasıl Çalışır?
- Timeout Kontrolü: İstek belirlenen süre içinde yanıtlandı mı?
- Status Code Kontrolü: HTTP status code beklenen değerle eşleşiyor mu?
- Body Kontrolü: Response body beklenen içerikle eşleşiyor mu?
- XPath Kontrolü: XML response’ta XPath ifadesi doğru sonuç veriyor mu?
- JSONPath Kontrolü: JSON response’ta JSONPath ifadesi doğru sonuç veriyor mu?
Test Koleksiyonundan Seçme Ne İşe Yarar?
Test Koleksiyonundan Seçme Ne İşe Yarar?
- Zaman kazanırsınız
- Tutarlı test senaryoları kullanırsınız
- Test senaryolarınızı merkezi olarak yönetebilirsiniz
Kontrol Silindiğinde Ne Olur?
Kontrol Silindiğinde Ne Olur?
- Kontrol tanımı veritabanından silinir
- Tüm test sonuçları silinir
- Zamanlanmış işler iptal edilir
- Geçmiş veriler kalıcı olarak kaybolur
Sonuçlar Ne Kadar Süre Saklanır?
Sonuçlar Ne Kadar Süre Saklanır?
- Sonuçlar sayfasında “Tüm Sonuçları Sil” butonunu kullanabilirsiniz
- Veya sonuçları düzenli olarak temizleyebilirsiniz
Birden Fazla Assertion Kullanabilir miyim?
Birden Fazla Assertion Kullanabilir miyim?
- Status Code: 200 ✅
- Body içinde “success” metni ✅
- JSONPath:
$.status= “ok” ✅
URL'de Dinamik Parametreler Kullanabilir miyim?
URL'de Dinamik Parametreler Kullanabilir miyim?
- Query parametreleri ekleyebilirsiniz
- Headers’da dinamik değerler kullanabilirsiniz (bazı durumlarda)
- Body’de dinamik içerik kullanabilirsiniz
Sorun Giderme
Kontrol Çalışmıyor
Kontrol Çalışmıyor
- Kontrol pasif durumda olabilir → Durum toggle’ını kontrol edin
- Zamanlama ayarları yanlış olabilir → Cron expression’ı kontrol edin
- URL erişilebilir değil → URL’yi manuel olarak test edin
- Kontrol durumunu aktif yapın
- Zamanlama ayarlarını kontrol edin
- URL’nin erişilebilir olduğundan emin olun
Tüm Testler Başarısız
Tüm Testler Başarısız
- URL yanlış veya erişilebilir değil
- Assertion ayarları çok katı
- Timeout süresi çok kısa
- Authentication sorunları
- URL’yi kontrol edin
- Assertion ayarlarını gözden geçirin
- Timeout süresini artırın
- Headers’da authentication bilgilerini kontrol edin
Bildirimler Gelmiyor
Bildirimler Gelmiyor
- Bildirim pasif durumda
- Bildirim yapılandırması hatalı
- Email/SMS servisi çalışmıyor
- Bildirim durumunu aktif yapın
- Bildirim yapılandırmasını kontrol edin
- Email/SMS servis ayarlarını kontrol edin
Yanıt Süreleri Çok Yüksek
Yanıt Süreleri Çok Yüksek
- API performans sorunları
- Network gecikmeleri
- Sunucu yükü
- API performansını optimize edin
- Network bağlantısını kontrol edin
- Sunucu kaynaklarını kontrol edin
Sonuçlar Görünmüyor
Sonuçlar Görünmüyor
- Kontrol henüz çalışmadı
- Tarih aralığı filtresi yanlış
- Sonuçlar silinmiş olabilir
- Kontrolün çalıştığından emin olun
- Tarih aralığı filtresini kontrol edin
- Sonuçların silinmediğinden emin olun

