通用配置項
tip:不受namespace限制,與filebeat.inputs同級
name
Beat的name,若未設置,取服務器的hostname值。經過處理后會輸出到agent.name字段中,可以使用name組織所有使用同一個Beat處理的數據
tags
可選項,值是一個list,用於添加各種屬性標記
fields
可選項,當需要向output中輸出額外的屬性描述時使用,值可以是 標量, arrays, dictionaries, 或其他嵌套類型
fields_under_root
將fields內的屬性設置為top level,如果fields內的屬性和另一個top level中的屬性有沖突,另一個將會被覆蓋,可選值為true和false
processors
類似於logstash的filter部分,主要做些簡單的數據處理,參考https://www.elastic.co/guide/en/beats/filebeat/current/filtering-and-enhancing-data.html
全局配置項
在filebeat命名空間下,通常設置是 filebeat.xxx.xxx
filebeat.registry.path:xxxx
這里的xxxx是相對於data.path而言的,即 {path.data}/xxxx
filebeat.registry.flush:0s
控制registry里的內容何時寫入到文件中
默認是0s,通俗講就是每個event被發布成功后,會立即寫入一條類似位移的記錄到registry;如果設置是n s(n>0),則發布成功后n秒才寫入,
0s可以保證立即寫入,如果filebeat down掉了,位移不會出問題,但是會影響進程的性能;
ns情形,down掉的話可能會出現已經發布出去的event,位移沒有記下導致重啟后重復讀取,但是可以提高進程處理的性能
shutdown_timeout
filebeat關閉時的延時時間,這個延時主要針對events 的發布狀態來講,默認是關閉的,不關心當前是否還有尚在發布的events
如果設置延時,則會在延時的時間后才shutdown
進程文件路徑設置
主要設置filebeat在運行中從哪里找其對應的文件,命名空間為 path
path.home
path.data------常用
path.logs------常用
path.config
以上配置均可用對應的命令行參數覆蓋,即如果使用命令行參數指定,文件中配置的該項會被忽略,但是不會被修改
配置的值通常用絕對路徑,不用相對路徑