Logstash詳解之——filter模塊
Logstash三個組件的第二個組件,也是真個Logstash工具中最複雜,最蛋疼的一個組件,當然,也是最有作用的一個組件。
1、grok插件 grok插件有非常強大的功能,他能匹配一切數據,但是他的性能和對資源的損耗同樣讓人詬病。
filter{
grok{
#隻說一個match屬性,他的作用是從message 字段中吧時間給摳出來,並且賦值給另個一個字段logdate。
#首先要說明的是,所有文本數據都是在Logstash的message字段中中的,我們要在過濾器裏操作的數據就是message。
#第二點需要明白的是grok插件是一個十分耗費資源的插件,這也是為什麼我隻打算講解一個TIMESTAMP_ISO8601正則表達式的原因。
#第三點需要明白的是,grok有超級多的預裝正則表達式,這裏是沒辦法完全搞定的,也許你可以從這個大神的文章中找到你需要的表達式
#https://blog.csdn.net/liukuan73/article/details/52318243
#但是,我還是不建議使用它,因為他完全可以用別的插件代替,當然,對於時間這個屬性來說,grok是非常便利的。
match => ['message','%{TIMESTAMP_ISO8601:logdate}']
}
}
2、mutate插件 mutate插件是用來處理數據的格式的,你可以選擇處理你的時間格式,或者你想把一個字符串變為數字類型(當然需要合法),同樣的你也可以返回去做。可以設置的轉換類型 包括: "integer", "float" 和 "string"。
filter {
mutate {
#接收一個數組,其形式為value,type
#需要注意的是,你的數據在轉型的時候要合法,你總是不能把一個‘abc’的字符串轉換為123的。
convert => [
#把request_time的值裝換為浮點型
"request_time", "float",
#costTime的值轉換為整型
"costTime", "integer"
]
}
}
3、ruby插件 官方對ruby插件的介紹是——無所不能。ruby插件可以使用任何的ruby語法,無論是邏輯判斷,條件語句,循環語句,還是對字符串的操作,對EVENT對象的操作,都是極其得心應手的。
filter {
ruby {
#ruby插件有兩個屬性,一個init 還有一個code
#init屬性是用來初始化字段的,你可以在這裏初始化一個字段,無論是什麼類型的都可以,這個字段隻是在ruby{}作用域裏麵生效。
#這裏我初始化了一個名為field的hash字段。可以在下麵的coed屬性裏麵使用。
init => [field={}]
#code屬性使用兩個冒號進行標識,你的所有ruby語法都可以在裏麵進行。
#下麵我對一段數據進行處理。
#首先,我需要在把message字段裏麵的值拿到,並且對值進行分割按照“|”。這樣分割出來的是一個數組(ruby的字符創處理)。
#第二步,我需要循環數組判斷其值是否是我需要的數據(ruby條件語法、循環結構)
#第三步,我需要吧我需要的字段添加進入EVEVT對象。
#第四步,選取一個值,進行MD5加密
#什麼是event對象?event就是Logstash對象,你可以在ruby插件的code屬性裏麵操作他,可以添加屬性字段,可以刪除,可以修改,同樣可以進行樹脂運算。
#進行MD5加密的時候,需要引入對應的包。
#最後把冗餘的message字段去除。
code => "
array=event。get('message').split('|')
array.each do |value|
if value.include? 'MD5_VALUE'
then
require 'digest/md5'
md5=Digest::MD5.hexdigest(value)
event.set('md5',md5)
end
if value.include? 'DEFAULT_VALUE'
then
event.set('value',value)
end
end
remove_field=>"message"
"
}
}
4、date插件 這裏需要合前麵的grok插件剝離出來的值logdate配合使用(當然也許你不是用grok去做)。
filter{
date{
#還記得grok插件剝離出來的字段logdate嗎?就是在這裏使用的。你可以格式化為你需要的樣子,至於是什麼樣子。就得你自己取看啦。
#為什什麼要格式化?
#對於老數據來說這非常重要,應為你需要修改@timestamp字段的值,如果你不修改,你保存進ES的時間就是係統但前時間(+0時區)
#單你格式化以後,就可以通過target屬性來指定到@timestamp,這樣你的數據的時間就會是準確的,這對以你以後圖表的建設來說萬分重要。
#最後,logdate這個字段,已經沒有任何價值了,所以我們順手可以吧這個字段從event對象中移除。
match=>["logdate","dd/MMM/yyyy:HH:mm:ss Z"]
target=>"@timestamp"
remove_field => 'logdate'
#還需要強調的是,@timestamp字段的值,你是不可以隨便修改的,最好就按照你數據的某一個時間點來使用,
#如果是日誌,就使用grok把時間摳出來,如果是數據庫,就指定一個字段的值來格式化,比如說:"timeat", "%{TIMESTAMP_ISO8601:logdate}"
#timeat就是我的數據庫的一個關於時間的字段。
#如果沒有這個字段的話,千萬不要試著去修改它。
}
}
5、json插件,這個插件也是極其好用的一個插件,現在我們的日誌信息,基本都是由固定的樣式組成的,我們可以使用json插件對其進行解析,並且得到每個字段對應的值。
filter{
#source指定你的哪個值是json數據。
json {
source => "value"
}
#注意:如果你的json數據是多層的,那麼解析出來的數據在多層結裏是一個數組,你可以使用ruby語法對他進行操作,最終把所有數據都裝換為平級的。
}
json插件還是需要注意一下使用的方法的,下圖就是多層結構的弊端:
對應的解決方案為:
ruby{
code=>"
kv=event.get('content')[0]
kv.each do |k,v|
event.set(k,v)
end"
remove_field => ['content','value','receiptNo','channelId','status']
}
Logstash filter組件的插件基本介紹到這裏了,這裏需要明白的是:
add_field、remove_field、add_tag、remove_tag 是所有 Logstash 插件都有。相關使用反法看字段名就可以知道。不如你也試試吧。。。。
最後更新:2017-08-13 22:42:05