웹키퍼 SG

다운로드 164
업데이트 2026. 11. 16.

설치 매뉴얼

개요

소만사 웹키퍼 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 스키마로 저장됩니다.

적용 범위

Note
소나 4.0.2308.0 이상에서 동작합니다. 파일(SFTP) 수집은 앱 1.2.2610.0 이상, 엘라스틱 넷앱 수집과 시스로그 수집은 앱 1.3.2611.0 이상에서 지원합니다.

요구 사항

항목요구사항비고
소나 권한시스템 관리 권한수집 > 수집기, 시스템 > 접속 프로파일 메뉴 접근
파일 접근 권한 (파일 수집)로그 파일 디렉터리에 대한 읽기 권한SFTP 접속 계정 기준
네트워크 허용 (파일 수집)TCP/22 (소나 수집 노드 → 로그 파일 호스트)SSH 포트를 변경한 경우 해당 포트
네트워크 허용 (엘라스틱 수집)엘라스틱 웹 포트 (소나 수집 노드 → 엘라스틱 서버)로그프레소에서 엘라스틱 웹 포트에 접속할 수 있도록 방화벽 정책 설정
네트워크 허용 (시스로그 수집)UDP/514 또는 TCP/514 (웹키퍼 SG → 소나 수집 노드, Inbound)방화벽 정책 반영 필요

웹키퍼 SG 설정 (시스로그 수집)

시스로그로 수집하는 경우에만 필요합니다. 웹키퍼 SG의 시스로그 전송 대상에 소나 수집 노드를 지정합니다.

  1. 전송 대상 주소에 소나 수집 노드의 IP 주소를 입력합니다.
  2. 포트와 프로토콜은 소나 수집기와 같게 지정합니다(기본 UDP/514).
  3. 웹 로그와 넷앱 로그를 모두 전송하도록 설정합니다.

앱은 웹키퍼 SG의 tcprelaying 시스로그 형식을 파싱합니다. 웹 로그는 사용자, 대응 행동, 호스트, URL, 분류, 서버 포트, 메소드, 사용자 IP, 서버 IP, 정책, 발생 일시 순서이고, 넷앱 로그는 사용자, 서버 포트, 분류, 사용자 IP, 서버 IP, 넷앱, 동작, 대응 행동, 정책, 발생 일시 순서입니다. 다른 형식으로 전송되는 로그는 원본 그대로 미분류로 저장됩니다.

로그프레소 수집 설정

파일(SFTP) 수집

단계 1: SSH 접속 프로파일 추가

SFTP 수집기는 SSH 유형의 접속 프로파일로 로그 파일 호스트에 접속합니다. 시스템 > 접속 프로파일에서 추가를 클릭하고 아래 값을 입력합니다.

구분항목설정
필수이름접속 프로파일을 식별할 고유한 이름
필수식별자로그프레소 쿼리 등에서 사용할 접속 프로파일의 고유 식별자
필수유형SSH 선택
필수호스트로그 파일 호스트 IP 또는 호스트명
필수포트SSH 포트. 기본값 22
필수계정로그 파일 디렉터리에 읽기 권한이 있는 계정
필수인증 유형인증 키 또는 암호 선택
선택암호인증 유형이 암호인 경우 입력
필수타임아웃초 단위 접속 제한 시간. 기본값 30
선택접속 유지 시간Keep-Alive 간격. 밀리초 단위
Note
인증 유형을 인증 키로 지정하면 인증 유형 옆의 공개키 설정 방법 버튼에서 소나의 SSH 공개키를 확인해, 로그 파일 호스트 계정의 authorized_keys 파일에 등록해야 합니다. 등록 전에는 접속 테스트가 실패합니다.

입력을 마친 뒤 접속 테스트를 실행해 결과가 성공인지 확인합니다.

단계 2: 수집기 추가

수집 > 수집기에서 추가를 클릭하고 아래 값을 입력합니다.

소나 수집기 추가 화면에서 WebKeeper SG (SFTP) 수집 모델 선택

WebKeeper SG (SFTP) 수집 모델의 옵션 영역 1

WebKeeper SG (SFTP) 수집 모델의 옵션 영역 2

