Rapor Türleri
Rapor Üretici oluştururken öncelikle hangi veri kümesi üzerinde raporlama yapılacağı seçilir. Seçilen türe göre sonraki adımlardaki alanlar değişiklik gösterir.
| Rapor Türü | Açıklama |
|---|
| API Trafik Logları | Log verilerine özel bir sorgu ve filtre eklenerek ham trafik kayıtları üzerinde rapor oluşturulur. |
| Aralıklı API Trafik | API trafiği belirli zaman dilimlerine (saatlik, günlük vb.) göre gruplanarak analiz edilir. |
| API Trafik Metrikleri | API Proxy bazında trafik hacmi, başarı/hata oranları gibi metrikler raporlanır. |
| Endpoint Trafik Metrikleri | Endpoint bazında trafik metrikleri raporlanır. |
| Canary & Mirror Metrikleri | Canary ve Mirror yapılandırmalarına ait trafik metrikleri raporlanır. |
| Endpoint Boyut Metrikleri | Endpoint istek ve yanıt boyutlarına ilişkin metrikler raporlanır. |
| İstemci Trafik Metrikleri | İstemci (credential) bazında trafik metrikleri raporlanır. |
| IP Trafik Metrikleri | IP adresi bazında trafik metrikleri raporlanır. |
| API Proxy Raporu | API Proxy’lerin genel durumu ve bilgileri raporlanır. |
| API Endpoint Raporu | API Endpoint’lerin genel durumu ve bilgileri raporlanır. |
| İnaktif Endpoint’ler | Belirtilen süre içinde istek almayan endpoint’ler listelenir. |
| İnaktif Client’lar | Belirtilen süre içinde istek göndermeyen istemciler listelenir. |
| ACL Raporu | Erişim kontrol listesi (ACL) üzerindeki yetkilendirme durumları raporlanır. |
| Route Çakışma Raporu | Tanımlı rotalar arasındaki çakışmalar tespit edilerek raporlanır. |
| ACL Denetim Kayıtları | ACL üzerinde gerçekleştirilen değişikliklerin denetim kaydı raporlanır. |
Rapor Oluşturma
Tanım
| Alan | Açıklama |
|---|
| Aktif | Rapor Üreticinin etkin olup olmadığını belirler. Pasif durumdaki raporlar zamanlanmış olsa da çalıştırılmaz. |
| Rapor Türü | Raporlamanın hangi veri kümesi üzerinde yapılacağını belirler. Seçilen türe göre sonraki adımlar şekillenir. |
| Ad | Rapor Üreticiye verilen benzersiz isimdir. |
| Açıklama | Rapor Üreticinin amacını özetleyen isteğe bağlı açıklama alanıdır. |
| Zamanlama | Raporun hangi sıklıkla otomatik olarak çalıştırılacağı bu bölümde ayarlanır. Cron ifadesi ile dakika, saatlik, günlük ve haftalık gibi zamanlamalar tanımlanabilir. |
Sorgu
Bu adım yalnızca API Trafik Logları rapor türünde görünür.
- Yeni Sorgu — Anlık olarak yeni bir sorgu oluşturulabilir.
- Sorgu Seç — Daha önce tanımlanmış mevcut sorgulardan biri seçilebilir.
Seçilen sorgu ekranda görüntülenir; düzenlenebilir veya kaldırılabilir.
Sorgunun seçilmesi zorunlu değildir. Sorgu eklenmediğinde filtre koşullarına uyan tüm log kayıtları rapora dahil edilir.
Filtre
Raporda hangi log kayıtlarının değerlendirileceği filtre ile belirlenir. Bu adım zorunludur.
İki seçenek sunulur:
- Yeni Filtre — Anlık olarak yeni bir filtre oluşturulabilir.
- Filtre Seç — Daha önce tanımlanmış mevcut filtrelerden biri seçilebilir.
Filtre oluştururken aşağıdaki ayarlar yapılandırılabilir:
| Alan | Açıklama |
|---|
| Ad | Filtreye verilen isimdir. |
| Proxy Listesi | Raporun hangi API Proxy’ler üzerinde çalıştırılacağını belirler. Seçilmediğinde tüm proxy’ler dahil edilir. |
| Tarih Aralığı | Raporun hangi zaman dilimindeki log kayıtlarını kapsayacağını belirler. Sabitleme (örn. “Bugün”) veya dinamik aralık (örn. “Son 7 gün”) seçilebilir. |
| İşlem Sonuç Tipi | Yalnızca başarılı, hatalı veya engellenmiş isteklerin dahil edilmesi için filtre uygulanabilir. (Yalnızca API Trafik Logları türünde geçerlidir.) |
| Sıralama | Rapor kayıtlarının hangi alana göre ve hangi yönde sıralanacağını belirler. (Yalnızca API Trafik Logları türünde geçerlidir.) |
Rapor Alanları
Bu adım yalnızca API Trafik Logları rapor türünde görünür.
Common Fields
Request Fields
Response Fields
| Alan | Açıklama |
|---|
| Created | İsteğin oluşturulduğu tarih ve saat. |
| API Proxy | İsteğin geçtiği API Proxy adı. |
| API Type | API’nin türü (REST, SOAP vb.). |
| API Proxy Revision | Kullanılan API Proxy revizyonu. |
| API Proxy Relative Path | API Proxy’nin göreli yolu. |
| API Proxy Method | İstekte kullanılan HTTP metodu (proxy düzeyinde). |
| Total Time (ms) | İsteğin toplam işlem süresi (milisaniye). |
| Username or Key | İsteği gerçekleştiren kullanıcı adı veya API anahtarı. |
| Cache Hit | İsteğin önbellekten karşılanıp karşılanmadığı. |
| Alan | Açıklama |
|---|
| X-Forwarded-For | İstemcinin gerçek IP adresini taşıyan başlık değeri. |
| Request Address | İsteğin yapıldığı tam URL adresi. |
| Request Pipeline Total (ms) | İsteğin pipeline’daki toplam işlem süresi (milisaniye). |
| HTTP Method | İstekte kullanılan HTTP metodu (GET, POST vb.). |
| HTTP Request Content Type | İstek gövdesinin içerik türü (Content-Type). |
| Request Size (byte) | İstek gövdesinin boyutu (byte cinsinden). |
| From Client Parameter | İstemciden gelen sorgu parametreleri. |
| From Client Header | İstemciden gelen HTTP başlıkları. |
| From Client Body | İstemciden gelen istek gövdesi. |
| To Backend API Parameter | Backend API’ye iletilen sorgu parametreleri. |
| To Backend API Header | Backend API’ye iletilen HTTP başlıkları. |
| To Backend API Body | Backend API’ye iletilen istek gövdesi. |
| Alan | Açıklama |
|---|
| Routing Address | İsteğin yönlendirildiği backend adresi. |
| Backend Routing Time (ms) | Backend’e yönlendirme süresi (milisaniye). |
| Response Pipeline Total (ms) | Yanıtın pipeline’daki toplam işlem süresi (milisaniye). |
| Response Size (byte) | Yanıt gövdesinin boyutu (byte cinsinden). |
| HTTP Status Code | Backend tarafından dönen HTTP durum kodu. |
| Error Type | Hata oluştuysa hata türü. |
| Parent Error Type | Üst seviye hata türü. |
| Result Type | İşlem sonucunun türü (başarılı, hatalı vb.). |
| From Backend API Header | Backend API’den gelen HTTP başlıkları. |
| From Backend API Body | Backend API’den gelen yanıt gövdesi. |
| To Client Header | İstemciye iletilen HTTP başlıkları. |
| To Client Body | İstemciye iletilen yanıt gövdesi. |
Yalnızca ihtiyaç duyulan alanları seçmek, rapor boyutunu küçülterek daha hızlı oluşturulmasını sağlar.
Rapor Parametreleri
Seçilen rapor türüne göre ek parametreler görünür. Bu parametreler raporun kapsamını daha ayrıntılı biçimde belirlemeye yarar.
| Parametre | İlgili Rapor Türleri | Açıklama |
|---|
| Projeler | Birden fazla rapor türü | Raporun hangi projeleri kapsayacağını belirler. (Yalnızca Admin kullanıcılarında görünür.) |
| Aralık | Aralıklı API Trafik | Trafik verilerinin gruplanacağı zaman dilimi (dakika, saat, gün vb.). |
| API Proxy Tipi | Çeşitli metrik türleri | Belirli tipteki proxy’lere göre filtreleme yapılmasını sağlar. |
| Oluşturma Tipi | Çeşitli metrik türleri | Proxy oluşturma yöntemine göre filtreleme yapılmasını sağlar. |
| Organizasyonlar | ACL Raporu | Raporun hangi organizasyonları kapsayacağını belirler. |
| Credential’lar | ACL Raporu | Raporun hangi credential’ları kapsayacağını belirler. |
| Sorgu Temeli | ACL Raporu | Raporun API Proxy bazlı mı yoksa organizasyon bazlı mı çalışacağını belirler. |
| API Proxy | API Trafik Metrikleri | Raporun yalnızca belirli bir proxy üzerinde çalışmasını sağlar. |
Ortam
Raporun hangi ortam üzerinde çalıştırılacağı bu adımda seçilir.
Elasticsearch tabanlı rapor türlerinde ortam seçimi zorunludur. Seçilen ortamın Elasticsearch entegrasyonunun aktif olması gerekir.
Zamanlama
Raporun otomatik olarak çalıştırılma sıklığı bu bölümde belirlenir. Zamanlama ayarları, cron ifadesi formatında oluşturulur.
Zamanlama yapılmadan önce Raporu Test Et özelliğini kullanarak raporun doğru sonuçlar ürettiğini doğrulamanız önerilir.
Eylem
Rapor çalıştırıldığında oluşturulan dosyanın nereye iletileceği bu bölümde tanımlanır. Bir veya birden fazla alıcı eklenebilir.
Desteklenen eylem türleri arasında e-posta ve webhook bulunmaktadır. Eylemler hakkında detaylı bilgi için Konnektörler sayfasını inceleyebilirsiniz.
Rapor dosyasının boyutu 25 MB sınırını aştığında eylem çalıştırılmaz ve kullanıcıya bildirim gösterilir. Bu durumda tarih aralığını daraltmanız önerilir.
Saklama Süresi
Geçmiş rapor çalışmalarına ait sonuç kayıtlarının ne kadar süre tutulacağı bu bölümde belirlenir. Belirtilen sürenin sonunda eski sonuçlar otomatik olarak temizlenir.
Raporu Test Etme
Raporu kaydetmeden önce mevcut ayarlarla anlık olarak test etme imkânı sunulur.
API Trafik Logları
Diğer Rapor Türleri
Sorgu ve filtre tanımlandıktan sonra Sorgula butonu ile seçilen ortam üzerinde sorgu anlık olarak çalıştırılır. Sonuçlar sayfalı tablo görünümünde ekranda listelenir.Önizlemede yalnızca ilk 10 kayıt gösterilir. Tüm sonuçları görmek için raporu zamanlayarak çalıştırmanız gerekir.
Raporu Test Et butonu ile seçilen rapor türüne ait veriler anlık olarak çekilir ve tablo önizlemesi gösterilir.Önizlemede yalnızca ilk 10 kayıt gösterilir. Tüm sonuçlar için raporu zamanlayarak çalıştırmanız gerekir.
Rapor Sonuçları
Kayıtlı bir rapor üreticinin geçmiş çalışma sonuçları, listeden ilgili kayda tıklanarak açılan detay ekranından görüntülenebilir. Ekranın sağ üst köşesindeki Edit Report Generator bağlantısı ile tanım düzenleme sayfasına geçilebilir.
| Sütun | Açıklama |
|---|
| Application Log Time | Raporun çalıştırıldığı tarih ve saat. |
| Size of File | Oluşturulan rapor dosyasının boyutu (byte cinsinden). |
| Result Type | Raporun başarılı mı yoksa hatalı mı tamamlandığını gösterir. |
Tarih Aralığı Filtresi
Sonuçlar, ekranın üst bölümündeki tarih aralığı seçici ile filtrelenebilir. Göreli zaman aralıkları (örn. “Son 1 saat”) ya da sabit tarih aralıkları tanımlanabilir.
Sonuç Yönetimi
- Her satırın sağındaki silme ikonu ile tek bir sonuç kaydı silinebilir.
- Tablo başlığındaki Delete All butonu ile o rapor üreticiye ait tüm geçmiş sonuçlar tek seferde temizlenebilir.
Tüm sonuçları silme işlemi geri alınamaz. Silmeden önce gerekli kayıtları dışa aktarmanız önerilir.
