본문으로 건너뛰기

OpenAgent 설정 옵션

OpenAgent가 whatap.conf에서 인식하는 옵션 목록입니다. 각 옵션은 기본값, 타입, 동작 설명 순으로 정리되어 있습니다. 옵션 값은 파일을 수정한 뒤 5초 이내에 자동으로 리로딩되므로 대부분의 경우 에이전트 재시작이 필요하지 않습니다.

본 문서는 다음 두 가지 범주로 옵션을 구분해 설명합니다.

  • 공통 기능: 모든 OpenAgent 사용 환경에서 공통으로 사용되는 옵션
  • OpenMetrics 제품 전용 옵션: OpenMetrics 프로젝트를 별도 제품으로 운영하는 경우에만 사용하는 옵션

공통 기능​

debug​

전역 디버그 모드를 활성화합니다. log_level이 미설정일 때만 적용되어 로그 레벨을 DEBUG로 승격합니다. log_level이 지정되어 있으면 무시됩니다.

  • 기본값: false

  • 타입: boolean

whatap.conf
debug=true

debug_tcpsend_enabled​

  • 기본값: false
  • 타입: boolean
  • 설명: Proxy 서버로 전송되는 TCP 팩을 디버깅합니다. 실제 로그가 출력되려면 로거가 DEBUG 레벨이어야 합니다 (debug=true 또는 log_level=DEBUG).
whatap.conf
debug_tcpsend_enabled=true
log_level=DEBUG

debug_tcpsend_packs​

debug_tcpsend_enabled=true일 경우 Proxy 서버로 전송될 Pack의 이름을 설정합니다. 값이 반영되려면 debug_tcpsend_enabled=true와 로거 DEBUG 레벨(debug=true 또는 log_level=DEBUG)이 모두 필요합니다.

  • 기본값: CounterPack1

  • 타입: string (콤마 구분 배열)

whatap.conf
debug_tcpsend_enabled=true
debug_tcpsend_packs=CounterPack1,ParamPack
log_level=DEBUG

log_level​

로그 출력 레벨을 설정합니다. 허용 값은 DEBUG, INFO, WARN, ERROR이며 대소문자를 구분하지 않습니다. 숫자 값(0 ~ 3)으로도 지정할 수 있습니다.

  • 기본값: INFO

  • 타입: string

whatap.conf
log_level=INFO

log_keep_days​

OpenAgent 로그 파일의 저장 기간(일 단위)을 설정합니다. 지정한 기간이 지난 로그 파일은 자동으로 삭제됩니다.

  • 기본값: 7

  • 타입: number

whatap.conf
log_keep_days=14

scrape_interval​

스크래핑 전역 기본 주기를 설정합니다. scrape_config.yaml의 globalInterval과 별개의 하위 호환 키입니다.

  • 기본값: 60s

  • 타입: string

whatap.conf
scrape_interval=30s

scrape_timeout​

스크래핑 전역 기본 타임아웃을 설정합니다.

  • 기본값: 없음

  • 타입: string

whatap.conf
scrape_timeout=10s

OpenMetrics 제품 전용 옵션​

아래 옵션은 OpenMetrics 프로젝트가 다른 와탭 제품과 연동되지 않고 별도 제품으로 운영되는 경우에만 사용합니다. 기본 구성에서는 설정할 필요가 없습니다.

whatap.oname​

에이전트 오브젝트 이름(oname)을 설정합니다. 별칭 whatap.name도 지원하며, 두 키를 동시에 지정하면 whatap.oname이 우선 적용됩니다.

  • 기본값: 없음 (미설정 시 {type}-{ip2}-{ip3}-{process} 패턴으로 자동 생성)
  • 타입: string
whatap.conf
whatap.oname=openmetrics-agent-01

whatap.okind​

에이전트의 okind(오브젝트 분류)를 설정합니다. 업무 디폴트 옵션 적용 시 okind 값을 기준으로 그룹핑됩니다.

  • 기본값: 없음

  • 타입: string

whatap.conf
whatap.okind=openmetrics-prod

whatap.onode​

  • 기본값: 없음
  • 타입: string
  • 설명: 에이전트의 onode(오브젝트 노드)를 설정합니다. 노드 단위로 에이전트를 묶어 관리할 때 사용합니다.
whatap.conf
whatap.onode=node-seoul-01

tag_counter_enabled​

OpenMetrics를 제품으로 사용할 경우 TagCount 메트릭 정보를 와탭 수집 서버로 전송합니다.

  • 기본값: false

  • 타입: boolean

whatap.conf
tag_counter_enabled=true
최종 수정: