應用場景:
缺省情況下她倘,系統(tǒng)打出來的日志信息都可以輸出到各個方向驱负,當某些情況下,用戶可能不關心某些日志信息或者只關心某些日志信息片橡,則可以使用日志過濾功能妈经,對該日志信息進行過濾。
功能介紹:
1捧书、在某些情況下吹泡,管理員可能不想讓某些日志信息顯示出來,則可以通過此功能過濾系統(tǒng)產(chǎn)生的日志信息经瓷。
2荞胡、默認情況下,各個模塊打印的日志信息都可顯示到控制臺或其它終端上了嚎。設置日志信息過濾原則可以讓某些日志信息打出到某些終端中,或只想讓某些日志信息打出到某些終端中廊营。
3歪泳、日志信息的兩種過濾類型,分為:“只包含”和“只過濾”露筒,某一時刻只能配置其中的一種類型呐伞。
工作原理&配置詳解:
日志過濾配置主要包含:過濾規(guī)則、過濾方向慎式、過濾方式伶氢。不過配置過程中:
1)若只配置過濾方向趟径、過濾類型,沒有配置過濾規(guī)則(logging filter rule)癣防,那么配置不會生效蜗巧,即不會進行日志過濾操作。
2)若只配置過濾規(guī)則蕾盯,不配置過濾方向幕屹、過濾類型,配置可以生效级遭,即會對日志進行過濾操作望拖,默認過濾往所有方向的日志信息,過濾類型為“只過濾”挫鸽。
1)過濾規(guī)則(logging filter rule):配置日志信息的過濾規(guī)則说敏,全局模式配置,過濾可以“精確匹配”丢郊,也可以“單個匹配”盔沫。
日志信息的“精確匹配”過濾規(guī)則: logging filter rule exact-match [ module module-name mnemonic mnemonic-name level level ]
日志信息的“單個匹配”過濾規(guī)則:logging filter rule single-match [ level level | mnemonic mnemonic-name | module module-name ]
【參數(shù)說明】
exact-match
精確匹配,若選擇精確匹配蚂夕,則后面的三個過濾選項(日志模塊名迅诬、日志等級、日志助記符)都需要選上婿牍。
single-match
單個匹配侈贷,若選擇單個匹配,則后面的三個過濾選項(日志模塊名等脂、日志等級俏蛮、日志助記符)只需要選擇其中的一個。
module module-name
模塊名上遥,即填寫要過濾的模塊名稱搏屑。
mnemonic mnemonic-name
助記符名稱,即填寫要過濾的日志信息助記符名稱粉楚。
level level
日志信息等級辣恋,即填寫要過濾的日志信息等級。
【使用指導】
1模软、某些情況下伟骨,用戶可能只想過濾掉某一特定的日志信息,則可以使用“精確匹配”規(guī)則燃异,在配置時携狭,需要指定具體的模塊名、助記符名稱回俐、日志等級逛腿。
2稀并、某些情況下,用戶可能想過濾掉某些類型的日志信息单默,則可以使用“單個匹配”規(guī)則碘举,在配置時,只需要指定模塊名雕凹、日志等級殴俱、助記符名稱當中的一種。
3枚抵、當用戶配置的日志信息過濾規(guī)則中线欲,若單個匹配規(guī)則和精確匹配規(guī)則中同時配置了一樣的模塊名、助記符或信息等級汽摹,則單個匹配規(guī)避的優(yōu)先級高于精確匹配李丰。
【配置舉例】
1:配置日志信息過濾規(guī)則為精確匹配,模塊名為LOGIN逼泣、日志等級為5趴泌、助記符名稱為LOGOUT:
Ruijie(config)# logging filter rule exact-match module LOGIN mnemonic LOGOUT level 5
2:配置日志信息的過濾規(guī)則為單個匹配,模塊名為SYS:
Ruijie(config)# logging filter rule single-match module SYS
【常見咨詢舉例】
例1:過濾日志 046188: Aug 13 08:36:16: 401-C1&D1-RG-N18010 %SPANTREE-6-RCVDTCBPDU: (2/M1) Received tc bpdu on port AggregatePort 256 on MST0
命令:ruijie(conifg)#logging filter rule exact-match module SPANTREE mnemonic RCVDTCBPDU level 6
例2:過濾日志 *Jul 30 12:35:51: %SNMP-3-AUTHFAIL: Authentication failure for SNMP req from host 185.94.111.1
命令:ruijie(conifg)#logging filter rule exact-match module SNMP mnemonic AUTHFAIL level 3
例3:過濾日志 %PARAM-6-CONFIG_SYNC: Sync'ing the startup configuration to the standby supervisor
命令:ruijie(config)#logging filter rule exact-match module PARAM mnemonic CONFIG_SYNC level 6
2)過濾方向(logging filter direction):將往某個方向的日志信息過濾掉拉庶,全局模式下配置嗜憔。
logging filter direction { all | buffer | file | server | terminal } //缺省為ALL,即過濾往所有方向的日志信息
default logging filter direction // 命令恢復日志信息的過濾方向為 all
【參數(shù)說明】
all
過濾往所有方向的日志信息(包括:Console方向氏仗、VTY終端吉捶、日志緩沖區(qū)、日志文件皆尔、日志服務器)
buffer
過濾往日志緩沖區(qū)的日志信息(即show logging命令顯示出來的日志信息)
file
過濾往日志文件的日志信息
server
過濾往日志服務器的日志信息
terminal
過濾往控制臺和VTY終端(包括Telnet/SSH等)的日志信息
【使用指導】
1呐舔、用戶配置了日志過濾功能后,通常情況下慷蠕,會想要將匹配過濾規(guī)則后的日志信息珊拼,在所有方向上都過濾掉(包括:Console方向、VTY終端流炕、日志緩沖區(qū)澎现、日志文件、日志服務器)每辟,而某些情況下昔头,用戶可能只想過濾往特定方向的日志信息,比如:過濾掉的日志信息不需要到終端界面影兽,但需要寫入到日志文件,或發(fā)送給日志信息器莱革,只需要配置過濾往terminal方向的日志信息峻堰。
2讹开、以上四類過濾方向為或(|)關系,即可以聯(lián)合使用(對往多個方向的日志信息進行過濾)捐名,也可以單獨使用(只對往某一方向的日志信息進行過濾)旦万。
3)過濾類型(logging filter type):配置日志信息的過濾類型, 全局模式配置镶蹋。
logging filter type { contains-only | filter-only } //缺省為filter-only成艘,即過濾類型為“只過濾”
【參數(shù)說明】
contains-only “只包含”,代表:只輸出包含了過濾規(guī)則里面的關鍵字信息的日志贺归,其它沒有包含過濾規(guī)則里面的日志不會輸出淆两。
filter-only “只過濾”,代表:將過濾掉包含了過濾規(guī)則里面的關鍵字信息的日志拂酣,不會輸出這些過濾掉的日志信息秋冰。
【使用指導】
1、某些情況下婶熬,當遇到某一個模塊打出的日志信息太多剑勾,可能引起終端界面刷屏,且用戶又不關心此類日志信息時赵颅,可在設備上面應用“只過濾”這一日志過濾類型虽另,將刷屏的日志信息過濾掉。
2饺谬、某些情況下捂刺,用戶可能只關心某些日志信息是否產(chǎn)生,則可以在設備上面應用“只包含”這一日志過濾類型商蕴,讓包含了此規(guī)則的日志信息才輸出到終端界面叠萍,方便用于觀察某些事件是否有發(fā)生。
3绪商、在實際應用過程中苛谷,“只包含”和“只過濾”這兩種過濾類型互斥,即同一時刻只能配置一種過濾類型格郁。
配置舉例:
【案例1】:
【要求】
假設網(wǎng)絡環(huán)境中腹殿,有以下日志信息過濾功能設置要求:
1、設置日志信息的過濾方向為 terminal例书、 server 兩個方向锣尉;
2、設置日志信息的過濾方式為“只過濾”决采;
3自沧、設備日志信息的過濾規(guī)則為“單個匹配”,并且模塊名包含 SYS 的日志信息過濾掉。
2拇厢、設置日志信息的過濾方式為“只過濾”爱谁;
3、設備日志信息的過濾規(guī)則為“單個匹配”孝偎,并且模塊名包含 SYS 的日志信息過濾掉访敌。
3、設備日志信息的過濾規(guī)則為“單個匹配”衣盾,并且模塊名包含 SYS 的日志信息過濾掉寺旺。
【配置方法】
在設備上面配置系統(tǒng)日志的過濾功能:
Ruijie# configure terminal
Ruijie(config)# logging filter direction server
Ruijie(config)# logging filter direction terminal
Ruijie(config)# logging filter type filter-only
Ruijie(config)# logging filter rule single-match module SYS
【檢驗方法】
1、通過 show running-config | include loggging 命令可以查看用戶配置的相關參數(shù)信息势决。
2阻塑、 通過進入/退出全局配置模式,觀察系統(tǒng)是否會輸出日志信息徽龟。
Ruijie#configure
Enter configuration commands, one per line. End with CNTL/Z.
Ruijie(config)#exit
Ruijie#