lb log

lb log komutu, bir vService'in trafik günlüklerinin nereye ve hangi biçimde gönderileceğini belirleyen günlük profillerini oluşturur. Profil bir vService'e bağlandığında, o servisin günlükleri belirtilen sunuculara akmaya başlar. Panel karşılığı Logging bölümüdür.

Komut Özeti

TR7 WEB-CLI · lb log

# komuttan sonra Tab

admin@TR7LBWAF01> lb log

add delete list show update

 

admin@TR7LBWAF01> lb log list # hepsini listele

admin@TR7LBWAF01> lb log show <kimlik> # birini göster

admin@TR7LBWAF01> lb log add name <ad> … # yeni profil

admin@TR7LBWAF01> lb log update id <kimlik> … # değiştir

admin@TR7LBWAF01> lb log delete <kimlik> # sil

admin@TR7LBWAF01>  

Yazım Sırası

Adım 1 Adı yaz

Tek zorunlu alan budur: lb log add trafik-gunlugu

Adım 2 Günlük sunucularını ekle

--logAddresses.0.ip.ip 10.0.50.10 --logAddresses.0.ip.port 514

Adım 3 Biçimi seç

--lineFormat tr7json --logStandard rfc5424

Adım 4 vService'e bağla

lb service update id <vService> --log <profil>

Zorunlu Alanlar

Sıra	Alan	Durum	Değer
1	name	Zorunlu	Profilin adı; koleksiyonda benzersiz olmalı

Günlük Sunucuları

Her sunucu kendi indeksiyle yazılır. Listede en az bir, en çok on sunucu bulunabilir.

Alan	Ne yapar	Arkasına ne yazılır
--logAddresses.N.ip.ip	Günlüklerin gönderileceği sunucunun adresini belirler	IP adresi
--logAddresses.N.ip.port	Sunucunun portunu belirler	Port (varsayılan 514)
--logAddresses.N.sampling	Gönderilen günlükleri seyreltir: değer verildiğinde günlükler bu oranda örneklenir	1 ile 524288 arasında tam sayı. Boş bırakıldığında bütün günlükler gönderilir

Biçim Alanları

Alan	Ne yapar	Arkasına ne yazılır
--logStandard	Günlüğün hangi gönderim standardıyla paketleneceğini seçer	local (varsayılan) · rfc3164 · rfc5424 · priority · raw
--lineFormat	Günlük satırının biçimini seçer	apache (standart günlük biçimi) · apache-combined · apache-vhost · cef · tr7json · tr7waf · manualJSON · manualCEF · manual
--manualLineFormat	Satır biçimini baştan sona elle yazar	Akıllı içerik ifadesi; yalnız --lineFormat manual seçildiğinde açılır ve zorunlu olur
--manualLogEntries.N.key	Günlüğe eklenecek alanın adını belirler	Alan adı; profil içinde benzersiz. Yalnız --lineFormat manualJSON ya da manualCEF seçildiğinde açılır
--manualLogEntries.N.value	O alanın değerini belirler	Akıllı değişken; Tab kullanılabilecekleri listeler

Üç elle yazma biçimi birbirinden ayrıdır

manual biçiminde satırın tamamı --manualLineFormat ile yazılır. manualJSON ve manualCEF biçimlerinde ise satırın iskeleti hazırdır; içine konacak alanlar --manualLogEntries.N çiftleriyle eklenir.

Örnekler

TR7 WEB-CLI · A) İki sunuculu standart profil

admin@TR7LBWAF01> lb log add name trafik-gunlugu \

--logAddresses.0.ip.ip 10.0.50.10 --logAddresses.0.ip.port 514 \

--logAddresses.1.ip.ip 10.0.50.11 --logAddresses.1.ip.port 514 \

--logStandard rfc5424 --lineFormat tr7json

admin@TR7LBWAF01>  

TR7 WEB-CLI · B) Örneklemeli ve elle alanlı profil

# her 100 günlükten biri gönderilir

admin@TR7LBWAF01> lb log add name seyreltilmis \

--logAddresses.0.ip.ip 10.0.50.10 --logAddresses.0.sampling 100

 

# JSON iskeletine kendi alanlarını eklemek

admin@TR7LBWAF01> lb log add name ozel-json --lineFormat manualJSON \

--logAddresses.0.ip.ip 10.0.50.10 \

--manualLogEntries.0.key kurum --manualLogEntries.0.value <değişken> \

--manualLogEntries.1.key ortam --manualLogEntries.1.value <değişken>

admin@TR7LBWAF01>  

Güncelleme ve Silme

TR7 WEB-CLI · güncelleme ve silme

# var olan sunucunun portunu değiştirme · yeni sunucu ekleme

admin@TR7LBWAF01> lb log update id <kimlik> --logAddresses.0.ip.port 1514

admin@TR7LBWAF01> lb log update id <kimlik> --logAddresses.2.ip.ip 10.0.50.12

 

# tek sunucuyu çıkarma · listeyi boşaltma

admin@TR7LBWAF01> lb log update id <kimlik> --logAddresses.1.delete

admin@TR7LBWAF01> lb log update id <kimlik> --manualLogEntries.delete

 

admin@TR7LBWAF01> lb log delete <kimlik>

admin@TR7LBWAF01>  

Bilinmesi Gerekenler

• Profil tek başına çalışmaz. Günlük gönderimi, profil bir vService'e --log alanıyla bağlandığında başlar.
• Sunucu sayısı sınırlıdır. Listede en az bir, en çok on günlük sunucusu bulunabilir.
• Örnekleme günlük kaybı demektir. --logAddresses.N.sampling verildiğinde günlükler seyreltilerek gönderilir; tam kayıt gereken yerlerde boş bırakılır.
• Elle yazılan alanlar akıllı değişken taşır. --manualLogEntries.N.value alanına yazılan değerler istekten çözülen değişkenler olabilir.
• Ad benzersizdir. Aynı ada sahip ikinci bir profil oluşturulamaz.