telegraf 실행 옵션을 통한 다양한 실행 방법

telegraf는 여러 옵션을 통해 실행 시 에이전트의 동작을 제어 할 수 있습니다. 
그 중에서도 Telegraf를 유연하게 설정하고 관리하는데 유용한 옵션들에 대해 살펴보도록 하겠습니다.

 

telegraf option

--config <path>

• 설명: 특정 설정 파일을 사용하도록 Telegraf에 지시합니다.
• 사용법: telegraf --config /path/to/telegraf.conf
• 상세 설명: 이 옵션은 Telegraf가 실행 시 로드할 설정 파일을 지정합니다. 설정 파일에는 입력, 출력, 프로세서, 집계 플러그인 등의 설정이 포함됩니다.

--config-directory <directory>

• 설명: 지정된 디렉토리 내의 모든 설정 파일을 로드하도록 Telegraf에 지시합니다.
• 사용법: telegraf --config-directory /path/to/config-directory
• 상세 설명: 지정된 디렉토리 내의 모든 *.conf 파일을 로드하고 병합하여 Telegraf의 설정으로 사용합니다. 설정 파일이 여러 개로 분리되어 있는 경우 유용합니다.

--test

• 설명: 설정된 입력 플러그인을 테스트 모드로 실행합니다.
• 사용법: telegraf --config /path/to/telegraf.conf --test
• 상세 설명: 입력 플러그인을 테스트 모드로 실행하여 수집된 메트릭을 표준 출력으로 출력합니다. 실제 출력 플러그인으로 전송하지 않고 데이터를 검토할 수 있습니다.

--debug

• 설명: 디버그 모드를 활성화합니다.
• 사용법: telegraf --debug
• 상세 설명: 디버그 정보를 출력하여 문제 해결 및 상세한 로그 검토에 유용합니다.

--quiet

• 설명: 출력되는 로그 메시지를 최소화합니다.
• 사용법: telegraf --quiet
• 상세 설명: 기본 로그 메시지 출력을 억제하고, 오류 메시지만 출력합니다. 로그 출력을 최소화하고 싶은 경우 유용합니다.

--once

• 설명: 한 번 실행 후 종료되도록 Telegraf에 지시합니다.
• 사용법: telegraf --config /path/to/telegraf.conf --once
• 상세 설명: Telegraf가 설정된 작업을 한 번 수행하고 종료합니다. 주기적인 데이터 수집이 아닌 단발성 작업에 유용합니다. 

--watch-config

• 설명: 설정 파일 변경을 감시하고 변경될 때마다 Telegraf를 다시 로드하도록 합니다.
• 사용법: telegraf --config /path/to/telegraf.conf --watch-config
• 상세 설명: 설정 파일을 동적으로 변경할 필요가 있는 경우 유용합니다. 이 옵션을 사용하면 설정 파일이 변경될 때 자동으로 새로운 설정이 적용됩니다.

--input-filter

• 설명: 특정 입력 플러그인만 사용하도록 필터링합니다.
• 사용법: telegraf --input-filter cpu:mem --config /path/to/telegraf.conf
• 상세 설명: 콜론으로 구분된 입력 플러그인 목록을 지정하여, 지정된 플러그인만 활성화합니다. 설정 파일 내의 다른 입력 플러그인은 무시됩니다.

--output-filter

• 설명: 특정 출력 플러그인만 사용하도록 필터링합니다.
• 사용법: telegraf --output-filter influxdb --config /path/to/telegraf.conf
• 상세 설명: 콜론으로 구분된 출력 플러그인 목록을 지정하여, 지정된 플러그인만 활성화합니다. 설정 파일 내의 다른 출력 플러그인은 무시됩니다.

--pidfile <path>

• 설명: Telegraf의 프로세스 ID를 저장할 파일을 지정합니다.
• 사용법: telegraf --pidfile /path/to/pidfile
• 상세 설명: Telegraf의 프로세스 ID를 지정된 파일에 저장합니다. 이 파일을 통해 Telegraf 프로세스를 관리할 수 있습니다.

--pprof-addr <address>

• 설명: pprof 디버깅 서버의 주소를 지정합니다.
• 사용법: telegraf --pprof-addr localhost:6060
• 상세 설명: Go의 pprof 패키지를 사용하여 성능 프로파일링 서버를 실행합니다. 이를 통해 Telegraf의 성능 분석 및 디버깅이 가능합니다.

--config-directory-reload-interval <duration>

• 설명: 설정 디렉토리의 파일 변경을 감시하는 간격을 설정합니다.
• 사용법: telegraf --config-directory /path/to/config-directory --config-directory-reload-interval 10s
• 상세 설명: 설정 디렉토리 내 파일 변경을 감시하고, 지정된 간격(예: 10s, 1m)으로 변경 사항을 다시 로드합니다.

 

telegraf option example

위의 telegraf option 중 `--config`, `--config-directory` 옵션 예제에 대해 살펴보겠습니다.

 

아래와 같이 telegraf 실행 파일과 telegraf.conf, 이외 plugin config가 있는 conf 디렉토리가 있습니다.

conf 디렉토리, telegraf 실행파일, global telegraf.conf

 

telegraf.conf

conf 디렉토리 안 config 파일

influxdb plugin, cpu plugin 설정

 

telegraf 실행 옵션을 적용하여 실행해보겠습니다.

./telegraf --config ./telegraf.conf --config-directory ./conf

telegraf 실행 옵션 적용

 

위와 같이 telegraf를 실행하면 telegraf.conf 파일과 conf 디렉토리 설정에 따라 데이터가 수집되는 것을 확인할 수 있습니다.

설정에 따른 메트릭 수집 결과