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_ip | IP 주소 | 출발지 IP | |
| dst_ip | IP 주소 | 목적지 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
예상 결과:
| user | dst_ip | count |
|---|---|---|
| test_user | 192.0.2.3 | 15 |
| user1 | 192.0.2.4 | 4 |
결과 해석: 차단이 반복되는 사용자와 목적지를 확인해 정책 예외가 필요한 업무용 서비스인지, 차단 우회 시도인지 판단합니다.