Rapor Üretici

Apinizer’da log verileriniz üzerinde özel sorgular ve filtreler tanımlayarak belirli aralıklarla otomatik rapor oluşturabilirsiniz. Rapor sonuçlarını e-posta veya webhook gibi farklı kanallara yönlendirebilirsiniz.

​

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.

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

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ığı.

Request Fields

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.

Response Fields

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ı

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.

Diğer Rapor Türleri

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.

​

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.