要從命令行運行Logstash,請使用如下命令:node
bin/logstash [options]
命令行標記選項是你能夠指定它們來控制Logstash的執行,bin
目錄的位置因平臺而異,查看Logstash目錄佈局以找到你係統上bin\Logstash
的位置。shell
下面的示例運行Logstash配置,並加載mypipeline.conf
文件中定義的Logstash的配置:segmentfault
bin/logstash -f mypipeline.conf
在命令行中設置的任何標誌都會覆蓋logstash.yml中的相應設置,但文件自己不會更改,對於後續的Logstash運行,它保持原樣。ruby
在測試Logstash時,指定命令行選項很是有用,可是在生產環境中,咱們建議你使用logstash.yml用於控制Logstash執行,使用設置文件使你更容易指定多個選項,而且它爲你提供了一個單一的、版本化的文件,你可使用該文件在每次運行時一致地啓動Logstash。jvm
Logstash有如下標記,你可使用--help
標誌來顯示此信息。佈局
--node.name NAME
測試
-f, --path.config CONFIG_PATH
插件
-f foo -f bar
與-f bar
相同))。你能夠指定通配符(globs),任何匹配的文件都將按照上面描述的順序加載,例如,可使用通配符特性按名稱加載特定文件:命令行
bin/logstash --debug -f '/tmp/{one,two,three}'
使用這個命令,Logstash鏈接三個配置文件:/tmp/one
、/tmp/two
和/tmp/three
,並將它們解析爲一個配置。線程
-e, --config.string CONFIG_STRING
input { stdin { type => stdin } }
而且若是沒有指定輸出,則使用如下做爲默認輸出:output { stdout { codec => rubydebug } }
,若是你但願使用這兩個默認值,請使用空字符串做爲-e
標誌,默認爲nil
。--modules
-M
選項一塊兒工做,爲指定模塊的默認變量賦值,若是--modules
在命令行中使用,則logstash.yml
中的任何模塊都將被忽略,那裏的任何設置也將被忽略。此標誌與-f
和-e
標誌相互排斥,只能指定-f
、-e
或--modules
之一,能夠經過用逗號分隔多個模塊,或者屢次調用--modules標誌來指定多個模塊。-M, --modules.variable
-M "MODULE_NAME.var.PLUGIN_TYPE.PLUGIN_NAME.KEY_NAME=value"
,對於其餘設置,它將是-M "MODULE_NAME.KEY_NAME.SUB_KEYNAME=value"
,-M
標誌能夠根據須要屢次使用。若是沒有指定-M
選項,那麼將使用該設置的默認值,-M
標誌僅與--modules
一塊兒使用,若是--modules
標誌不存在,它將被忽略。--pipeline.id ID
main
。-w, --pipeline.workers COUNT
-b, --pipeline.batch.size SIZE
jvm.options
配置文件中的JVM堆空間,有關更多信息,請參閱Logstash配置文件。-u, --pipeline.batch.delay DELAY_IN_MS
--pipeline.unsafe_shutdown
--path.data PATH
data
目錄。-p, --path.plugins PATH
PATH/logstash/TYPE/NAME.rb
,其中TYPE
是inputs
、filters
、outputs
或codecs
,而且NAME
是插件的名稱。-l, --path.logs PATH
--log.level LEVEL
設置Logstash的日誌級別,可能的值是:
fatal
:記錄很是嚴重的錯誤消息,這一般會致使應用程序停止error
:錯誤日誌warn
:警告日誌info
:詳細日誌信息(這是默認信息)debug
:調試日誌信息(針對開發人員)trace
:記錄除調試信息以外的細粒度消息--config.debug
--log.level=debug
啓用),警告:日誌消息將包含傳遞給插件configs的任意密碼選項,可能會致使明文密碼出如今日誌中!-i, --interactive SHELL
--V, --version
-t, --config.test_and_exit
--log.level=debug
結合起來,Logstash會對合並後的配置文件進行日誌記錄,並對每一個配置塊使用源文件進行註解。-r, --config.reload.automatic
--config.reload.interval RELOAD_INTERVAL
--http.host HTTP_HOST
--http.port HTTP_PORT
--log.format FORMAT
--path.settings SETTINGS_DIR
LS_SETTINGS_DIR
環境變量設置,默認值是Logstash下的config
目錄。-h, --help