Logstash 运行参数说明

--node.name NAME  
# 实例名称，默认是当前主机名

-f, --path.config CONFIG_PATH
# 从特定文件或目录加载配置，若是目录则从该目录中的所有文件按字典顺序连接，然后解析为一个个配置文件
# 可指定通配符，任何匹配的文件将按照上面描述的顺序加载
# 例如使用通配功能按名称加载特定文件：logstash --debug -f '/tmp/{one,two,three}'

-e, --config.string CONFIG_STRING   
# 使用给定字串作为配置，与配置文件语法相同

--modules
# 启动指定模块，与-M选项一起使用可将值分配给指定模块的默认变量
# 若在命令行中使用了--modules，那么logstash.yml中的任何模块设置都将被忽略
# 这个标志与 -f、-e 是互斥的，只能指定-f、-e、--modules之一

-M, --modules.variable   
# 为模块的可配置选项分配一个值。 
# 对于Logstash变量，赋值变量的格式是-M "MODULE_NAME.var.PLUGIN_TYPE.PLUGIN_NAME.KEY_NAME=value"
# 对于其他设置，将是 -M "MODULE_NAME.KEY_NAME.SUB_KEYNAME=value"
# -M标志可根据需要多次使用，若未指定-M，则将使用该设置的默认值
# -M标志仅与--modules结合使用。如果--modules不存在它将被忽略

-w, --pipeline.workers COUNT  
# 设置运行的管道worker数。其设置并行执行管道的过滤、输出阶段的worker数量
# 若发现事件正在堆积或CPU未饱和，请考虑增加此数字以更好地利用处理能力，默认是CPU核数

-b, --pipeline.batch.size SIZE  
# 定义在尝试执行过滤器和输出之前，单个工作线程从输入中收集的最大事件数量，默认是125个
# 较大的批量一般来说效率更高，但是以增加的内存开销为代价
# 因此须通过设置 LS_HEAP_SIZE 变量来有效使用该选项来增加JVM堆大小

-u, --pipeline.batch.delay DELAY_IN_MS  
# 在创建管道批次时，轮询下一个事件需多长时间
# 此选项定义在将过小的批次分配给过滤器和工作人员之前轮询下一个事件时需要等待多长时间（以毫秒为单位）默认50ms

--pipeline.unsafe_shutdown   
# 强制Logstash在关机过程中退出，即使内存中仍存在飞行事件
# 默认情况下Logstash将拒绝退出，直到所有收到的事件都被推送到输出，启用此选项可能会导致关机期间数据丢失

--path.data PATH     
# 在需要存储数据时使用这个目录。插件也可以访问这个路径
# 默认值是Logstash home下的数据目录

-p, --path.plugins PATH   
# 一个找到自定义插件的路径。 这个标志可以多次给定来包含多个路径
# 预期插件位于特定的目录层次结构中：PATH/logstash/TYPE/NAME.rb 其中TYPE是输入、过滤器、输出、编解码器，NAME是插件名称

-l, --path.logs PATH   
# 将Logstash内部日志写入这里

--log.level LEVEL   
# 设置日志级别：fatal，error,warn,info,debug,trace

--config.debug   
# 将完全编译的配置显示为调试日志消息（还必须启用--log.level = debug）
# 警告：日志消息将包括以明文形式传递给插件配置的所有密码选项，并可能导致明文密码出现在日志中！

-i, --interactive SHELL   
# Drop to shell instead of running as normal. Valid shells are "irb" and "pry".

-V, --version   
# 版本信息

-t, --config.test_and_exit  
# 检查配置的有效语法然后退出。 注意grok模式不检查与此标志的正确性
# Logstash可从目录中读取多个配置文件
# 如果将此标志与--log.level=debug结合使用，则Logstash将记录组合的配置文件并使用它来自的源文件注释每个配置块

-r, --config.reload.automatic   
# 监视配置更改，并在配置更改时重新加载
# 注：使用SIGHUP手动重新加载配置

--config.reload.interval RELOAD_INTERVAL   
# 轮询轮询配置位置以进行更改的频率，默认3s

--http.host HTTP_HOST   
# Web API绑定主机。 此选项指定度量标准REST端点的绑定地址。 默认是 127.0.0.1

--http.port HTTP_PORT   
# Web API http端口。此选项为指标REST端点指定绑定端口。
# 默认 9600-9700。 该设置接受9600-9700格式的范围。Logstash会使用第一个可用端口

--log.format FORMAT    l
# 指定Logstash是否以JSON形式（每行一个事件）或纯文本（使用Ruby的Object＃inspect）编写自己的日志。 默认 plain

--path.settings SETTINGS_DIR   
# 设置包含logstash.yml设置文件的目录以及log4j日志记录配置
# 这也可以通过LS_SETTINGS_DIR环境变量来设置。 默认是Logstash home下的config目录

-h, --help   
# 打印帮助

Example

# https://www.elastic.co/guide/en/logstash/current/running-logstash-command-line.html

nohup bin/logstash --node.name=demo --pipeline.id demo -f config.d/demo.config --path.data=.data/demo/ --path.logs .logs/ -u 200 -b 2000 &
# -u 或 –pipeline-batch-delay       提交间隔，每个pipeline线程在打包批量日志时最多等待几毫秒，默认50ms
# -b 或 --pipeline.batch.size       每个pipeline线程执行具体的filter、output前最多能累积的日志条数。默认125。越大性能越好，但消耗更多JVM内存 
# -r 或 --config.reload.automatic   配置文件内容发生变化时自动重载
# –configtest 或 -t                 测试配置文件语法
# –pipeline-workers 或 -w           运行 filter / output 的pipeline线程数，默认是CPU核数
# -l 或 --path.logs                 Logstash内部日志输出目录
# --node.name                       指定Logstash实例名。如果没指定的话默认是当前主机名
# -w 或 --pipeline.workers          设置要运行的管道worker数。此设置将并行执行worker的filter和output阶段的工作程序数
# --pipeline.id                     管道的唯一标识用于在 Kibana → Monitoring → Logstash → pipeline 中展示（否则所有实例均使用main）
# --log.level