본문으로 건너뛰기

로그 파일 이벤트

홈 화면 > 프로젝트 선택 > 알림 아이콘 경고 알림 > 이벤트 설정 > 파일 키워드 감시 / 윈도우 이벤트 감시 / 파일 감시

와탭 모니터링에서 로그 파일에서 발생하는 다양한 이상 징후를 감지하여 알림을 제공합니다. 이벤트 규칙을 설정하면, 특정 조건이 충족될 때 경고(Warning) 또는 위험(Critical) 수준의 알림을 받을 수 있습니다. 로그 기반 이벤트는 세 가지 유형을 제공합니다.

  • 파일 키워드 감시
  • 윈도우 이벤트 감시
  • 파일 감시
주의

파일 키워드 감시, 윈도우 이벤트 감시, 파일 감시의 경우 수신자 태그 기능을 에이전트 버전 2.4.6 이상에서 지원합니다.

기본 옵션

  • 검색: 이벤트 이름 또는 이벤트 수신 태그를 선택해 원하는 이벤트 검색
  • + 이벤트 규칙 추가: 새로운 이벤트 추가
표 | 로그 파일 이벤트 설정 화면 구성
항목설명
조건이벤트 감지를 위한 로그 조건(파일 경로, 검색 키워드 등)
서버이벤트 조건이 적용되는 서버
이벤트 수신 태그알림을 전송받는 사용자 그룹
수정 아이콘저장된 이벤트 수정
copy Icon현재 또는 다른 프로젝트로 이벤트 설정 복사

이벤트 규칙 추가

특정 로그 파일과 윈도우 이벤트 설정을 관리할 수 있습니다.

  1. 알림 아이콘 경고 알림 > 이벤트 설정 > 파일 키워드 감시 / 윈도우 이벤트 감시 / 파일 감시 탭으로 이동하세요.

  2. [ + 이벤트 규칙 추가 ] 버튼을 클릭하세요.

  3. 제목에 이벤트 이름(최대 100자)을 입력하세요.

  4. 서버 목록에서 서버를 선택하고 [ 적용 ] 버튼을 클릭하세요.

    a. 프로젝트 기본 정책 옵션 토글 활성화 시 프로젝트가 관리하는 서버에 기본 알림 정책을 적용합니다.

  5. 이벤트 발생 조건로그 종류(파일 키워드 감시, 윈도우 이벤트 감시, 파일 감시)를 선택하세요.

    파일 키워드 감시
    표 | 파일 키워드 감시
    항목설명
    파일 경로(필수)감시할 파일의 경로를 입력하세요.
    - 파일 이름에 날짜/시간 패턴을 사용할 수 있습니다.
    - 예: /var/log/mylogfile_%Y-%m-%d_%H:%M:%S.log
    검색 키워드파일에서 감지할 키워드를 입력하세요.
    - 검색 키워드는 여러 개를 입력할 수 있습니다.
    - 예: `keyword1
    검출 제외 문자열알림에서 제외할 문자열을 입력하세요.
    - 검출 제외 문자열은 여러 개를 입력할 수 있습니다.
    - Agent 버젼 1.2.7 이상 지원
    - 예: `keyword1
    반복(회)지정한 검색 키워드가 감지되는 반복 횟수입니다.(단위: 회)
    기간(초)반복 조건이 충족되어야하는 시간 범위입니다.(단위: 초)
    위험도조건 충족 시 발생할 알림의 수준입니다.
    위험: Critical 알림 발생
    경고: Warning 알림 발생
    윈도우 이벤트 감시
    노트

    Windows 환경에서만 사용 가능합니다.

    표 | 윈도우 이벤트 감시
    항목설명
    로그명감시할 Windows 이벤트 로그의 유형을 선택합니다.
    - 응용 프로그램
    - 보안
    - 설정
    - 시스템
    - 전달된 이벤트
    수준감시할 이벤트의 수준을 선택하세요.
    - 정보
    - 경고
    - 위험, 오류
    - 감사 성공
    - 감사 실패
    원본감시할 이벤트 소스를 입력하세요.
    이벤트 ID이벤트 ID로 숫자로 입력하세요.
    검색 키워드파일에서 감지할 키워드를 입력하세요.
    - 검색 키워드는 여러 개를 입력할 수 있습니다.
    - 윈도우 이벤트뷰어 키워드 항목에는 적용되지 않습니다.
    - 예: keyword1
    검출 제외 문자열알림에서 제외할 문자열을 입력하세요.
    - 검출 제외 문자열은 여러 개를 입력할 수 있습니다.
    - Agent 버젼 1.2.7 이상 지원
    - 예: keyword1
    반복(회)지정한 검색 키워드가 감지되는 반복 횟수입니다. (단위: 회)
    기간(초)반복 조건이 충족되어야하는 시간 범위입니다. (단위: 초)
    위험도조건 충족 시 발생할 알림의 수준입니다.
    위험: Critical 알림 발생
    경고: Warning 알림 발생

    로그 파일 처리량

    로그 파일 처리량은 로그 라인 기준으로 제한됩니다. 로그가 단시간에 과도하게 발생하는 경우, 에이전트 CPU 사용량이 급증하는 것을 방지하기 위해 설정된 처리량까지만 수집합니다. 초과된 로그 라인은 처리되지 않습니다.

    버전처리량(2초 기준)
    버전 1.3.6 이하약 60라인
    버전 1.3.7 이상약 100라인

    다음 옵션으로 2초당 초과량을 조절할 수 있습니다.

    • Linux: /usr/whatap/infra/conf/whatap.conf 파일에 log.skip.threshold=2초당 처리 가능 라인 수

    • Windows: C:\Program Files\WhatapInfra\whatap.conf 파일에 log.skip.threshold=2초당 처리 가능 라인 수

    파일 감시
    노트

    Linux / Windows 환경에서 Agent 버전 2.9.4 이상부터 지원됩니다.

    Unix 환경은 지원되지 않습니다.

    표 | 파일 감시
    항목설명
    파일 경로(필수)감시할 파일의 경로를 입력합니다.
    – 파일 이름에 날짜/시간 패턴을 사용할 수 있습니다.
    – 예: /var/log/mylogfile_%Y-%m-%d_%H:%M:%S.log
    감시 항목변경할 파일 항목을 선택합니다.
    유저 변경 감시: 파일의 소유자(유저) 변경 시 알림 발생 (Windows OS 미지원)
    그룹 변경 감시: 파일의 그룹 변경 시 알림 발생 (Windows OS 미지원)
    퍼미션 변경 감시: 파일 권한 변경 시 알림 발생 (Windows OS 미지원)
    파일 삭제 감시: 파일이 삭제되면 알림 발생
    파일 수정 시간 감시: 파일의 마지막 수정 시간이 변경되면 알림 발생
    위험도조건 충족 시 발생할 알림의 수준입니다.
    위험: Critical 알림 발생
    경고: Warning 알림 발생
  6. +로그 이벤트 조건 추가를 클릭해 로그 이벤트 조건을 추가할 수 있습니다.

  7. +추가를 클릭해 이벤트 동작 시간을 설정하세요.

    이벤트가 특정 시간대(근무/비근무/점검 시간 등)에 동작하도록 태그를 설정하세요. 태그를 설정하지 않으면 이벤트가 활성화된 상태에서 24시간 상시 동작합니다.

    a. 이벤트 동작 시간에서 +새로운 태그 생성을 클릭하세요.

    b. 이벤트 동작 시간 태그 생성에서 태그 이름, 요일, 시간, 색상을 선택하고 [ 적용 ] 버튼을 클릭하세요.

    c. 생성한 태그는 태그 목록에서 확인할 수 있으며, 체크 박스를 선택하면 적용됩니다.

    d. 수정 또는 삭제할 태그의 수정 아이콘 아이콘을 클릭해 이벤트 동작 시간 태그 수정에서 태그를 수정하거나 태그 삭제할 수 있습니다.

    주의

    태그 삭제 시 해당 태그가 적용된 모든 사용자의 태그가 제거됩니다. 단, 이벤트 규칙에서 사용 중인 태그는 삭제할 수 없습니다.

  8. 이벤트 수신 태그에서 [ + 태그 추가 ] 버튼을 클릭하세요. 이벤트 수신 태그의 태그 목록에서 경고 알림 수신 대상을 선택하세요. + 새 태그 생성을 선택해 태그를 추가할 수도 있습니다.

    • 이벤트 설정 시 이벤트 수신 태그를 선택하여 해당 태그를 가진 프로젝트 멤버와 3rd-party 플러그인에 알림을 전송할 수 있습니다. 이벤트 수신 설정 메뉴에서 프로젝트 멤버와 3rd-party 플러그인에 각각 태그를 지정할 수 있습니다.
  9. 로그 이벤트 설정이 완료되었다면 [ 저장 ] 버튼을 클릭하세요.

