호스트 설정
호스트 에이전트의 수집 옵션(컨피그)을 등록하고, 호스트 그룹별 또는 호스트별로 적용할 수 있습니다.
화면에 들어가려면 좌측 메뉴에서 환경설정을 선택한 후, 설정 화면 좌측 메뉴에서 플랫폼 > 인프라스트럭쳐 > 호스트를 선택하세요.
화면은 좌측의 호스트 그룹 패널과 우측의 호스트 목록으로 구성됩니다.
- 호스트 그룹 패널에는 그룹별 호스트 수가 표시되며, [그룹 추가]로 새 그룹을 만들 수 있습니다. 그룹 항목에 마우스를 올리면 편집·삭제 아이콘이 표시됩니다.
- 호스트 목록에는 호스트별 OS 정보, Agent Version, Status와 적용된 컨피그 정보(Config Info의 Isolated Config, Target Config)가 표시됩니다.
컨피그 적용 방식 이해하기
호스트에 적용되는 컨피그는 두 가지 방식이 있으며, 개별 설정이 그룹 설정보다 우선합니다.
| 구분 | 그룹 컨피그(Group Config) | 개별 컨피그(Isolated Config) |
|---|---|---|
| 적용 범위 | 그룹 내 전체 호스트 | 선택한 개별 호스트 |
| 우선순위 | 낮음 | 높음 |
| 용도 | 공통 설정 일괄 적용 | 호스트별 개별 설정 |
특정 호스트에만 다른 설정값이 필요한 경우 개별 컨피그를 사용하세요.
호스트별 개별 컨피그 적용하기
- 호스트 목록에서 설정을 적용할 호스트를 체크하세요.
- 목록 상단의 [타겟 컨피그 설정] 버튼을 클릭하세요.
- 타겟 컨피그 설정 다이얼로그에서 개별 컨피그 활성화 토글을 켜세요.
- 컨피그 목록에서 적용할 컨피그를 선택하세요. 목록에는 컨피그별 Config Name, Group, Target, Description이 표시됩니다.
- [저장] 버튼을 클릭하세요.
노트
개별 컨피그 활성화를 켜면 호스트별 컨피그가 적용되고, 끄면 호스트가 속한 그룹의 컨피그가 적용됩니다.
새 컨피그 추가하기
- 타겟 컨피그 설정 다이얼로그에서 [컨피그 추가] 버튼을 클릭하세요.
- 컨피그 이름(필수)과 설명을 입력하고 [저장] 버튼을 클릭하세요.
컨피그 옵션 변경하기
컨피그 목록에서 컨피그 우측의 편집(연필) 아이콘을 클릭하면 컨피그 설정 다이얼로그가 열립니다. 옵션별 Key, Value, Description이 표시되며, Value를 수정해 저장합니다.
- 변경할 옵션이 많으면 상단 검색창에 옵션 이름을 입력해 찾을 수 있습니다.
- 각 옵션의 의미와 기본값은 아래 Host Agent 옵션 목록을 참고하세요.
주의
default 컨피그는 기본 제공 설정으로, 옵션을 수정할 수 없습니다. 옵션을 변경하려면 새 컨피그를 추가하세요.
에이전트 버전 확인하기
호스트 목록의 Agent Version 컬럼에서 각 호스트에 설치된 에이전트 버전을 확인할 수 있습니다.
Host Agent 옵션 목록
| 옵션명 | 설명 | 기본값 |
|---|---|---|
| HOST_LOG_DIRECTORY | Host agent의 log file을 저장할 경로 | ${EXEM_HOST_HOME}/log |
| HOST_LOG_FILENAME | Host agent의 log file 이름 | exem-host-agent.log |
| HOST_LOG_LEVEL | Host agent의 log level | Info |
| HOST_NETWORK_PERFORMANCE_MONITORING | NPM 기능 on / off 옵션 [3.0.13 버전 이상] | 0 (off) |
| HOST_NETWORK_DEVICE_LLDP | NDM 연계를 위한 LLDP 패킷 전송 on/off 옵션 [3.0.14 버전 이상] | 0 (off) |
| HOST_URL_MONITORING | URL 기능 on / off 옵션 [3.0.19 버전 이상] | 0 (off) |
| HOST_GPU_MODULE_PORT | GPU 모니터링을 위한 내부 모듈과 host agent 사이의 port 설정 옵션 [3.0.23 버전 이상] | 25410 |
| HOST_GPU_MODULE_LIB_PATH | GPU 모니터링을 위한 라이브러리 변경 옵션 [3.0.23 버전 이상] | libnvidia-ml.so.1 |
| HOST_COLLECT_DISK_STAT | disk stat의 수집 on / off 옵션 [3.0.22.2 버전 이상] | 1 (on) |
| HOST_COLLECT_MOUNT_TYPE_LIST | linux환경의 mount 수집 type 지정 옵션 [3.0.22.2 버전 이상] | ext,vxfs,xfs,btrfs |
| HOST_PORT_MONITORING_TIMEOUT | Port 모니터링 시 port 별 수집 timeout 지정 (ms) [3.0.22.3 버전 이상] | 20 |
| HOST_INTERVAL_DOCKER_CONTAINER | docker container monitoring 수집 주기 (sec) [3.0.24 버전 이상]. 0이면 수집하지 않습니다. | 0 |
| HOST_DEFAULT_IP | Default IP 수동 설정 옵션 [3.0.24 버전 이상] | - |
| HOST_DEFAULT_IP_NAME | Default IP 수동 설정 옵션 (인터페이스 이름 입력) [3.0.24 버전 이상] | - |
| HOST_DEFAULT_SYSTEM_MANUFACTURER | 시스템 제조사 수동 설정 옵션 [3.0.24 버전 이상] | - |
| HOST_COLLECT_WINDOWS_NETWORK_DRIVE | Windows 환경의 네트워크 드라이브 수집 on / off 옵션 [3.0.25.5 버전 이상] | - |
| HOST_GRPC_SERVER_MAX_RECV_MSG_SIZE | Receiver에 한 번에 전송할 최대 데이터 크기 (byte) [3.0.25.5 버전 이상] | 14000000 |
| HOST_RECEIVER_SESSION_TIMEOUT | Receiver와 데이터 송/수신 시 timeout 지정 옵션 (sec) [3.0.25.5 버전 이상] | 60 |
| HOST_INTERVAL_INFO_LOG | Host agent의 기본 info log가 출력되는 주기 | 300 |
| HOST_INTERVAL_METRIC | Host metric 데이터의 수집 주기 (cpu, memory, network, disk 등) (sec) | 5 |
| HOST_INTERVAL_PROCESS | Host process 수집 주기 (sec) | 20 |
| HOST_INTERVAL_INSTALLED_PACKAGE | Host에 설치된 package 정보 수집 주기 (sec) | 86400 (1일) |
| HOST_INTERVAL_SYSTEM_INFO | host system info 수집 주기 (cpu vendor, network interfaces 등) (sec) | 86400 (1일) |