카프카 설정하기
카프카 에이전트의 수집 옵션(컨피그)을 kafka-gent에 적용할 수 있습니다.
파일 위치: ${exemon-kafka-agent-home}/cfg/kafka.conf
노트
대부분의 옵션은 변경 후 kafka-agent를 재시작해야 적용됩니다. TOPIC_CONSUMER_REQUEST_TIMEOUT은 예외적으로 cfg.reload touch로 동적 적용이 가능합니다.
옵션 목록
| 옵션명 | 설명 | 기본값 | 지원 버전 |
|---|---|---|---|
| RECEIVER_ADDR | 서버(Receiver) 주소. {IP}:{PORT} 형식으로 설정한다. | "" | 전 버전 |
| RECEIVER_RECONNECT_DELAY_TIME | 서버와의 연결이 끊어진 경우 재연결을 시도하는 주기 | 1000 | 전 버전 |
| EXEM_GROUP_ID | 에이전트의 그룹을 설정한다. | "" | 전 버전 |
| EXEM_FILE_PERMISSION | 에이전트가 생성하는 로그 파일의 권한을 설정한다. | 660 | 전 버전 |
| HOSTNAME_COLLECT_TYPE_PRIORITY | host name 수집 방식을 결정한다. (1: Environment, 2: InetAddress, 3: Command) | 1,2,3 | 전 버전 |
| CONSOLE_LOG_LEVEL | 콘솔 로그 출력 수준을 설정한다. | INFO | 전 버전 |
| FILE_LOG_LEVEL | 파일 로그 출력 수준을 설정한다. | INFO | 전 버전 |
| SPRING_LOG_LEVEL | Spring Framework의 최대 로그 수준을 설정한다. | OFF | 전 버전 |
| FILE_LOG_LEVEL | 로그 수집 레벨 (DEBUG / INFO / WARN / ERROR) | - | v3.0.18+ |
| LOG_MAX_SIZE | 로그 파일의 최대 사이즈를 지정한다. | 100mb | 전 버전 |
| LOG_MAX_HISTORY | 로그 압축 파일의 최대 보관 일수(day)를 지정한다. | 10 | 전 버전 |
| LOG_LEVEL_SPECIFIC_ONLY | 특정 레벨에 해당하는 로그만 출력하도록 제한한다. | false | v3.0.18+ |
| TARGET_TOPIC_REGEX | 모니터링 대상 토픽을 정규표현식을 이용해 설정한다. | null | v3.0.5+ |
| TRACE_INTERNAL_TOPIC | 내부 토픽(__consumer_offsets 등) 수집 여부 | false | v3.0.5+ |
| TOPIC_MESSAGE_MAX_COUNT | 토픽 메시지 조회 시 최대 수집 개수 | 1000 | v3.0.12+ |
| TOPIC_MESSAGE_TOTAL_TIMEOUT | 토픽 메시지 조회 시 최대 수집(대기) 시간 (ms) (Min 0, Max 600000) | 10000 | v3.0.12+ |
| TRACE_CONSUMER_GROUP_WHEN_NO_TOPIC | 컨슈머 그룹에 모니터링 토픽이 없을 경우 해당 컨슈머 그룹의 수집 여부를 결정한다. | false | v3.0.18+ |
| TRACE_CONSUMER_GROUP_WHEN_EMPTY | 컨슈머 그룹이 Empty 상태일 때 해당 컨슈머 그룹의 수집 여부를 결정한다. | true | v3.0.18+ |
| TARGET_CONSUMER_GROUP_REGEX | Consumer Group 정규식 필터링. 값이 없으면 전체 수집 | null | v3.0.18+ |
| TOPIC_CONSUMER_REQUEST_TIMEOUT | Topic Message 조회 시 Consumer 요청 타임아웃 (Min 0, Max 60000) | 300 | v3.0.12+ |