본문으로 건너뛰기

설정하기

로그 모니터링을 사용하려면 먼저 Setting > Monitoring > Log에서 수집할 로그를 설정해야 합니다. Path에서 수집 규칙을 정의하고, Logging에서 수집 대상을 등록합니다.

노트

host-agent가 설치되어있어야 합니다. host-agent 설치하기 Keyword Logging, Logging Trend, Live Tail 기능은 여기서 등록한 로그 설정을 기반으로 동작합니다.

Path 설정

Setting > Monitoring > Log > Path에서 수집할 로그의 규칙을 설정합니다.

Log Path 설정

Add Path 시 설정 항목은 다음과 같습니다.

항목내용
Path NamePath 이름을 설정합니다.
Log Type로그 타입을 선택합니다.
Log Environment로그 파일이 존재하는 서버 환경을 선택합니다.
Path File로그 파일 경로를 입력합니다.
Config로그 출력 방식을 설정합니다.
Filter Key수집할 로그 키워드를 설정합니다.
Exclude Filter Key제외할 로그 키워드를 설정합니다.
Multi Line Type멀티 라인 타입을 설정합니다.
Parser TypeParser Type을 선택합니다.
Parser Simulation실제 로그와 패턴을 입력해 파싱을 테스트합니다.

Logging 설정

Setting > Monitoring > Log > Logging에서 수집할 로그를 등록합니다.

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)