Graylog
Genel Bakış
Amacı Nedir?
Apinizer log olaylarını GELF formatında tek bir merkezde toplamayı sağlar
Trafik yoğunluğunu kuyruk ve sıkıştırma ayarlarıyla yöneterek log teslim sürekliliği sunar
TLS/sertifika doğrulama seçenekleriyle log kanalı üzerinden gönderilen veriyi güvence altına alır
Ortam bazlı parametrelerle Development/Test/Production ayrımını koruyarak yönetim maliyetini düşürür
Çalışma Prensibi
Integration Flow veya Connector içerisinden Graylog connection talep edildiğinde, sistem yapılandırılmış connection parametrelerini okur
maxInflightSends ve queueSize değerlerine göre asenkron gönderim kuyruğu, threads sayısı kadar arka plan iş parçacığıyla yönetilir; bu bir connection pool değil, kalıcı tek bağlantı üzerinden çalışan kuyruklama modelidir
TLS aktifse mutual TLS ve sertifika zinciri doğrulaması uygulanır; aksi halde ağ seviyesinde IP whitelisting kullanılır
GELF mesajları seçilen transportType (TCP veya UDP) üzerinden sıkıştırma politikasına göre kodlanıp Graylog endpoint'ine gönderilir
İşlem tamamlandıktan sonra bağlantı açık kalır (kalıcı bağlantı); uzun süre kullanılmazsa tcpKeepAlive ayarı devreye girer
Bağlantı hatası, timeout veya authentication hatası durumunda reconnectDelay süresi beklenir, olay log'lanır ve kullanıcıya detaylı hata mesajı gösterilir
Kullanım Alanları
Tüm Apinizer node'larının uygulama loglarını merkezi Graylog cluster'ına aktarma
Integration Flow adımlarında özel işlev loglarını (ör. harici API cevapları) gerçek zamanlı izleme
Scheduled Job sonuçlarını veya gateway health metriklerini log'layarak erken uyarı mekanizması sağlama
Güvenlik/SIEM ekibine özel GELF seviyeleriyle anomali tespiti için veri besleme
Teknik Özellikler ve Yetenekler
Temel Özellikler
TCP ve UDP arasında seçim yaparak güvenilirlik/performans dengesini kullanıcıya bırakır.
GZIP, ZLIB veya NONE seçenekleriyle bant genişliğini optimize eder.
Her ortam (Development, Test, Production) için ayrı connection parametreleri tanımlama imkanı.
Connection'ı aktif veya pasif hale getirme (enable/disable toggle). Pasif durumda bağlantı kullanılamaz ancak yapılandırması saklanır.
İleri Düzey Özellikler
PEM tabanlı sertifika dosyasını UI üzerinden içe aktarma ve doğrulama.
tcpNoDelay, tcpKeepAlive ve sendBufferSize değerleriyle ağ optimizasyonu.
threads ve maxInflightSends parametreleriyle yüksek hacimli logları ölçekler.
"Test Connection" butonu ile bağlantı parametrelerini kaydetmeden önce doğrulama imkanı.
Connection yapılandırmasını ZIP dosyası olarak export etme. Farklı ortamlara (Development, Test, Production) import etme. Versiyon kontrolü ve yedekleme imkanı.
Bağlantı sağlığı ve gönderim performans metriklerini izleme.
Connection Parametreleri
Zorunlu Parametreler
Açıklama: Connection adı (benzersiz olmalı)
Örnek Değer: Production_Graylog
Notlar: Boşlukla başlamaz, özel karakterler kullanılmamalı
Açıklama: Logların yönlendirileceği yayınlanmış ortam kimliği
Örnek Değer: prod-env-01
Notlar: Ortam yayımlanmamışsa kayıt engellenir
Açıklama: Graylog GELF endpoint DNS/IP adresi
Örnek Değer: graylog.internal.local
Notlar: Üretim için FQDN kullanın
Açıklama: GELF listener portu
Örnek Değer: 12201
Notlar: TCP/UDP aynı portu paylaşabilir
Açıklama: Bağlantı taşıma türü (TCP/UDP)
Örnek Değer: TCP
Notlar: TCP önerilir; UDP için güvenilir ağ gerekir
Açıklama: GELF mesaj sıkıştırma politikası
Örnek Değer: GZIP
Notlar: NONE seçildiğinde bant genişliği artar
Açıklama: Minimum log seviyesi
Örnek Değer: WARNING
Notlar: Seçim Graylog içinde filtreleme sağlar
Açıklama: UI tarafındaki log bekleme kuyruğu boyutu
Örnek Değer: 512
Notlar: Yüksek değer RAM tüketimini artırır
Açıklama: Kesinti sonrası yeniden bağlanma gecikmesi
Örnek Değer: 2500
Notlar: Milisaniye cinsinden
Açıklama: Bağlantı kurulurken beklenecek süre
Örnek Değer: 10000
Notlar: Ağ gecikmelerine göre ayarlayın
Açıklama: TCP send buffer büyüklüğü
Örnek Değer: -1
Notlar: -1 sistem varsayılanını kullanır
Açıklama: Eşzamanlı gönderim sayısı
Örnek Değer: 512
Notlar: Fazla değer Graylog tarafında baskı yaratabilir
Açıklama: Arka plan log gönderim iş parçacığı sayısı
Örnek Değer: 0
Notlar: 0 CPU çekirdeğine göre otomatik ayarlar
İsteğe Bağlı Parametreler
Açıklama: Connection amacı hakkında açıklama
Varsayılan Değer: (Boş)
Önerilen Değer: Prod log forwarding for CoreAPI
Açıklama: GELF trafiğinde TLS kullanımı
Varsayılan Değer: false
Önerilen Değer: true (Production)
Açıklama: Sunucu sertifika doğrulaması
Varsayılan Değer: false
Önerilen Değer: true (Production)
Açıklama: PEM sertifika zinciri dosyası
Varsayılan Değer: (Boş)
Önerilen Değer: graylog-ca.pem
Açıklama: Nagle algoritmasını devre dışı bırakır
Varsayılan Değer: true
Önerilen Değer: true
Açıklama: Pasif bağlantıları saklar
Varsayılan Değer: false
Önerilen Değer: true (uzak DC)
Açıklama: GELF ek alanlarına Apinizer metadata ekler
Varsayılan Değer: true
Önerilen Değer: true
Açıklama: Mesaj gövdesine Apinizer context ekler
Varsayılan Değer: true
Önerilen Değer: true
Zaman Aşımı ve Gönderim Parametreleri
Açıklama: Bağlantı kurulması için maksimum bekleme süresi
Varsayılan: 10000
Birim: milisaniye
Notlar: UI'da yalnızca zorunluluk kontrolü var; min/max yok.
Açıklama: GELF mesajlarını arka planda Graylog'a ileten iş parçacığı sayısı; bir connection pool değildir
Varsayılan: 0 (kütüphane varsayılanı kullanılır)
Notlar: UI'da yalnızca zorunluluk kontrolü var; min/max yok.
Açıklama: Yeniden bağlanma aralığı
Varsayılan: 2500
Birim: milisaniye
Notlar: UI'da yalnızca zorunluluk kontrolü var; min/max yok.