Kendi log formatımı tanımlayabilir miyim?

Kısa cevap

Evet. Logs profilinde Line Format olarak Manual JSON Format, Manual CEF Format ya da Manual Log Line Format seçilerek log sunucusuna gidecek satır özelleştirilir. Manual JSON Format ve Manual CEF Format'ta Manual Log Entries tablosuna Key ve Value satırları eklenir ve değerler Smart Variable'larla doldurulur; Manual Log Line Format'ta satırın tamamı Smart Content Builder ile yazılır. Bu özelleştirme yalnızca log sunucusuna giden satırı etkiler; Logs & Tracking'deki HTTP logs ve TCP logs sabit alanlarla tutulur. Debug kayıtlarına ek alan eklemek için HTTP vService'teki Custom Debug Log Entries kullanılır.

Sorun: Log Sunucusu Farklı Alan Adları ve Yapı Bekliyor

Kurumun SIEM ya da log analiz sistemi belirli alan adları ve belirli bir satır yapısı bekliyor; hazır formatlar bu yapıya uymuyor ya da gereksiz alan taşıyor.

Çözüm: Dört Yöntem

İlk üç yöntem log sunucusuna giden satırı, dördüncüsü cihazdaki Debug kaydını özelleştirir; birlikte kullanılabilirler.

Durumunuz	Uygun yöntem
JSON ya da CEF yapısında kendi alanlarım	Yöntem 1: Manual JSON Format · Manual CEF Format
Tamamen serbest bir satır	Yöntem 2: Manual Log Line Format
Manual JSON profilini komut satırından kurmak	Yöntem 3: WEB-CLI
Cihazdaki Debug kaydına ek alan	Yöntem 4: Custom Debug Log Entries

Yöntem 1: Manual JSON / Manual CEF Format Önerilen

• Nasıl çalışır Her Key bir alan adı, her Value bir Smart Variable'dır; TR7 satırı JSON ya da CEF olarak üretir.
• Nerede açılırLoad Balancer → Profiles → Logs → Add
• Gereksinim TR7'nin erişebildiği bir log sunucusu
• vService tipi HTTP · L7 TCP
• Protokole uymayan değişken L7 TCP vService'te yalnızca HTTP'de geçerli bir değişken JSON'da boş değerle yazılır, CEF'te satırdan çıkarılır ve bildirimle raporlanır.

Adım adım yapılandırma

1

Adım 1 Profil formunu aç

Load Balancer → Profiles → Logs ekranında Add butonuna tıklanır (profil ekleme formu).

2

Adım 2 Adı ve log sunucusunu gir

Name girilir. Log Addresses satırında Protocol (varsayılan UDP), log sunucusunun IP adresi (ör. 192.0.2.50) ve Port girilir (port alanı boş gelir ve zorunludur; syslog için genel port 514); en az bir adres zorunludur. Log Standard varsayılan local bırakılabilir.

3

Adım 3 Formatı ve alanları tanımla

Line Format = Manual JSON Format ya da Manual CEF Format seçilir; forma Manual Log Entries tablosu eklenir. Her satırda Key alan adıdır, boş bırakılamaz ve tabloda benzersiz olmalıdır; Value listeden bir Smart Variable seçilerek doldurulur (ör. %SRCIP, %STATUS, %TIMESERVERRES). Yeni satır, kullanılmamış ilk değişkeni kendiliğinden seçer. JSON'da bütün değerler metin olarak yazılır; CEF'te başlık otomatik oluşur ve boş kalan alan satırdan çıkarılır (Manual Formats).

4

Adım 4 Profili kaydet

Add butonuna tıklanır.

5

Adım 5 vService'in düzenleme formunu aç

Load Balancer → Load Balancer vService List ekranında vService'e sağ tıklanıp Edit seçilir.

6

Adım 6 Profili vService'e ata

