Rapor Üretici
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. |
| Gateway Trafiği (Zamana Göre) | Gateway trafiği belirli zaman dilimlerine (saatlik, günlük vb.) göre gruplanarak analiz edilir. |
| Gateway Trafiği 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. |
| Proxy Raporu | API Proxy'lerin genel durumu ve bilgileri raporlanır. |
| API Endpoint Raporu | API Endpoint'lerin genel durumu ve bilgileri raporlanır. |
| İstek Almayan Endpointler | Belirtilen süre içinde istek almayan endpoint'ler listelenir. |
| İstek Atmayan Clientlar | 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. |
| Hiyerarşiye Göre AI Token Kullanımı | AI token tüketimi ve maliyeti, tüketici organizasyon ağacı üzerinden raporlanır: her organizasyon satırı kendi alt ağacının toplamını taşır, istenirse her tüketici için ayrı satır eklenir. Konsolide kullanım verisini MongoDB'den okur; bu nedenle Elasticsearch bağlantısı gerektirmez ve ortam adımı uygulanmaz. |
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.
Ham log verilerini daraltmak için isteğe bağlı olarak özel bir sorgu eklenebilir. Sorgu, belirli koşulların sağlandığı log kayıtlarını seçmek amacıyla kullanılır.
İki seçenek sunulur:
- 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.
Raporda hangi log alanlarının yer alacağı bu bölümde seçilir. Alanlar üç kategoride gruplandırılmıştır:
Tümünü Seç ve Tümünü Kaldır butonları ile toplu işlem yapılabilir.
- 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 | Gateway Trafiği (Zamana Göre) | Trafik verilerinin gruplanacağı zaman dilimi: saniyelik, dakikalık, saatlik, günlük, haftalık, aylık, üç aylık veya yıllık. |
| Kırılım boyutu | Gateway Trafiği (Zamana Göre) | Raporu boyut değeri başına ayrı bir seriye böler: API Proxy, HTTP Metodu, Consumer (kullanıcı adı), API Client, Consumer / Uygulama veya Organizasyon. Varsayılan Yok (sistem geneli) değeri, tüm trafiği kapsayan tek bir seri üretir. Seçildiğinde çıktıya Kırılım sütunu eklenir. Kimlik tabanlı üç boyut (API Client, Consumer / Uygulama, Organizasyon) bu yükseltmeden önce kaydedilmiş trafik için boş görünür ve doğrulanamayan istekleri kapsamaz. |
| Değer birimi | Gateway Trafiği (Zamana Göre) | Değerlerin İstek Sayısı (her kovadaki ham sayı) olarak mı yoksa TPS (istek/saniye) olarak mı raporlanacağı. TPS her kovayı gerçek süresine böler; farklı uzunluktaki kovalar ancak böyle karşılaştırılabilir. TPS seçildiğinde çıktıya TPS sütunu eklenir. |
| API Proxy Tipi | Çeşitli metrik türleri | Belirli tipteki API Proxy'lere göre filtreleme yapılmasını sağlar. Tüm tipler seçilebilir: REST, SOAP, gRPC, WebSocket, AI, MCP ve A2A. |
| Oluşturma Tipi | Çeşitli metrik türleri | API Proxy oluşturma yöntemine göre filtreleme yapılmasını sağlar. |
| Yönlendirme adresini göster | API Proxy Oluşturma, API Endpoint Oluşturma | Rapora, API Proxy'nin isteği ilettiği hedef adresleri içeren bir sütun ekler. Varsayılan olarak kapalıdır. |
| Yönlendirme koşulunu göster | API Proxy Oluşturma, API Endpoint Oluşturma | Bir hedefe yalnızca belirli koşullar sağlandığında yönlendirme yapılıyorsa o koşulun özetini ekler. Yönlendirme adresi seçeneği açık olduğunda kullanılabilir. |
| Organizasyonlar | ACL Raporu, İstek Atmayan Client'lar, Hiyerarşiye Göre AI Token Kullanımı | Raporun hangi organizasyonları kapsayacağını belirler. İstek Atmayan Client'lar raporunda, seçilen kurumların tüketicileri ve API client anahtarlarıyla sınırlar; böylece zamanlanmış çalışma ekrandakiyle aynı kapsamı üretir. Hiyerarşiye Göre AI Token Kullanımı raporu tek bir ağaç çizdiği için yalnızca seçilen ilk organizasyon kullanılır ve o ağacın kökü olur; tüm organizasyonları raporlamak için alanı boş bırakın. |
| Ayrıntı Düzeyi | Hiyerarşiye Göre AI Token Kullanımı | Çıktının yalnızca organizasyon satırlarını mı, yoksa organizasyon satırlarıyla birlikte her tüketici için ayrı bir satırı mı içereceğini belirler. Varsayılan: yalnızca organizasyonlar. |
| Alt Organizasyonları Dahil Et | Hiyerarşiye Göre AI Token Kullanımı | Varsayılan olarak açıktır: organizasyon satırı kendi alt ağacının toplamını taşır. Kapatırsanız yalnızca o organizasyona doğrudan bağlı tüketiciler sayılır. |
| API Client'ları Dahil Et | İstek Atmayan Client'lar | Varsayılan olarak açıktır: her tüketicinin API client anahtarları ayrı satırlar olarak listelenir. Kapatırsanız yalnızca tüketici kimlikleri görünür — ekrandaki filtreyle aynı kapsamı üretir. Bu parametre eklenmeden önce kaydedilmiş rapor konfigürasyonlarının davranışı değişmez, onlar için de açık kabul edilir. |
| 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 | Gateway Trafiği Metrikleri | Raporun yalnızca belirli bir proxy üzerinde çalışmasını sağlar. |
Bu rapor tarih aralığını Filtre adımından alır ve now-7d gibi göreli ifadeler desteklenir; zamanlanmış çalışma böylece her gece tek bir donmuş dönemi tekrarlamak yerine kayan bir pencere üretir. Kayıtlı filtre yoksa son 30 gün kullanılır ve uygulanan aralık uygulama günlüğüne yazılır. Aralık en çok 366 gün olabilir; çünkü AI token bütçeleri aylıktır ve daha geniş bir pencere bütçeyle karşılaştırılamaz. Aşan bir aralık sessizce kırpılmaz, çalışmayı başarısız yapar — böylece başlığıyla içeriği uyuşmayan bir dosya teslim edilmek yerine çalışma başarısız olarak işaretlenir.
Gateway Trafiği (Zamana Göre) raporunda seçilen tarih aralığı, aralık ve kırılım boyutunun birlikte ürettiği zaman kovası sayısı çok yüksekse (ör. çok geniş bir tarihte saniyelik aralık seçmek, ya da ince bir aralık biriminin — örneğin dakikalık — kırılımla birlikte seçilmesi; kırılım kova sayısını katlar), rapor Elasticsearch'e hiç gönderilmeden "seçilen tarih aralığı bu birim için çok geniş" mesajıyla reddedilir — boş bir rapor dönmez. Bu durumda daha kaba bir aralık (ör. saatlik yerine günlük) seçin ya da tarih aralığını daraltın.
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.
Sonuçlar Excel olarak dışa aktarılabilir; bu sayede anlık sorgu çıktısı daha ayrıntılı incelenebilir.
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.
Önizleme sonuçları Excel olarak dışa aktarılabilir.
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. |
Listedeki bir sonuca tıklandığında rapor dosyası indirilir. İndirilen dosya raporun adını ve indirme
zamanını taşır: <rapor adı>-GG-AA-YYYY-SS-dd-ss.zip. Bu, zamanlanmış gönderimde e-posta ekine verilen
adla aynı biçimdir; kaydedilmemiş bir raporda (Dene) dosya adı raporun tipinden üretilir.
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.