settings log-transport

settings log-transport komutu, cihazın ürettiği günlüklerin dışarı gönderilmesini yönetir. Her kayıt bir hedefi tanımlar: günlükler hangi sunucuya, hangi protokolle, hangi biçimde ve hangi kaynaklardan gönderilecektir.

Komut Özeti

TR7 WEB-CLI · settings log-transport

# komuttan sonra Tab

admin@TR7LBWAF01> settings log-transport

add delete list show update

 

admin@TR7LBWAF01> settings log-transport list

admin@TR7LBWAF01> settings log-transport add name <ad> transportType syslog …

admin@TR7LBWAF01> settings log-transport update id <kimlik> …

admin@TR7LBWAF01> settings log-transport delete <kimlik>

admin@TR7LBWAF01>  

Zorunlu Alanlar

add komutunda CLI zorunlu alanları aşağıdaki sırayla, tek tek ister ve biri yazılmadan sonrakini göstermez. Alanlar alan adı ile değeri birlikte yazılır.

Sıra	Alan	Durum	Değer
1	name	Zorunlu	Kayda özgü ad; aynı ad iki kayıtta kullanılamaz
2	transportType	Zorunlu	syslog — Syslog. Bu sürümde tanımlı tek değer; tipe bağlı alanlar bu seçimden sonra listelenir
3	syslogHost	Koşullu zorunlu	Yalnız transportType syslog iken; günlüklerin gönderileceği sunucu adı ya da IP adresi

Satıra bir -- alanı eklendiğinde koşullu zorunlu alanlar da -- önekli yazıma geçer; Tab her adımda doğru yazımı gösterir.

update komutunda düzenlenecek kayıt id <kimlik> ile seçilir; show ve delete komutlarında kimlik alan adı olmadan yazılır (settings log-transport delete <kimlik>). Kimlikler list çıktısından alınır.

Syslog Hedefi

Aşağıdaki alanlar transportType syslog seçiliyken listelenir.

Alan	Ne yapar	Arkasına ne yazılır
--syslogHost	Günlüklerin gönderileceği syslog sunucusunu belirler	Sunucu adı ya da IP adresi. Zorunludur (bkz. sıra 3)
--syslogPort	Sunucunun portunu belirler	Port numarası (varsayılan 514)
--syslogProtocol	Gönderimin hangi taşıma protokolüyle yapılacağını seçer	udp (varsayılan) · tcp
--syslogFormat	Syslog başlığının hangi standarda göre yazılacağını seçer	rfc3164 (varsayılan) · rfc5424
--syslogMessageFormat	İleti gövdesinin hangi biçimde yazılacağını seçer	json — JSON (varsayılan) · cef — CEF (Common Event Format) · plainText — Plain Text
--syslogAppName	İletide görünecek uygulama adını belirler	Uygulama adı (varsayılan TR7_syslog_client)

İçerik Alanları

Alan	Ne yapar	Arkasına ne yazılır
--namespace	Gönderimin hangi yönlendirme tablosundan çıkacağını seçer	Yönlendirme tablosu (varsayılan 1)
--language	Gönderilen günlük metinlerinin dilini seçer	en (varsayılan) · tr
--sources.N	Hangi günlük kaynaklarının gönderileceğini seçer	userLogs — User Logs · hcLogs — Health Check Logs · poolStatusLogs — vService Status Logs · notificationLogs — Notification Logs · gtmLogs — GTM Logs. Varsayılan olarak beşi de seçilidir; en az bir kaynak kalmalıdır
--hcLogsVerbose	Sağlık denetimlerinin hepsinin mi yoksa yalnız durum değişikliklerinin mi gönderileceğini belirler	true hepsini gönderir · false yalnız durum değişikliklerini gönderir (varsayılan). Kaynaklar arasında hcLogs varken açılır
--userLogChanges	Kullanıcı işlem günlüklerine alan bazlı değişiklik listesinin (ne eklendi, silindi, değişti) eklenip eklenmeyeceğini belirler	true (varsayılan) · false. Kaynaklar arasında userLogs varken açılır

Örnekler

TR7 WEB-CLI · günlük gönderimi

# TCP üzerinden RFC 5424 başlıklı JSON gönderim

admin@TR7LBWAF01> settings log-transport add name siem transportType syslog \

--syslogHost 10.0.1.60 --syslogPort 514 --syslogProtocol tcp \

--syslogFormat rfc5424 --syslogMessageFormat json --language en

 

# yalnız kullanıcı işlemleri, değişiklik ayrıntısıyla

admin@TR7LBWAF01> settings log-transport add name denetim transportType syslog \

--syslogHost 10.0.1.61 --sources.0 userLogs --userLogChanges true

 

# var olan kaydı değiştirme ve silme

admin@TR7LBWAF01> settings log-transport list

admin@TR7LBWAF01> settings log-transport update id <kimlik> --syslogProtocol tcp

admin@TR7LBWAF01> settings log-transport delete <kimlik>

admin@TR7LBWAF01>  

Bilinmesi Gerekenler

• Önce ad, sonra tip istenir. CLI sırayla name, transportType ve syslogHost alanlarını ister; tipe bağlı alanlar transportType yazılmadan listelenmez.
• Zorunlu alanlar -- almaz. name ve transportType alan adı ile değeri yan yana yazılır; isteğe bağlı alanlar --alan değer biçimindedir. Satıra bir -- alanı eklendiğinde syslogHost da --syslogHost olarak yazılır. Ayrıntı API Commands sayfasındadır.
• Kaynak listesi boşaltılamaz. --sources.N en az bir değer taşımalıdır; varsayılan olarak beş kaynağın hepsi seçilidir.
• İki alan kaynak seçimine bağlıdır. --hcLogsVerbose yalnız kaynaklar arasında hcLogs, --userLogChanges yalnız userLogs varken listelenir.
• Sağlık denetimlerinin hepsini göndermek hacmi büyütür. --hcLogsVerbose false iken yalnız durum değişiklikleri gönderilir; alan açıldığında her denetim ayrı bir kayıt üretir.
• Birden çok hedef tanımlanabilir. Her kayıt kendi sunucusunu, biçimini ve kaynak kümesini taşır; aynı günlük birden çok hedefe farklı biçimlerde gönderilebilir.
• Erişim yönlendirme tablosuna bağlıdır. --namespace ile seçilen tablodan syslog sunucusuna erişilebilmelidir; tablolar network namespace komutuyla yönetilir.
• Dosyalar ayrı bir komutla gönderilir. Rapor ve yedek dosyalarının aktarımı settings file-transport komutundadır.