Logstash 설정 배포 전 문법 검사하기

파이프라인 설정을 고치고 바로 재시작했다가 문법 오류로 안 뜨는 일이 종종 있습니다. Logstash에는 설정을 적용하지 않고 문법만 검사하고 빠져나오는 플래그가 있습니다. --config.test_and_exit(짧게 -t)인데, 공식 문서 설명 그대로 "Check configuration for valid syntax and then exit"입니다. 설정 파일은 -f(--path.config)로 지정하고, 디렉터리를 주면 그 안의 파일을 사전순으로 이어붙여 하나의 설정으로 파싱합니다.

# 파일 하나 검사
bin/logstash -f pipeline.conf --config.test_and_exit

# conf.d 디렉터리 통째로 검사 (사전순 병합 후 파싱)
bin/logstash -f /etc/logstash/conf.d --config.test_and_exit

배포 스크립트나 CI에서 재시작 직전에 한 번 돌려두면 문법 깨진 설정이 운영에 올라가는 걸 막을 수 있습니다. 한 가지 주의점은 이 플래그가 grok 패턴의 정확성까지 봐주지는 않는다는 겁니다. 문서에도 "grok patterns are not checked for correctness with this flag"라고 못 박혀 있으니, grok 매칭은 따로 테스트해야 합니다.

🔗 https://www.elastic.co/docs/reference/logstash/running-logstash-command-line