구분항목설정
필수이름수집기를 식별할 고유한 이름
필수실행 방식주기 선택
필수주기초 단위 수집 주기
필수적재 위치로그를 적재할 노드 선택
선택수집 위치수집을 수행할 센트리 선택
필수수집 모델WebKeeper SG (SFTP) 선택
필수테이블로그를 저장할 테이블 이름. 예: WEBKEEPER
필수SSH 프로파일단계 1에서 등록한 접속 프로파일
필수디렉터리 경로로그 파일이 있는 디렉터리의 절대 경로
필수파일이름 패턴수집할 웹·넷앱 CSV 파일 이름에 일치하는 정규식
선택문자 집합로그 파일의 문자 인코딩
Note
파서는 각 파일의 첫 줄(헤더)을 읽어 컬럼을 매핑합니다. 웹키퍼에서 내보내는 컬럼 구성이 바뀌어도 수집기 설정을 바꿀 필요가 없습니다.

엘라스틱 수집

웹 로그와 넷앱 로그는 같은 엘라스틱 인덱스에 함께 저장되지만, 수집 모델은 로그 종류별로 나뉘어 있습니다. 두 종류를 모두 수집하려면 같은 접속 프로파일로 수집기를 하나씩 추가합니다.

단계 1: 접속 프로파일 추가

시스템 > 접속 프로파일에서 추가를 클릭하고 유형을 웹키퍼 SG로 선택한 뒤 아래 값을 입력합니다.

소나 접속 프로파일 추가 화면에서 웹키퍼 SG 유형 선택과 옵션 입력

구분항목설정
필수이름접속 프로파일을 식별할 고유한 이름
필수식별자로그프레소 쿼리 등에서 사용할 접속 프로파일의 고유 식별자
필수유형웹키퍼 SG 선택
필수엘라스틱 주소엘라스틱 접속 주소 (https://IP 형태)
필수ES 인덱스 포맷인덱스 생성 주기. 일별 yyyyMMdd, 주별 yyyyMM_W, 월별 yyyy_MM

단계 2: 수집기 추가

수집 > 수집기에서 추가를 클릭하고 아래 값을 입력합니다.

소나 수집기 추가 화면에서 WebKeeper SG 웹 (Elastic) 수집 모델 선택

WebKeeper SG 웹 (Elastic) 수집 모델의 옵션 영역

구분항목설정
필수이름수집기를 식별할 고유한 이름
필수실행 방식주기 선택
필수주기초 단위 수집 주기
필수적재 위치로그를 적재할 노드 선택
선택수집 위치수집을 수행할 센트리 선택
필수수집 모델웹 로그는 WebKeeper SG 웹 (Elastic), 넷앱 로그는 WebKeeper SG 넷앱 (Elastic) 선택
필수테이블로그를 저장할 테이블 이름. 예: WEBKEEPER
필수접속 프로파일단계 1에서 등록한 접속 프로파일 이름
필수로그 수집 시작 일자며칠자 로그부터 수집할지 yyyyMMdd 형식으로 입력
선택수집 대기 시간(초)중복 수집을 막기 위해 현재 시점에서 이 시간 이전까지의 로그만 수집. 기본값 5
Note
앱 1.2.2610.0 이하에서 수집 모델 이름 WebKeeper SG로 만든 수집기는 업데이트 후 WebKeeper SG 웹 (Elastic) 수집기로 그대로 동작합니다. 넷앱 로그가 필요하면 넷앱 수집기만 추가합니다.

시스로그 수집

수집 > 수집기에서 추가를 클릭하고 아래 값을 입력합니다.

소나 수집기 추가 화면에서 WebKeeper SG (Syslog) 수집 모델 선택

WebKeeper SG (Syslog) 수집 모델의 옵션 영역 1

구분항목설정
필수이름수집기를 식별할 고유한 이름
필수적재 위치로그를 적재할 노드 선택
선택수집 위치수집을 수행할 센트리 선택
필수수집 모델WebKeeper SG (Syslog) 선택
필수테이블로그를 저장할 테이블 이름. 예: WEBKEEPER
선택원격지 IP웹키퍼 SG의 IP. 단일 IP, IP1-IP2 범위, CIDR 표기 지원
선택포트수신 포트 필터. 미입력 시 모든 수신 포트의 로그를 받습니다

참고 자료