웹키퍼 SG

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

webkeeper-netapps-logs

웹키퍼 SG의 엘라스틱 서버에서 지정된 기간의 넷앱 로그를 조회합니다.

문법

webkeeper-netapps-logs [profile=PROFILE] [duration=NUM{mon|w|d|h|m|s}] [from=yyyyMMddHHmmss] [to=yyyyMMddHHmmss] [offset=NUM] [limit=NUM]

옵션

profile=PROFILE
선택 옵션. 웹키퍼 SG 접속 프로파일 식별자. 생략하면 모든 웹키퍼 SG 접속 프로파일을 조회합니다.
duration=NUM{mon|w|d|h|m|s}
선택 옵션. 현재 시각으로부터 일정 시간 범위 이내의 이벤트로 한정. s(초), m(분), h(시), d(일), mon(월) 단위로 지정할 수 있습니다. 예를 들면, 10s의 경우 현재 시각으로부터 10초 이전까지의 범위를 의미합니다.
from=yyyyMMddHHmmss
선택 옵션. yyyyMMddHHmmss 포맷으로 범위의 시작을 지정합니다. 뒷자리를 쓰지 않으면 0으로 채워집니다.
to=yyyyMMddHHmmss
선택 옵션. yyyyMMddHHmmss 포맷으로 범위의 끝을 지정합니다. 뒷자리를 쓰지 않으면 0으로 채워집니다.
offset=NUM
선택 옵션. 건너 뛸 로그 갯수
limit=NUM
선택 옵션. 가져올 최대 로그 갯수

출력 필드

필드타입이름설명
_time날짜시각
guid문자열로그 GUID
agent_id문자열에이전트 ID
policy문자열정책
action문자열액션PERMIT, DENY
user문자열계정
emp_name문자열성명
dept_name문자열부서명
dept_id문자열부서 ID
dept_code문자열부서 코드
src_ipIP 주소출발지 IP
dst_ipIP 주소목적지 IP
dst_port정수목적지 포트
category_code정수분류 코드넷앱 분류 코드
service_code정수서비스 코드넷앱 서비스 코드
user_guid문자열계정 GUID

오류 코드

파싱 오류

오류 메시지원인해결
유효하지 않은 웹키퍼 프로파일 이름: [profile_name]profile 옵션에 지정한 접속 프로파일이 없음시스템 > 접속 프로파일에서 웹키퍼 SG 접속 프로파일의 식별자 확인
조회 가능한 웹키퍼 프로파일이 없습니다.profile 옵션을 생략했는데 조회 권한이 있는 웹키퍼 SG 접속 프로파일이 없음웹키퍼 SG 접속 프로파일을 추가하거나 권한 확인

런타임 오류

오류 메시지원인해결
webkeeper error, profile=프로파일 - 원인엘라스틱 서버에 접속할 수 없거나 응답이 올바르지 않음접속 프로파일의 엘라스틱 주소와 소나에서 엘라스틱 웹 포트로의 방화벽 정책 확인

설명

웹키퍼 SG의 엘라스틱 인덱스(wk_로 시작)에는 웹 로그와 넷앱 로그가 함께 저장되어 있습니다. 이 명령어는 그중 넷앱(netapps) 로그만 조회합니다. 로그 종류는 수신 시각 필드(apps_rcvtime)가 있는 문서로 구분합니다.

duration, from, to를 지정하면 접속 프로파일의 인덱스 포맷으로 조회할 인덱스를 고르고, 수신 시각 기준으로 범위를 한정합니다. 기간을 지정하지 않으면 모든 인덱스를 조회하므로 데이터가 많을 때는 기간을 지정하는 것이 좋습니다. 결과는 시각 순서로 정렬되어 있지 않습니다.

offset, limit은 여러 접속 프로파일과 인덱스에 걸쳐 전체 결과 기준으로 적용됩니다.

엘라스틱은 넷앱 분류와 서비스를 숫자 코드로만 제공하므로 category_code, service_code에 코드 그대로 출력합니다. 원본의 허용/차단 값(apps_isblock)은 action으로 정규화합니다. 3은 PERMIT, 2는 DENY입니다.

Note
넷앱 로그 조회는 앱 1.3.2611.0 이상에서 지원합니다.

사용 예

예시: 넷앱 차단 현황

상황: 최근 1시간 동안 차단된 넷앱 접속을 사용자별로 확인합니다.

webkeeper-netapps-logs profile=webkeeper duration=1h
| search action == "DENY"
| stats count by user, dst_ip
| sort -count

예상 결과:

userdst_ipcount
test_user192.0.2.315
user1192.0.2.44

결과 해석: 차단이 반복되는 사용자와 목적지를 확인해 정책 예외가 필요한 업무용 서비스인지, 차단 우회 시도인지 판단합니다.