Genel Bakış
Amacı Nedir?
Amacı Nedir?
Merkezi Log Toplama
Disk Tüketimi Kontrolü
Ortam Bazlı Ayrıştırma
Güvenlik ve İzin Yönetimi
Çalışma Prensibi
Çalışma Prensibi
Bağlantı Başlatma
Connection Pool Yönetimi
Kimlik Doğrulama
Veri İletişimi
Bağlantı Yönetimi
Hata Yönetimi
Kullanım Alanları
Kullanım Alanları
API Proxy Trafik Loglama
Request/Response İzleme
Log Retention Politikaları
Güvenlik İncelemeleri
Teknik Özellikler ve Yetenekler
Temel Özellikler
Temel Özellikler
Log Dizini Yönetimi
Dosya İsimlendirme Desenleri
Depolama Limit Kontrolü
Ortam Bazlı Yapılandırma
Enable/Disable Kontrolü
İleri Düzey Özellikler
İleri Düzey Özellikler
Anlık Test Desteği
İsim Çakışması Engeli
Global Taşıma
Connection Test Özelliği
Export/Import Özelliği
Connection Monitoring
Connection Parametreleri
Zorunlu Parametreler
Zorunlu Parametreler
Name
Örnek Değer:
Production_LogbackNotlar: Boşlukla başlamaz, özel karakterler kullanılmamalı
Log Path (logPath)
Örnek Değer:
/var/log/apinizer/Notlar: Worker pod’unun yazma izni olmalı, mutlak path önerilir
Log File Name (logFileName)
Örnek Değer:
ApinizerApiProxyTrafficNotlar: Harf, rakam ve
_ kullanılması önerilirLog Filename Pattern (logFilenamePattern)
Örnek Değer:
%d{yyyy-MM-dd}.%i.logNotlar: Logback pattern’leri desteklenir, tarih formatı zorunludur
Log Pattern (logPattern)
Örnek Değer:
%d{yyyy-MM-dd HH:mm:ss.SSS}[%t]%nNotlar: Tümü Logback conversion pattern’leriyle uyumludur
Max File Size (maxFileSize)
Örnek Değer: 25
Notlar: Pozitif tamsayı, 1-1024 MB aralığı önerilir
Max History (maxHistory)
Örnek Değer: 30
Notlar: 0 sınırsız anlamına gelir ancak disk büyüyebilir
Total Size Cap (totalSizeCap)
Örnek Değer: 1024
Notlar: 0 ise Logback toplam limit uygulamaz; Production için >512 MB önerilir
İsteğe Bağlı Parametreler
İsteğe Bağlı Parametreler
Description
Varsayılan Değer: ”
Önerilen Değer: İşlevi ve hedef sistemi belirten kısa açıklama
Environment (environmentId)
Varsayılan Değer: null
Önerilen Değer: Her ortam için ayrı değer seçilmesi önerilir
Log Pod Name (logPodName)
Varsayılan Değer: ”
Önerilen Değer: Multi-node kümelerde sadece hedef pod’a yazmak gerektiğinde kullanın
Deploy To Worker (deployToWorker)
Varsayılan Değer: true
Önerilen Değer: Sadece yönetim node’unda test amaçlı tutulacaksa false
Enable Status
Varsayılan Değer: true
Önerilen Değer: Production’da her zaman aktif, sorun çözülürken geçici olarak kapatılabilir
Timeout ve Connection Pool Parametreleri
Connection Timeout
Varsayılan: Uygulanmaz
Min: - | Max: -
Birim: milisaniye
Request Timeout
Varsayılan: Uygulanmaz
Min: - | Max: -
Birim: milisaniye
Pool Size
Varsayılan: Uygulanmaz
Min: - | Max: -
Birim: adet
Flush Interval
Varsayılan: 1000
Min: 250 | Max: 5000
Birim: milisaniye
Kullanım Senaryoları
API Proxy Trafik İzleme
Çözüm: logPath=/var/log/apinizer/proxy, maxHistory=30, totalSizeCap=2048
Beklenen Davranış: Tüm çağrılar 30 günlük geçmişle saklanır, SIEM’e okunabilir
Güvenlik Olay İncelemesi
Çözüm: logFilenamePattern=
%d{yyyy-MM-dd}-security.%i.logBeklenen Davranış: Tarih bazlı dosyalar hızlıca filtrelenir, olay süresi içinde inceleme yapılır
Entegrasyon Testleri
Çözüm: environmentId=Test, maxFileSize=10
Beklenen Davranış: Test logları küçük dosyalara ayrılır, geliştiriciler kolayca indirir
Pod Bazlı Ayırma
Çözüm: logPodName=gateway-worker-2
Beklenen Davranış: Sadece ilgili pod’dan log alınır, hedef sorun izole edilir
Regülasyon Arşivleme
Çözüm: maxHistory=0, totalSizeCap=5120
Beklenen Davranış: Sonsuz döngü yerine toplam kota ile yasal saklama süresi sağlanır
Disaster Recovery
Çözüm: logPath=/mnt/dr/logs, Enable Export All açık
Beklenen Davranış: Failover senaryosunda tüm loglar paylaşılan depoya yazılır
Connection Yapılandırma
Yeni Logback Oluşturma

