Genel Bakış
Amacı Nedir?
Amacı Nedir?
Merkezi Log Toplama
Trafik Yönetimi
Güvenlik
Ortam 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ı
Merkezi Log Aktarımı
Gerçek Zamanlı İzleme
Erken Uyarı Mekanizması
SIEM Entegrasyonu
Teknik Özellikler ve Yetenekler
Temel Özellikler
Temel Özellikler
GELF Transport Seçimi
Sıkıştırma Politikası
Ortam Bazlı Yapılandırma
Enable/Disable Kontrolü
İleri Düzey Özellikler
İleri Düzey Özellikler
TLS Sertifika Zinciri Yükleme
Gelişmiş TCP Ayarları
Çoklu Parçacık Gönderimi
Connection Test Özelliği
Export/Import Özelliği
Connection Monitoring
Connection Parametreleri
Zorunlu Parametreler
Zorunlu Parametreler
Name
Örnek Değer:
Production_GraylogNotlar: Boşlukla başlamaz, özel karakterler kullanılmamalı
Environment (Ortam)
Örnek Değer:
prod-env-01Notlar: Ortam yayımlanmamışsa kayıt engellenir
Hostname
Örnek Değer:
graylog.internal.localNotlar: Üretim için FQDN kullanın
Port
Örnek Değer: 12201
Notlar: TCP/UDP aynı portu paylaşabilir
TransportType
Örnek Değer: TCP
Notlar: TCP önerilir; UDP için güvenilir ağ gerekir
CompressionType
Örnek Değer: GZIP
Notlar: NONE seçildiğinde bant genişliği artar
GelfMessageLevel
Örnek Değer: WARNING
Notlar: Seçim Graylog içinde filtreleme sağlar
QueueSize
Örnek Değer: 512
Notlar: Yüksek değer RAM tüketimini artırır
ReconnectDelay (ms)
Örnek Değer: 2500
Notlar: Milisaniye cinsinden
ConnectTimeout (ms)
Örnek Değer: 10000
Notlar: Ağ gecikmelerine göre ayarlayın
SendBufferSize (byte)
Örnek Değer: -1
Notlar: -1 sistem varsayılanını kullanır
MaxInflightSends
Örnek Değer: 512
Notlar: Fazla değer Graylog tarafında baskı yaratabilir
Threads
Örnek Değer: 0
Notlar: 0 CPU çekirdeğine göre otomatik ayarlar
İsteğe Bağlı Parametreler
İsteğe Bağlı Parametreler
Description
Varsayılan Değer: (Boş)
Önerilen Değer: Prod log forwarding for CoreAPI
TLS Enabled
Varsayılan Değer: false
Önerilen Değer: true (Production)
TLS Cert Verification Enabled
Varsayılan Değer: false
Önerilen Değer: true (Production)
TLS Trust Cert Chain File
Varsayılan Değer: (Boş)
Önerilen Değer: graylog-ca.pem
TCP No Delay
Varsayılan Değer: true
Önerilen Değer: true
TCP Keep Alive
Varsayılan Değer: false
Önerilen Değer: true (uzak DC)
Append To Attributes
Varsayılan Değer: true
Önerilen Değer: true
Append To Message
Varsayılan Değer: true
Önerilen Değer: true
Timeout ve Connection Pool Parametreleri
Connection Timeout
Varsayılan: 10000
Min: 1000 | Max: 60000
Birim: milisaniye
Request Timeout
Varsayılan: N/A
Min: - | Max: -
Birim: milisaniye
Pool Size
Varsayılan: threads değeri ile belirlenir
Min: 1 | Max: 64
Birim: adet
ReconnectDelay
Varsayılan: 2500
Min: 500 | Max: 60000
Birim: milisaniye
Kullanım Senaryoları
Gerçek Zamanlı API Loglama
Çözüm: TransportType=TCP, Compression=GZIP, GelfLevel=ERROR
Beklenen Davranış: Graylog tarafında sadece hata logları görünür, bant genişliği optimize edilir
SIEM Entegrasyonu
Çözüm: GelfLevel=ALERT, AppendToAttributes=true
Beklenen Davranış: SIEM, ek attribute’lar sayesinde alarm bağlamını zenginleştirir
Düşük Gecikmeli İzleme
Çözüm: TransportType=UDP, QueueSize=256
Beklenen Davranış: Az gecikme ile loglar gönderilir, olası kayıplar kabul edilir
Çoklu DC Graylog
Çözüm: TLS Enabled=true, TLS Cert Verification=true, sertifika yükle
Beklenen Davranış: Şifreli kanal kurulur, self-signed sertifikalar reddedilir
Yoğun Batch İşleri
Çözüm: QueueSize=2048, Threads=8, MaxInflight=1024
Beklenen Davranış: Kuyruk taşmadan log transferi tamamlanır
Test Ortamı Gözlemi
Çözüm: GelfLevel=DEBUG, Compression=NONE
Beklenen Davranış: Troubleshooting için tüm loglar sıkıştırmasız iletilir
Connection Yapılandırma
Yeni Graylog Connection Oluşturma

