资讯中心

如何运用命令行启动Logstash

  

以下是使用命令行启动Logstash的常用方法及参数说明,综合了不同场景下的操作指南:


一、基本启动方式

  1. 通过配置文件启动
    使用
    -f
    参数指定配置文件路径,适用于复杂场景:
    bin/logstash -f /path/to/config.conf ``` ``` 若需指定多个配置文件,可将它们放在同一目录,Logstash会自动拼接所有 `.conf` 文件[1]()[3]()[5]()。
  2. 直接输入配置内容
    使用
    -e
    参数在命令行中直接编写配置,适合快速测试:
    bin/logstash -e 'input { stdin { } } output { stdout { } }'``` ``` 输入内容后,Logstash会实时输出处理结果[3]()[5]()[6]()。

二、常用参数说明

  1. 工作线程数

    -w
    --workers
    指定过滤和输出阶段的线程数,默认为CPU核心数:

     

    bin/logstash -f config.conf -w 4
  2. 日志输出控制

    -l
    --log
    指定日志文件路径,避免日志输出到控制台:
    undefined
    bash bin/logstash -f config.conf -l /var/log/logstash.log

     

    undefined
  3. 配置文件语法检查

    -t
    参数测试配置文件语法是否正确:

     

    bin/logstash -f config.conf -t
  4. 自动重新加载配置

    --config.reload.automatic
    启用自动检测配置修改并热加载:
    undefined
    bash bin/logstash -f config.conf --config.reload.automatic

     

    undefined

三、后台运行与调试

  1. 后台启动
    使用
    nohup
    &
    符号让进程在后台运行:
    nohup bin/logstash -f config.conf & ``` ``` 日志会输出到 `nohup.out` 文件[10]()[11]()。
  2. 调试模式
    -v
    输出详细日志,
    -d
    输出更详细的调试信息:
    bin/logstash -f config.conf -v

四、高级配置

  1. 指定实例名称

    -n
    参数定义Logstash实例名称,避免多实例冲突:
    undefined
    bash bin/logstash -n my_instance -f config.conf

     

    undefined
  2. 自定义插件路径

    -P
    --pluginpath
    指定自定义插件目录:

     

    bin/logstash -f config.conf -P /path/to/plugins
  3. 日志格式设置

    --log.format
    选择日志输出格式(
    json
    plain
    ):
    undefined
    bash bin/logstash -f config.conf --log.format json

     

    undefined

五、注意事项

如需更详细的参数说明,可参考Logstash官方文档或通过

bin/logstash --help

查看所有命令行选项。