Logstash 如何校验配置文件（configtest）？

命令：bin/logstash --config.test_and_exit -f /etc/logstash/conf.d/——只校验语法与插件配置就退出，不真正启动管道。输出 "Configuration OK" 即通过。

基本用法

# 校验单个文件
bin/logstash --config.test_and_exit -f logstash.conf

# 校验整个目录（生产常见）
bin/logstash --config.test_and_exit -f /etc/logstash/conf.d/

老版本（5.x 及更早）参数是 --configtest，语义相同。

注意三个细节

1. 校验的是语法不是语义：正则写错、Elasticsearch 地址不通这类问题测不出来——只保证配置能加载；
2. 退出码可用于 CI：通过返回 0，失败非 0——接入发布流水线自动拦截坏配置；
3. 目录模式会拼接所有文件：conf.d 下多个文件按字母序拼接成一条管道，校验的是拼接后的整体。

配合热重载

生产建议开 --config.reload.automatic：Logstash 自动检测配置变化并平滑重载。但热重载失败会保留旧管道运行、错误写日志——所以即便有热重载，发布前 test_and_exit 仍是必要防线。

观测云对照

观测云 DataKit 的 Pipeline 脚本在控制台提供在线调试器：粘贴样例日志即可验证脚本输出，配置下发前可先在界面验证，等效于"带真实数据的 configtest"。

常见问题（FAQ）

Q：校验通过但启动还是失败？ 检查外部依赖连通性（ES/Kafka 地址）、文件权限（logstash 用户能否读日志路径）。

Q：Docker 里怎么跑校验？ docker run --rm -v $PWD/conf.d:/conf.d logstash:8 bin/logstash --config.test_and_exit -f /conf.d/。