Skip to main content

로그 알림 설정하기

Not translated
This page is currently being translated. We will complete the translation as soon as possible.

홈 화면 > 프로젝트 선택 > Alert > Event Configuration > Log 탭

수집한 로그 데이터를 조건에 맞춰 필터링해 경고 알림을 설정할 수 있습니다. + Add Alert Policy 버튼을 선택해 로그 이벤트 경고 알림을 설정하세요. 모든 설정을 완료한 다음 Save 버튼을 선택하세요.

로그 알림 설정

추가할 수 있는 로그 이벤트 다음과 같습니다.

  • Real-time log event: 실시간으로 수집한 로그에서 검색 값이 등장하면 경고 알림을 보냅니다.

  • Composite log event: 최근에 수집한 로그 중 일정 조건을 만족하는 로그가 일정 개수 이상 수집한 경우에 경고 알림을 보냅니다.

Note

  • 이벤트를 추가하거나 설정하려면 Alert settings 권한이 있어야합니다. 사용자별 권한에 대한 자세한 내용은 다음 문서를 참조하세요.

  • 경고 알림과 관련해 모니터링 플랫폼별 지원되는 이벤트 종류를 확인하려면 다음 문서를 참조하세요.

이벤트 추가 공통 옵션​

다음은 이벤트 추가 시 공통으로 설정할 수 있는 옵션입니다.

  • Event title: 추가하려는 이벤트 이름을 입력하세요.

  • Activate events: 토글 버튼을 클릭해 경고 알림 활성화 여부를 선택할 수 있습니다.

  • Level: Fatal, Warning, Info 중 하나의 레벨을 선택하세요.

  • Message: 이벤트 발생 시 출력하는 알림 메시지를 입력합니다. ${Tag} 또는 ${Field} 입력으로 메시지에 변수를 적용할 수 있습니다. 변수에 입력할 키는 선택한 메트릭스 데이터 Category에 포함된 값이여야 합니다.

  • Category: 로그 구분 명칭(로그 폴더명)을 목록에서 선택하거나 직접 입력할 수 있습니다.

  • Skip time: 과도한 경고 알림 발생을 방지할 수 있는 옵션입니다. 첫 번째 경고 알림 이후 선택한 시간 동안 경고 알림을 보내지 않습니다. 또한 Event History 메뉴에 기록되지 않습니다.

  • Event reception tag: 이벤트 수신 태그를 선택하면 해당 태그를 가진 프로젝트 멤버와 3rd-party 플러그인에 알림을 전송할 수 있습니다. 이벤트 수신 태그를 선택하지 않으면 프로젝트 전체 멤버에게 경고 알림을 보냅니다.

    태그를 추가하지 않으면 전체 멤버에게 경고 알림을 보냅니다. + Add tag를 클릭한 다음 Tag list에서 경고 알림 수신 대상을 선택하세요. + Create new tag을 선택해 태그를 추가할 수도 있습니다.

    Note

    Alert > Notifications 메뉴에서 프로젝트 멤버와 3rd-party 플러그인에 태그를 설정할 수 있습니다. Notifications 메뉴에 대한 자세한 내용은 다음 문서를 참조하세요.

실시간 로그 이벤트 추가​

실시간 로그 이벤트 추가 sc

  • Search key: 로그 데이터 내에서 특정 값에 접근하기 위한 식별자를 의미합니다. 목록에서 선택하거나 직접 입력할 수 있습니다.

    예시, HTTP 응답 상태 코드를 나타내는 값에 접근하고자 할 경우 Search key status

  • Search value: Search key에 해당하는 실제 데이터를 의미합니다. 로그에서 입력한 단어를 포함할 경우 경고 알림을 보냅니다. 목록에서 선택하거나 직접 입력할 수 있습니다.

    예시, Search key status Search value 200을 설정한 경우 HTTP 응답 상태 코드 200을 포함하는 로그 데이터 수집 시 경고 알림 발생

  • Filtering event targets: Selector 옵션을 통해 Search key와 Operator, Search value을 선택해 대상을 필터링하거나 Typing 옵션을 선택할 수 있습니다. 입력값이 없을 경우 실시간으로 수집하는 데이터 전체에 대한 알림 발생 여부를 판단합니다.

    예시, AppLog 카테고리의 로그 중 level이 ERROR인 로그를 찾습니다. 일치하는 로그 중에서 oid가 12345678인 경우 경고 알림을 보냅니다.