Oluşturma Sayfasına Gitme
- Sol menüden Connection → Logback bölümüne gidin.
- Sağ üstteki [+ Create] butonuna tıklayın.
Temel Bilgileri Girme
Production_Logback- Benzersiz isim girin, boşlukla başlamaz.
- Sistem otomatik kontrol eder. Yeşil tik: kullanılabilir. Kırmızı çarpı: mevcut isim.
- Maks. 1000 karakter.
- Connection’ın amacını açıklayın.
Environment (Ortam) Seçimi
- Dropdown menüden ortam seçin: Development, Test, veya Production.
- Her ortam için farklı connection parametreleri tanımlanabilir.
Logback Spesifik Parametreler - Dizin ve Adlandırma
- logPath alanına worker node’un yazabildiği mutlak dizini girin.
- logFileName ve logFilenamePattern alanlarıyla RollingFileAppender dosya döngüsünü belirleyin; tarih ve indeks içermesine dikkat edin.
- Yetkisiz dizinler deploy aşamasında hata üretir.
Logback Spesifik Parametreler - İçerik ve Format
- logPattern alanını Logback conversion pattern’leriyle doldurun, gerekirse thread adı veya request-id ekleyin.
- Eğer belirli pod’a yönlendirme gerekiyorsa logPodName alanını kullanın.
Timeout ve Connection Pool Ayarları
- Logback dosya yazımı için ayrı timeout yoktur; gerekirse JVM seviyesinde flush interval ayarlarını deployment descriptor üzerinden güncelleyin.
- Disk kotaları için maxFileSize, maxHistory, totalSizeCap değerlerini operasyon politikalarına uygun şekilde belirleyin.
Güvenlik ve Authentication Ayarları
- Worker node kullanıcı hesabının logPath üzerinde yazma izni olduğundan emin olun.
- Gerekiyorsa dosya sistemi ACL’leri veya Kerberos destekli paylaşım noktaları kullanın.
- Production ortamında paylaşılan dizinlere sadece yetkili servis hesaplarının erişmesine izin verin.
Test Connection
- [Test Connection] butonuna tıklayın.
- Bağlantı parametrelerinin doğru olup olmadığını test edin.
- Başarılı: Yeşil onay mesajı, Başarısız: Hata detayları gösterilir.
Kaydetme
- Sağ üstteki [Save and Deploy] butonuna tıklayın.
- Connection listeye eklenir.
- Integration Flow ve Connector adımlarında kullanılabilir hale gelir.
- Ortama göre aktif olur.
Connection’ı Silme
Connection’ı silmek için:Yöntem 1: Liste Ekranından
- Connection listesinde satır sonundaki ⋮ menüsünden Delete seçeneğini tıklayın.
- Onay dialogunda silme işlemini onaylayın.
Silme İpuçları
- Integration Flow veya Connector adımlarında kullanılıyor olabilir.
- Gerekirse alternatif bir connection atayın.
- Silmeden önce Export ile yedek alın.
Alternatif: Deaktif Etme
- Silmek yerine connection’ın aktif durumunu pasif hale getirin.
- Connection pasif olur ancak silinmez.
- Gerektiğinde aktif hale getirerek yeniden kullanabilirsiniz.
Connection’ı Dışa/İçe Aktarma
Dışa Aktarma (Export)
Dışa Aktarma (Export)
Yöntem 1: Liste Ekranından
- Connection listesinde satır sonundaki ⋮ menüsünden Export seçeneğini tıklayın.
- ZIP dosyası otomatik olarak indirilir.
Dosya Formatı
{Date}-logback-integration-{ConnectionName}-export.zipÖrnek:
13 Nov 2025-logback-integration-Production_Logback-export.zipZIP İçeriği
- Connection JSON dosyası
- Metadata bilgileri
- Bağımlılık bilgileri (örneğin sertifikalar, key store)
Kullanım Alanları
- Yedekleme
- Ortamlar arası taşıma (Test → Prod)
- Versiyonlama
- Ekip veya proje bazlı paylaşım
İçe Aktarma (Import)
İçe Aktarma (Import)
İçe Aktarma Adımları
- Ana listede [Import Logback] butonuna tıklayın.
- İndirilen ZIP dosyasını seçin.
- Sistem kontrolleri: Format geçerli mi? İsim çakışması var mı? Bağımlılıklar mevcut mu?
- Ardından [Import] butonuna tıklayın.
İçe Aktarma Senaryoları
Connection’ın Kullanım Alanları
Connection Oluşturma ve Aktif Etme
- Connection’ı oluşturun.
- Test Connection ile bağlantıyı doğrulayın.
- Save and Deploy ile kaydedin ve etkinleştirin.
- Connection’ın Enabled durumda olduğundan emin olun.
Integration / Connector Adımlarında Kullanım
Scheduled Job Kullanımı
Test Amaçlı Kullanım
Best Practices
Yapılması Gerekenler ve En İyi Uygulamalar
Yapılması Gerekenler ve En İyi Uygulamalar
Log Dizini Seçimi
İyi: Ayrı bir
/var/log/apinizer dizini açmak.En İyi: Ayrılmış disk veya mount point üzerinde sadece servis hesabına izin vermek.
Dosya Deseni Yönetimi
İyi: Günlük tarihli desen kullanmak.
En İyi: Tarih + indeks ve uygulama adı içeren desenle SIEM uyumluluğu sağlamak.
Depolama Politikası
İyi: Trafiğe göre makul değerler belirlemek.
En İyi: Disk kapasitesi, regülasyon ve yedekleme süreçlerine göre otomatik temizleme kuralları koymak.
Pod Bazlı Yönlendirme
İyi: Sorunlu pod’lar için logPodName kullanmak.
En İyi: Her pod için ayrı dizin + merkezi toplama pipeline’ı kurmak.
Ortam Yönetimi
İyi: Her ortam için ayrı connection oluşturmak.
En İyi: Environment seçeneğini kullanarak tek connection’da tüm ortamları yönetmek, ortamlar arası geçişte sadece environment değiştirmek
Connection Test
İyi: Kaydetmeden önce Test Connection ile doğrulamak.
En İyi: Her parametre değişikliğinden sonra test etmek, production’a geçmeden önce test ortamında tam entegrasyon testi yapmak
Güvenlik En İyi Uygulamaları
Güvenlik En İyi Uygulamaları
Dosya Sistemi Erişim Kontrolü
Paylaşılan Depolama Güvenliği
Log İçeriği Maskeleme
Kimlik Bilgileri Yönetimi
SSL/TLS Kullanımı
Erişim Kontrolü
Kaçınılması Gerekenler
Kaçınılması Gerekenler
Paylaşılan Root Dizine Yazmak
Alternatif: Ayrı mount edilmiş log dizini kullanın
Yanlış Tarih Deseni
Alternatif:
%d içeren desenler kullanınKota Tanımlamamak
Alternatif: maxFileSize, maxHistory ve totalSizeCap değerlerini sistem kapasitesine göre belirleyin
Production Connection'ı Test Ortamında Kullanma
Alternatif: Her ortam için ayrı connection oluşturun, environment parametresini kullanın, connection isimlerini ortama göre prefix ekleyerek ayırın (Test_, Prod_)
Çok Düşük Timeout Değerleri
Alternatif: Gerçek kullanım senaryolarına göre timeout değerlerini ayarlayın, network latency’yi ölçün ve timeout’ları buna göre belirleyin
Connection Pool Kullanmama
Alternatif: Connection pool aktif edin, pool size’ı trafik hacmine göre ayarlayın, pool monitoring kurun
Performans İpuçları
Performans İpuçları
Disk IO Optimizasyonu
noatime mount seçeneği kullanınEtki: Yazma gecikmeleri azalır, log kaydı kesintisizleşir
Pattern Minimalizmi
Etki: CPU kullanımı düşer, log throughput artar
Retention Otomasyonu
Etki: Disk doluluk riskleri ortadan kalkar, manuel müdahale ihtiyacı azalır
Connection Pool Optimizasyonu
Etki: Bağlantı açma maliyeti %80 azalır, yanıt süreleri düşer, kaynak kullanımı optimize edilir
Timeout Değerleri Optimizasyonu
Etki: Gereksiz beklemeler önlenir, hızlı fail-over sağlanır, kullanıcı deneyimi iyileşir
Connection Monitoring
Etki: Sorunlar proaktif tespit edilir, performans darboğazları erken belirlenir, kesinti süresi azalır
Sorun Giderme (Troubleshooting)
Log Dosyası Oluşmuyor
Log Dosyası Oluşmuyor
LogPath Doğrulama
Kullanıcı İzinleri
Enable Durumu
Dosya Boyutu Limitini Aşıyor
Dosya Boyutu Limitini Aşıyor
MaxFileSize Artırma
MaxHistory Limit
TotalSizeCap Tanımlama
Connection Timeout
Connection Timeout
Network Kontrolü
Sistem Sağlığı
Timeout Ayarları
Log İnceleme
Authentication Failed
Authentication Failed
Kimlik Bilgileri
Kullanıcı Durumu
Yetki Kontrolü
Sertifika Kontrolü
Pool Exhausted
Pool Exhausted
Pool Size
Connection Kontrolü
Idle Timeout
Metrik İzleme
Connection Test Başarılı Ama Entegrasyon Akışı Hata Veriyor
Connection Test Başarılı Ama Entegrasyon Akışı Hata Veriyor
Enable Toggle
Connection Seçimi
Connection Deploy
Flow/Job Deploy
Log Kontrolü
Sık Sorulan Sorular (SSS)
Logback Connection için minimum hangi parametreleri girmeliyim?
Logback Connection için minimum hangi parametreleri girmeliyim?
Logları aynı anda hem dosyaya hem de harici sisteme aktarabilir miyim?
Logları aynı anda hem dosyaya hem de harici sisteme aktarabilir miyim?
logPodName değerini boş bırakırsam ne olur?
logPodName değerini boş bırakırsam ne olur?
maxHistory ile totalSizeCap çelişirse hangisi öncelikli olur?
maxHistory ile totalSizeCap çelişirse hangisi öncelikli olur?
Logları harici SIEM aracına nasıl taşıyabilirim?
Logları harici SIEM aracına nasıl taşıyabilirim?
Aynı connection'ı birden fazla Integration Flow'da kullanabilir miyim?
Aynı connection'ı birden fazla Integration Flow'da kullanabilir miyim?
Connection pool kullanmak zorunlu mudur?
Connection pool kullanmak zorunlu mudur?
Test ve Production için farklı connection'lar mı oluşturmalıyım?
Test ve Production için farklı connection'lar mı oluşturmalıyım?
Test Connection başarılı ama Integration Flow'da çalışmıyor, neden?
Test Connection başarılı ama Integration Flow'da çalışmıyor, neden?
- Connection enable toggle’ı pasif olabilir
- Integration adımında farklı bir connection seçili olabilir
- Connection deploy edilmemiş olabilir
- Integration Flow henüz redeploy edilmemiş olabilir

