설치 매뉴얼
개요
소만사 웹키퍼 SG의 웹 접속 로그와 넷앱 로그를 소나로 수집합니다. 수집 방식은 세 가지이며, 운영 환경에 맞는 방식을 선택합니다.
| 수집 방식 | 수집 모델 | 수집 로그 | 설명 |
|---|---|---|---|
| 파일(SFTP) | WebKeeper SG (SFTP) | 웹, 넷앱 | 웹키퍼가 내보낸 CSV 로그 파일을 소나가 SFTP로 접속해 읽어옵니다 |
| 엘라스틱 | WebKeeper SG 웹 (Elastic) | 웹 | 웹키퍼 SG가 로그를 적재하는 엘라스틱 서버의 인덱스에서 직접 가져옵니다 |
| 엘라스틱 | WebKeeper SG 넷앱 (Elastic) | 넷앱 | 위와 같으며 넷앱 로그를 가져옵니다 |
| 시스로그 | WebKeeper SG (Syslog) | 웹, 넷앱 | 웹키퍼 SG가 시스로그로 보내는 로그를 소나가 받습니다 |
파일·시스로그 수집은 앱의 파서가 로그 종류를 판별해 log_type 필드에 http(웹) 또는 netapps(넷앱)를 붙이고, 각각 webkeeper-http, webkeeper-netapps 스키마로 정규화합니다. 엘라스틱 넷앱 로그는 webkeeper-netapps, 엘라스틱 웹 로그는 공용 webfilter 스키마로 저장됩니다.
적용 범위
요구 사항
| 항목 | 요구사항 | 비고 |
|---|---|---|
| 소나 권한 | 시스템 관리 권한 | 수집 > 수집기, 시스템 > 접속 프로파일 메뉴 접근 |
| 파일 접근 권한 (파일 수집) | 로그 파일 디렉터리에 대한 읽기 권한 | SFTP 접속 계정 기준 |
| 네트워크 허용 (파일 수집) | TCP/22 (소나 수집 노드 → 로그 파일 호스트) | SSH 포트를 변경한 경우 해당 포트 |
| 네트워크 허용 (엘라스틱 수집) | 엘라스틱 웹 포트 (소나 수집 노드 → 엘라스틱 서버) | 로그프레소에서 엘라스틱 웹 포트에 접속할 수 있도록 방화벽 정책 설정 |
| 네트워크 허용 (시스로그 수집) | UDP/514 또는 TCP/514 (웹키퍼 SG → 소나 수집 노드, Inbound) | 방화벽 정책 반영 필요 |
웹키퍼 SG 설정 (시스로그 수집)
시스로그로 수집하는 경우에만 필요합니다. 웹키퍼 SG의 시스로그 전송 대상에 소나 수집 노드를 지정합니다.
- 전송 대상 주소에 소나 수집 노드의 IP 주소를 입력합니다.
- 포트와 프로토콜은 소나 수집기와 같게 지정합니다(기본 UDP/514).
- 웹 로그와 넷앱 로그를 모두 전송하도록 설정합니다.
앱은 웹키퍼 SG의 tcprelaying 시스로그 형식을 파싱합니다. 웹 로그는 사용자, 대응 행동, 호스트, URL, 분류, 서버 포트, 메소드, 사용자 IP, 서버 IP, 정책, 발생 일시 순서이고, 넷앱 로그는 사용자, 서버 포트, 분류, 사용자 IP, 서버 IP, 넷앱, 동작, 대응 행동, 정책, 발생 일시 순서입니다. 다른 형식으로 전송되는 로그는 원본 그대로 미분류로 저장됩니다.
로그프레소 수집 설정
파일(SFTP) 수집
단계 1: SSH 접속 프로파일 추가
SFTP 수집기는 SSH 유형의 접속 프로파일로 로그 파일 호스트에 접속합니다. 시스템 > 접속 프로파일에서 추가를 클릭하고 아래 값을 입력합니다.
| 구분 | 항목 | 설정 |
|---|---|---|
| 필수 | 이름 | 접속 프로파일을 식별할 고유한 이름 |
| 필수 | 식별자 | 로그프레소 쿼리 등에서 사용할 접속 프로파일의 고유 식별자 |
| 필수 | 유형 | SSH 선택 |
| 필수 | 호스트 | 로그 파일 호스트 IP 또는 호스트명 |
| 필수 | 포트 | SSH 포트. 기본값 22 |
| 필수 | 계정 | 로그 파일 디렉터리에 읽기 권한이 있는 계정 |
| 필수 | 인증 유형 | 인증 키 또는 암호 선택 |
| 선택 | 암호 | 인증 유형이 암호인 경우 입력 |
| 필수 | 타임아웃 | 초 단위 접속 제한 시간. 기본값 30 |
| 선택 | 접속 유지 시간 | Keep-Alive 간격. 밀리초 단위 |
입력을 마친 뒤 접속 테스트를 실행해 결과가 성공인지 확인합니다.
단계 2: 수집기 추가
수집 > 수집기에서 추가를 클릭하고 아래 값을 입력합니다.
| 구분 | 항목 | 설정 |
|---|---|---|
| 필수 | 이름 | 수집기를 식별할 고유한 이름 |
| 필수 | 실행 방식 | 주기 선택 |
| 필수 | 주기 | 초 단위 수집 주기 |
| 필수 | 적재 위치 | 로그를 적재할 노드 선택 |
| 선택 | 수집 위치 | 수집을 수행할 센트리 선택 |
| 필수 | 수집 모델 | WebKeeper SG (SFTP) 선택 |
| 필수 | 테이블 | 로그를 저장할 테이블 이름. 예: WEBKEEPER |
| 필수 | SSH 프로파일 | 단계 1에서 등록한 접속 프로파일 |
| 필수 | 디렉터리 경로 | 로그 파일이 있는 디렉터리의 절대 경로 |
| 필수 | 파일이름 패턴 | 수집할 웹·넷앱 CSV 파일 이름에 일치하는 정규식 |
| 선택 | 문자 집합 | 로그 파일의 문자 인코딩 |
엘라스틱 수집
웹 로그와 넷앱 로그는 같은 엘라스틱 인덱스에 함께 저장되지만, 수집 모델은 로그 종류별로 나뉘어 있습니다. 두 종류를 모두 수집하려면 같은 접속 프로파일로 수집기를 하나씩 추가합니다.
단계 1: 접속 프로파일 추가
시스템 > 접속 프로파일에서 추가를 클릭하고 유형을 웹키퍼 SG로 선택한 뒤 아래 값을 입력합니다.
| 구분 | 항목 | 설정 |
|---|---|---|
| 필수 | 이름 | 접속 프로파일을 식별할 고유한 이름 |
| 필수 | 식별자 | 로그프레소 쿼리 등에서 사용할 접속 프로파일의 고유 식별자 |
| 필수 | 유형 | 웹키퍼 SG 선택 |
| 필수 | 엘라스틱 주소 | 엘라스틱 접속 주소 (https://IP 형태) |
| 필수 | ES 인덱스 포맷 | 인덱스 생성 주기. 일별 yyyyMMdd, 주별 yyyyMM_W, 월별 yyyy_MM |
단계 2: 수집기 추가
수집 > 수집기에서 추가를 클릭하고 아래 값을 입력합니다.
| 구분 | 항목 | 설정 |
|---|---|---|
| 필수 | 이름 | 수집기를 식별할 고유한 이름 |
| 필수 | 실행 방식 | 주기 선택 |
| 필수 | 주기 | 초 단위 수집 주기 |
| 필수 | 적재 위치 | 로그를 적재할 노드 선택 |
| 선택 | 수집 위치 | 수집을 수행할 센트리 선택 |
| 필수 | 수집 모델 | 웹 로그는 WebKeeper SG 웹 (Elastic), 넷앱 로그는 WebKeeper SG 넷앱 (Elastic) 선택 |
| 필수 | 테이블 | 로그를 저장할 테이블 이름. 예: WEBKEEPER |
| 필수 | 접속 프로파일 | 단계 1에서 등록한 접속 프로파일 이름 |
| 필수 | 로그 수집 시작 일자 | 며칠자 로그부터 수집할지 yyyyMMdd 형식으로 입력 |
| 선택 | 수집 대기 시간(초) | 중복 수집을 막기 위해 현재 시점에서 이 시간 이전까지의 로그만 수집. 기본값 5 |
시스로그 수집
수집 > 수집기에서 추가를 클릭하고 아래 값을 입력합니다.
| 구분 | 항목 | 설정 |
|---|---|---|
| 필수 | 이름 | 수집기를 식별할 고유한 이름 |
| 필수 | 적재 위치 | 로그를 적재할 노드 선택 |
| 선택 | 수집 위치 | 수집을 수행할 센트리 선택 |
| 필수 | 수집 모델 | WebKeeper SG (Syslog) 선택 |
| 필수 | 테이블 | 로그를 저장할 테이블 이름. 예: WEBKEEPER |
| 선택 | 원격지 IP | 웹키퍼 SG의 IP. 단일 IP, IP1-IP2 범위, CIDR 표기 지원 |
| 선택 | 포트 | 수신 포트 필터. 미입력 시 모든 수신 포트의 로그를 받습니다 |