이벤트 수정

  1. 알림 아이콘 경고 알림 > 이벤트 설정 > 파일 키워드 감시 / 윈도우 이벤트 감시 / 파일 감시 탭으로 이동하세요.

  2. 수정할 이벤트의 수정 아이콘 아이콘을 클릭하세요.

  3. 이벤트 규칙 추가 창에서 이벤트를 수정하세요.

  4. [ 저장 ] 버튼을 클릭하세요.

    • 수정 후 조건에 맞는 데이터가 유입되면 새로운 알림이 발생합니다.

이벤트 삭제

  1. 알림 아이콘 경고 알림 > 이벤트 설정 > 파일 키워드 감시 / 윈도우 이벤트 감시 / 파일 감시 탭으로 이동하세요.

  2. 삭제할 이벤트의 수정 아이콘 아이콘을 클릭하세요.

  3. 이벤트 규칙 추가 창에서 오른쪽 위의 [ 삭제 ] 버튼을 클릭하세요.

이벤트 복사

알림 정책을 선택한 프로젝트에 복사합니다.

  1. 알림 아이콘 경고 알림 > 이벤트 설정 > 파일 키워드 감시 / 윈도우 이벤트 감시 / 파일 감시 탭으로 이동하세요.

  2. 복사할 이벤트의 copy Icon 아이콘을 클릭하세요.

  3. 이벤트 설정 복사 창이 나타나면 프로젝트를 선택하거나 현재 프로젝트에 복사를 선택하세요.

  4. 이벤트 설정을 복사할 프로젝트를 지정했다면 [ 복사 ] 버튼을 클릭하세요.

    • 동일 프로젝트 내 이벤트 중복 복사 시 복사 횟수만큼 이벤트가 생성됩니다.

    • 복사한 이벤트명은 접미사 (copy) 표기가 추가됩니다.

    • 예: 기존 이벤트명 Default → 복사 이벤트명 Default(copy)