Yapılandırma Adımları
Oluşturma Sayfasına Gitme
- Sol menüden Connection → Graylog bölümüne gidin.
- Sağ üstteki [+ Create] butonuna tıklayın.
Temel Bilgileri Girme
- Toggle ile aktif/pasif durumu ayarlayın. Yeni connection’lar varsayılan olarak aktiftir.
- Örnek:
Production_Graylog - Benzersiz isim girin, boşlukla başlamaz.
- Sistem otomatik kontrol eder. Yeşil tik: kullanılabilir. Kırmızı çarpı: mevcut isim.
- Örnek: “Graylog prod ingestion”
- 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.
Graylog Spesifik Parametreler - Ağ
- Hostname & Port: Graylog GELF listener bilgilerini girin.
- TransportType: TCP (güvenilir) veya UDP (düşük gecikme) seçin.
- CompressionType: GZIP/ZLIB/NONE seçeneklerini latency ve CPU’ya göre belirleyin.
- Hostname yanlış ise log kaybı yaşanır.
Graylog Spesifik Parametreler - Log & Kuyruk
- GELF Message Level: Debug’dan Emergency’ye kadar uygun seviyeyi seçin.
- QueueSize, Threads, MaxInflightSends: Log hacmine göre değerleri ayarlayın.
- Append seçenekleri: Apinizer metadata’sının loglara dahil edilip edilmeyeceğini belirleyin.
Timeout ve Connection Pool Ayarları
- ConnectTimeout & ReconnectDelay: Ağ koşullarına göre ms cinsinden belirleyin.
- SendBufferSize: -1 sistem varsayılanı, özel alanlarda byte değeri girin.
- Yoğun trafikte Pool exhausted uyarısını önlemek için threads değerini artırın.
Güvenlik ve Authentication Ayarları
- TLS Enabled: Production’da zorunlu.
- TLS Cert Verification Enabled: Doğrulama açıldığında sertifika yükleyin.
- TLS Trust Cert Chain File: PEM dosyasını UI’dan yükleyin, maksimum 100 MB.
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.
- Benzersiz isim
- Zorunlu alanlar dolu
- Test connection başarılı (önerilir)
- 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}-graylog-integration-{ConnectionName}-export.zipÖrnek:
13 Nov 2025-graylog-integration-Production_Graylog-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 Graylog] 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 Şeması Standardizasyonu
İyi: Ortak alan isimleri kullanmak
En İyi: Apinizer context attribute’larını zorunlu hale getirip Graylog pipeline’ı ile doğrulamak
Sıkıştırma Stratejisi
İyi: Production’da GZIP kullanmak
En İyi: Trafiğe göre dinamik politika belirlemek ve Graylog tarafında decompress maliyetini izlemek
Transport Seçimi
İyi: Prod’da TCP, Test’te UDP kullanmak
En İyi: TCP + TLS’i zorunlu tutmak, UDP’yi yalnızca düşük riskli metrikler için kullanmak
Kuyruk Boyutu Yönetimi
İyi: Trafik analizine göre 512-1024 arası ayarlamak
En İyi: Peak load ölçümlerine göre otomasyonla queue/buffer ayarlarını güncellemek
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ı
TLS Sertifika Yönetimi
Ağ Segmentasyonu
Log İçeriği Maskesi
Kimlik Bilgileri Yönetimi
SSL/TLS Kullanımı
Erişim Kontrolü
Kaçınılması Gerekenler
Kaçınılması Gerekenler
UDP'de Yüksek Kritik Loglama
Alternatif: TCP + TLS kullanın
Yanlış Log Seviyesi
Alternatif: Seviyeyi iş ihtiyacına göre belirleyin, pipeline filtreleri ekleyin
Sertifika Dosyası Güncellememek
Alternatif: Takvim hatırlatmalarıyla sertifika yenileyin
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ı
Batch Gönderim Boyutu
Etki: Gecikme azalır, throughput artar
Sıkıştırma Dengesi
Etki: CPU tüketimi dengelenir, kritik dönemlerde log gecikmesi düşer
Thread Ayarı
Etki: Sistem kaynakları dengede kalır, throttling 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)
GELF Mesaj Reddediliyor
GELF Mesaj Reddediliyor
Mesaj Boyutu
JSON Şeması
Pipeline Logları
TLS Handshake Başarısız
TLS Handshake Başarısız
Sertifika Yükleme
Hostname Doğrulama
TLS Ayarları
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)
Graylog Connection kaç projede paylaşılabilir?
Graylog Connection kaç projede paylaşılabilir?
Graylog'a aynı anda kaç ortam bağlanabilir?
Graylog'a aynı anda kaç ortam bağlanabilir?
TLS sertifika dosyası hangi formatta olmalı?
TLS sertifika dosyası hangi formatta olmalı?
GELF transport değiştirince yeniden deploy gerekir mi?
GELF transport değiştirince yeniden deploy gerekir mi?
Log seviyesini Graylog içinde mi yoksa Connection'da mı ayarlamalıyım?
Log seviyesini Graylog içinde mi yoksa Connection'da mı ayarlamalıyım?
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