Formun sağındaki Details panelinde LOG işaretlenir ve Log profile alanında oluşturulan profil seçilir (vService'e nasıl eklenir). LOG işaretlenince kayıtlı ilk Logs profili, hiç profil yoksa log sunucusuna gönderim yapmayan Stream Log seçili gelir.

7

Adım 7 Kaydet

Save butonuna tıklanır. Değişikliğin uygulanması ekranın sağ altındaki senkron göstergesinden izlenir. Cluster kurulumunda varsayılan auto-sync ile değişiklik eş cihaza da gönderilir; Manual Sync Mode açıksa Synchronize ile elle gönderilir.

Doğrulama

1Log sunucusuLog sunucusu

vService'e istek gönderilir ve log sunucusunda gelen satıra bakılır.

Beklenen{"client":"…","status":"200"}

2Profil önizlemesiTR7 tarafı

Logs profili listesinde profile tıklanır ve önizlemedeki format ile alanlar kontrol edilir (profil önizlemesi).

BeklenenManual JSON format ve Key/Value satırları

Yöntem 2: Manual Log Line Format

• Nasıl çalışır Satırın tamamı Smart Content Builder ile Smart Variable'lar ve sabit metinle yazılır.
• Nerede açılırLoad Balancer → Profiles → Logs → Line Format = Manual Log Line Format
• Gereksinim TR7'nin erişebildiği bir log sunucusu
• vService tipi HTTP · L7 TCP (L7 TCP'de yalnızca protokolden bağımsız değişkenler)

Adım adım yapılandırma

1

Adım 1 Profil formunu aç

Load Balancer → Profiles → Logs ekranında Add butonuna tıklanır.

2

Adım 2 Adı ve log sunucusunu gir

Name ve Log Addresses Yöntem 1'in 2. adımındaki gibi girilir.

3

Adım 3 Satırı yaz

Line Format = Manual Log Line Format seçilir ve açılan Manual Log Line Format alanına satır yazılır; bu seçenekte alan zorunludur. Örnek: %TIME %SRCIP %HTTPMETHOD %PATH %STATUS %DOWNLOADEDBYTE. Bu tipte protokol denetimi yapılmaz: L7 TCP vService'te durum kodu ya da istek metodu gibi HTTP'ye özgü bir değişken kullanılırsa satır çözümlenemez ve vService başlatılamaz.

4

Adım 4 Profili kaydet

Add butonuna tıklanır.

5

Adım 5 vService'in düzenleme formunu aç

Load Balancer → Load Balancer vService List ekranında vService'e sağ tıklanıp Edit seçilir.

6

Adım 6 Profili vService'e ata

Details panelinde LOG işaretlenir ve Log profile alanında profil seçilir.

7

Adım 7 Kaydet

Save butonuna tıklanır; cluster'da değişiklik Yöntem 1'deki gibi eş cihaza geçer.

Doğrulama

1Log sunucusuLog sunucusu

vService'e istek gönderilir ve log sunucusunda gelen satıra bakılır.

Beklenen09/Sep/2026:20:37:06 +0300 203.0.113.42 GET /login.php 200 1011

Yöntem 3: WEB-CLI

• Nasıl çalışır Manual JSON formatlı Logs profili komut satırından oluşturulur ve vService'e atanır.
• Nerede açılır TR7 WEB-CLI → lb log · lb service (biçim alanları)
• Gereksinim WEB-CLI erişimi
• vService tipi HTTP · L7 TCP

Adım adım yapılandırma

1

Adım 1 Profili oluştur

Her --manualLogEntries.N çifti bir Key/Value satırıdır; indeksler 0'dan başlayarak sırayla verilir. Port yazılmazsa 514 kullanılır; komut satırında Protocol alanı bulunmaz ve gönderim UDP ile yapılır.

lb log add name siem-json --lineFormat manualJSON --logAddresses.0.ip.ip 192.0.2.50 --manualLogEntries.0.key client --manualLogEntries.0.value %SRCIP --manualLogEntries.1.key status --manualLogEntries.1.value %STATUS

2

Adım 2 Profili vService'e ata

lb service update id <vService> --log siem-json

vService'te tek bir Logs profili bulunur; komut mevcut profilin yerine geçer.

Doğrulama

1Profil kaydıWEB-CLI

Komut: lb log show siem-json

BeklenenlineFormat manualJSON · iki manualLogEntries satırı

2Log sunucusuLog sunucusu

vService'e istek gönderilir ve log sunucusunda gelen satıra bakılır.

Beklenen{"client":"…","status":"200"}

Yöntem 4: Custom Debug Log Entries

• Nasıl çalışır Debug kayıtlarına Smart Variable'larla ek alanlar yazılır; kayıt önizlemesinde Custom Entries tablosunda görünür.
• Nerede açılır vService düzenleme formu → Details → Debug → Custom Debug Log Entries
• Gereksinim HTTP vService; Debug mode açık
• vService tipi HTTP

Adım adım yapılandırma

1

Adım 1 vService'in düzenleme formunu aç

Load Balancer → Load Balancer vService List ekranında HTTP vService'e sağ tıklanıp Edit seçilir.

2

Adım 2 Debug'ı işaretle

Details panelinde Debug işaretlenir. Debug mode'un etkileri: Debug Mode ne kaydeder; ne kadar süre açık tutmalıyım?

3

Adım 3 Custom debug log entries'i aç

Debug bölümündeki Custom Debug Log Entries anahtarı açılır (varsayılan kapalı) ve Add ile satır eklenir.

4

Adım 4 Alanı tanımla

Entry Name zorunludur; Entry Value listeden bir Smart Variable seçilerek doldurulur.

5

Adım 5 Kaydet

Save butonuna tıklanır.

Doğrulama

1ÖnizlemeTR7 tarafı

vService ekranının Logs & Tracking sekmesinde Debug Mode Logs kaynağı seçilir ve bir kayda tıklanır.

BeklenenSummary sekmesinde Custom Entries tablosu

Sık Yapılan Hatalar

• Manual formatın Logs & Tracking'deki HTTP logs'u değiştireceğini sanmak. Format yalnızca log sunucusuna giden satırı belirler.
• JSON'da sayısal alanların sayı gelmesini beklemek. Manual JSON Format'ta bütün değerler metin olarak yazılır; log sunucusunda tür dönüşümü tanımlanır.
• L7 TCP vService'te Manual log line format ile HTTP değişkeni kullanmak. Bu tipte protokol denetimi yoktur; vService başlatılamaz.
• Yerleşik Stream log profiliyle satır beklemek. Stream log log sunucusuna gönderim yapmaz; vService'e log sunucusu adresi olan bir profil atanmalıdır.
• Profili bağlı vService'leri kontrol etmeden değiştirmek. Değişiklik profili kullanan bütün vService'lere hemen uygulanır (Used in).

Dokümantasyonda nasıl yapılır

• Manual Formats · Format hakkında
• Manual Formats · Manual Log Line Format
• Logs profili · Profil ekleme formu
• Debug Logs · Custom Debug Log Entries

İlgili sorular

• Hangi HTTP ve TCP log formatları destekleniyor (Standard, Apache Combined, Apache VHost, CEF, TR7 JSON, TR7 WAF, Manual JSON, Manual CEF, Manual log line)?
• Logları SIEM'e (Syslog) nasıl gönderirim?
• KVKK / GDPR için loglardaki IP adreslerini maskeleyebilir miyim?