설치 매뉴얼
JEUS 설정
단계 1: 액세스 로그 출력 활성화 및 LogFormat 확인
JEUS 관리 콘솔에서 웹 엔진의 액세스 로그 설정을 확인합니다.
앱의 파서에서 요구하는 기본 LogFormat 설정은 다음과 같습니다. 아래 포맷과 차이가 있다면 앱의 파서 설정에서 LogFormat 옵션 설정을 변경하세요.
단계 2: 로그 파일 경로 확인
JEUS 액세스 로그 파일이 저장되는 경로를 확인합니다. 경로는 JEUS 설치 환경에 따라 다릅니다.
로그 로테이트 설정(일 단위·주 단위 등)과 파일명 패턴을 함께 기록해 두세요. 로그프레소 수집기 설정 단계에서 파일이름 패턴 정규식 입력에 사용합니다.
예시:
- 디렉토리:
/opt/jeus8/domains/myDomain/servers/server1/logs/ - 파일명 패턴:
access_log_\d{8}\.log(날짜 로테이션 기준)
로그프레소 수집 설정
단계 1 (SFTP 원격 파일 수집 시): 접속 프로파일 추가
JEUS Server (SFTP) 수집모델을 선택하는 경우 SSH 접속 프로파일이 필요합니다. 이 문서를 참고해 접속 프로파일을 추가하세요.
시스템 > 접속 프로파일에서 추가를 클릭하고 SSH 접속 정보를 입력합니다.
| 구분 | 항목 | 설정 |
|---|---|---|
| 필수 | 이름 | 접속 프로파일을 식별할 고유한 이름 |
| 필수 | 식별자 | 로그프레소 쿼리 등에서 사용할 접속 프로파일의 고유 식별자 |
| 필수 | 유형 | SSH 선택 |
| 필수 | 호스트 | JEUS 서버 IP 또는 호스트명 |
| 필수 | 포트 | SSH 포트 (기본 22) |
| 필수 | 계정 | SFTP 계정 |
| 필수 | 인증 유형 | 암호 또는 키 인증 |
| 필수 | 암호 | 인증 유형이 암호인 경우 입력 |
하단의 접속 테스트 버튼을 클릭해 정상적으로 접속함을 확인합니다.
단계 2: 소나에서 수집기 추가
이 문서를 참고해 수집기를 추가하세요. 기본 설치되는 대시보드 및 데이터셋은 이름이 WEB_JEUS로 시작하는 테이블을 참조합니다.
수집 > 수집기 > 추가에서 아래 값을 입력합니다.
| 구분 | 항목 | 설정 |
|---|---|---|
| 필수 | 이름 | 수집기를 식별할 고유한 이름 |
| 필수 | 적재 위치 | 로그프레소 플랫폼 구성에 따라 적합한 노드 선택 |
| 필수 | 수집 모델 | 로컬 수집: JEUS Server (File) / SFTP 수집: JEUS Server (SFTP) |
| 필수 | 테이블 | WEB_JEUS로 시작하는 테이블 이름 입력. 예: WEB_JEUS |
아래는 각 수집모델에 따른 필수 옵션입니다.
| 구분 | 항목 | 설정 |
|---|---|---|
| 선택 | SSH 프로파일 | 로컬 수집 시 비움. SFTP 수집 시 단계 1에서 등록한 프로파일 선택 |
| 필수 | 디렉토리 경로 | JEUS 설정에서 확인한 로그 파일 디렉토리 절대 경로 |
| 필수 | 파일 이름 패턴 | 정규식. 예: access_log_\d{8}\.log |
Tip
수집 모델에는 geoip 조회와 jeus-analyze-user-agent가 스트림 처리로 내장되어 있습니다. 수집기를 등록하면 src_ip 와 user_agent 필드 값에 따라 src_country·src_asn·os_name·browser_name·bot_type 등 분석 필드가 자동으로 채워집니다.