설정하기
로그 모니터링을 사용하려면 먼저 Setting > Monitoring > Log에서 수집할 로그를 설정해야 합니다. Path에서 수집 규칙을 정의하고, Logging에서 수집 대상을 등록합니다.
host-agent가 설치되어있어야 합니다. host-agent 설치하기 Keyword Logging, Logging Trend, Live Tail 기능은 여기서 등록한 로그 설정을 기반으로 동작합니다.
Path 설정
Setting > Monitoring > Log > Path에서 수집할 로그의 규칙을 설정합니다.

Add Path 시 설정 항목은 다음과 같습니다.
| 항목 | 내용 |
|---|---|
| Path Name | Path 이름을 설정합니다. |
| Log Type | 로그 타입을 선택합니다. |
| Log Environment | 로그 파일이 존재하는 서버 환경을 선택합니다. |
| Path File | 로그 파일 경로를 입력합니다. |
| Config | 로그 출력 방식을 설정합니다. |
| Filter Key | 수집할 로그 키워드를 설정합니다. |
| Exclude Filter Key | 제외할 로그 키워드를 설정합니다. |
| Multi Line Type | 멀티 라인 타입을 설정합니다. |
| Parser Type | Parser Type을 선택합니다. |
| Parser Simulation | 실제 로그와 패턴을 입력해 파싱을 테스트합니다. |
Logging 설정
Setting > Monitoring > Log > Logging에서 수집할 로그를 등록합니다.

Add Logging 시 설정 항목은 다음과 같습니다.
| 항목 | 내용 |
|---|---|
| Logging Name | 로그 이름을 입력합니다. |
| Logging Group | 로그 그룹을 선택합니다. |
| Target | 로그를 수집할 타입과 대상을 선택합니다. |
| Path List | 로그 수집 정보(등록한 Path)를 선택합니다. |
Logging Trend 사전 설정 (Elasticsearch)
로깅 트렌드는 Elasticsearch에 수집된 로그를 사용하므로, 아래 설정이 추가로 필요합니다.
1단계. exemONE Repository DB(PostgreSQL)에서 Elasticsearch 로그 설정을 활성화합니다.
insert into xm_global_properties (props_id, name, value)
(
select uuid_generate_v4() as props_id, 'useESLog' as name, 'true' as value
where not exists (
select 1 from xm_global_properties where "name" = 'useESLog'
)
);
2단계. exemone-api에서 Elasticsearch를 활성화합니다. ({EXEM_HOME}/containers/exemone-api/configs/application.yml)
elasticsearch:
username:
password:
hostname: <ELASTICSEARCH_HOST>
port: 9200
connection-timeout: 30000
enable: true
3단계. exemone-api를 재시작합니다.
{EXEM_HOME}/scripts/restart api
4단계. exemone-ingester에서 Elasticsearch를 활성화합니다. ({EXEM_HOME}/containers/exemone-ingester/configs/ingester.yaml)
elasticsearch:
enabled: true
addresses:
- http://<ELASTICSEARCH_HOST>:9200
username:
password:
5단계. exemone-ingester를 재시작합니다.
{EXEM_HOME}/scripts/restart ingester
6단계. Setting > Log > Path에서 Log Repository를 Elasticsearch로 선택해 Path를 추가합니다.
7단계. Setting > Log > Logging에서 Elasticsearch Path를 선택해 Logging을 추가합니다.
Elasticsearch는 8버전 이상을 지원합니다. (적용 버전: exemone-api v3.0.506.15.50, exemone-ingester v3.0.506.15.29)