복합 로그 이벤트 추가​

복합 로그 이벤트 추가 sc

  • Templates: 복합 로그 템플릿을 제공합니다.

  • Time Range: 선택한 시간동안 수집한 로그를 조회합니다. 데이터 조회 시간을 5분으로 선택하면 최근 5분 동안 수집한 데이터를 조회해서 이벤트 발생 조건을 확인합니다.

  • Log search condition

    • Search key에서 이벤트 발생 조건 대상을 선택할 수 있습니다. 선택한 Search key에 해당하는 검색 값을 선택할 수 있습니다.

    • Search key에서 동일한 항목을 추가할 경우 'OR' 조건으로, 다른 항목을 추가할 경우 'AND' 조건으로 동작합니다.

    • Exclude 체크 박스를 선택해 선택한 검색 값을 이벤트 발행 조건에서 제외할 수 있습니다.

    • + Add를 선택해 여러개의 이벤트 발행 조건을 추가 또는 제외 설정할 수 있습니다.

  • Event rule condition: 이벤트가 입력한 횟수와 선택한 연산자의 조건과 같이 발생할 때 경고 알림을 보냅니다.

    예시, AppLog 카테고리의 로그 중 조건 입력에 해당하는 로그를 필터링 합니다. 조건 입력에서 Exclude를 체크한 경우 해당 조건으로 찾은 로그를 제외하겠다는 의미입니다. 따라서 level이 ERROR인 로그는 제외합니다. 최근 10분 동안 수집한 로그 중 이벤트가 5보다 작을 경우 경고 알림을 보냅니다.

로그 이벤트 설정 수정하기​

  1. Alert > Event Configuration 메뉴로 이동하세요.

  2. Log 탭을 선택하세요.

  3. 로그 이벤트 목록 중 수정하려는 이벤트 항목에서 오른쪽에 편집 아이콘 버튼을 선택하세요.

  4. Event configuration 창이 나타나면 옵션을 수정한 다음 Save 버튼을 선택하세요.

선택한 로그 이벤트를 삭제하려면 이벤트 설정 창에서 오른쪽 위에 Delete 버튼을 선택하세요.

로그 이벤트 끄기​

  1. Alert > Event Configuration 메뉴로 이동하세요.

  2. Log 탭을 선택하세요.

  3. 로그 이벤트 목록 중 경고 알림을 끄려는 이벤트 항목의 가장 오른쪽에 토글 버튼을 선택하세요.

다시 토글 버튼을 선택하면 해당 경고 알림이 활성화됩니다.

로그 이벤트 내보내기/불러오기​

로그 이벤트의 설정 내용을 json 파일로 저장한 다음 불러와 재사용할 수 있습니다.

  1. Alert > Event Configuration 메뉴로 이동하세요.

  2. Log 탭을 선택하세요.

  3. 로그 이벤트 목록 위에 JSON 내보내기 아이콘 버튼을 선택하세요. Export JSON 창이 나타납니다.

  4. 내보내기 할 항목을 수정 또는 편집하세요.

  5. 오른쪽 위에 내보내기 아이콘 Export 버튼을 선택하세요. 브라우저에서 json 파일을 다운로드합니다.

  6. 로그 이벤트 목록 위에 가져오기 아이콘 버튼을 선택하세요.

  7. 파일 선택 창이 나타나면 앞서 다운로드 받은 json 파일을 선택하세요.

  8. Import JSON 창이 나타나면 내용을 수정한 다음 + Add to list 버튼을 선택하세요.

Note

이벤트에 id가 존재합니다. id를 제거한 뒤 다시 시도하세요.

  • 메시지가 나타나면 Import JSON 창에서 id 항목을 삭제한 다음 + Add to list 버튼을 선택하세요.

  • 기존의 이벤트 항목에 덮어쓰기를 하려면 id 항목을 삭제한 다음 Overwrite 버튼을 선택하세요.