본문으로 건너뛰기

복합 메트릭스

홈 > 프로젝트 선택 > 알림 아이콘 경고 알림 > 이벤트 설정 > 복합 메트릭스 탭

복잡한 규칙을 활용해 이벤트를 생성하고 경고 알림을 보낼 수 있습니다.

기본 옵션​

  • 검색: 이벤트 이름 또는 이벤트 수신 태그를 선택해 원하는 이벤트 검색
  • JSON 다운로드/업로드: 이벤트 규칙은 JSON 편집기를 통해 바로 수정하거나, 파일로 다운로드하여 수정 후 다시 업로드 가능
  • 알림 메시지 설정: 수신할 메시지의 상세 항목 선택 및 항목 별 내용 편집
  • +이벤트 추가: 새로운 복합 메트릭스 이벤트 추가
노트

권한

복합 메트릭스 이벤트를 설정하려면 알림 설정 권한이 있어야 합니다. 알림 설정 권한은 홈 > 프로젝트 선택 > 관리  > 통합 멤버 관리에서 권한을 부여할 멤버의 수정 아이콘 아이콘을 클릭해 설정할 수 있습니다.

복합 메트릭스 이벤트 목록은 이벤트 이름 순으로 정렬해 표시하며, 목록 아래 페이지 이동 버튼으로 다음 목록을 확인할 수 있습니다. 한 페이지에 표시할 이벤트 수도 선택할 수 있습니다.

표 | 복합 메트릭스 이벤트 목록 구성
항목설명
No.이벤트의 순번
활성화이벤트의 활성화 여부
- 활성화: 조건을 충족하면 이벤트 발생
- 비활성화: 이벤트가 동작하지 않으며, 조건을 검사하지 않음
수정이벤트 수정 창을 열어 이벤트 설정 편집 및 삭제
이벤트 이름사용자가 지정한 이벤트명
- 최대 255byte까지 입력 가능
규칙이벤트 발생 조건
일시 중지이벤트 알림 발생 후 같은 이벤트 발생을 멈추는 시간
해소된 알림Critical과 Warning 레벨의 이벤트가 해소되면 RECOVERED(정상) 상태의 알림 수신 여부
- 사용: 진행 중 → 정상 상태로 전환되면 RECOVERED 알림을 보내고, 이벤트 기록에서 진행 중/해소 상태를 구분해 볼 수 있음
- 사용 안함: 임곗값을 초과할 때마다 단발성 이벤트 발생
이벤트 수신해당 이벤트 알림을 받을 사용자 또는 그룹(수신 태그)
- 태그를 지정하지 않으면 전체 수신
노트

알림 설정 권한이 없으면 활성화 스위치, 수정 버튼, 이벤트 추가 버튼을 사용할 수 없습니다.

이벤트 설정​

복합 메트릭스 이벤트는 메트릭스 데이터 질의 언어인 MXQL을 기반으로 이벤트 조건을 생성합니다. 차트로 생성하기 기능은 MXQL의 자동완성을 위한 콤보박스 기능을 제공합니다.

이벤트 추가​

  1. 알림 아이콘 경고 알림 > 이벤트 설정에서 복합 메트릭스 탭을 클릭하세요.

  2. 화면 오른쪽 위의 이벤트 추가 버튼을 클릭하세요.

  3. 이벤트 생성 화면 왼쪽의 템플릿 목록에서 시작할 항목을 선택하세요.

    • 새로 만들기: 템플릿 없이 처음부터 이벤트를 만듭니다.

    • 공통: 와탭이 미리 정의한 복합 메트릭스 이벤트 템플릿입니다.

    • OpenMetrics 서비스별 그룹: 와탭이 제공하는 OpenMetrics 템플릿을 서비스별로 묶어 표시합니다. 그룹 이름 옆에 OpenMetrics 표시가 붙습니다. 프로젝트 플랫폼과 관계없이 모든 프로젝트에서 볼 수 있습니다.

    • 그룹은 처음에 모두 접혀 있습니다. 그룹 이름을 클릭해 펼치거나, 목록 위 검색 필드에 템플릿 이름이나 그룹 이름을 입력해 찾으세요.

    • 각 템플릿 항목에는 템플릿 이름, 이벤트 레벨, 설명이 함께 표시됩니다.

  4. 오른쪽 설정 영역에서 먼저 이벤트 데이터를 조회하고, 이벤트 조건을 설정하세요. 템플릿을 선택했다면 템플릿의 쿼리와 조건이 미리 채워져 있습니다.

이벤트 데이터 조회​

이벤트 데이터를 조회하여 차트를 구성합니다. 이벤트 설정 화면의 오른쪽 이벤트 데이터 조회의 위젯 또는 텍스트 옵션을 선택해 이벤트를 설정하세요.

시계열 차트를 구성하는 옵션을 통해 이벤트 설정 시 사용할 MXQL을 자동 완성할 수 있습니다.

  1. 데이터를 조회할 날짜를 선택하세요.

  2. 데이터를 조회할 카테고리(대상)를 선택하세요.

  3. 필터 항목의 + 필터 추가를 클릭해 이벤트 조건을 생성하세요.

    a. 필터 창에서 연산식, 태그, 필터 값을 선택하세요.
    b. + 추가를 클릭해 조건을 추가할 수 있습니다.
    c. 조건을 삭제하고 싶다면 조건 옆의 – 를 클릭하세요.

  4. 그룹화 항목에서 그룹화된 메트릭스 데이터를 선택하세요. 다중 선택할 수 있습니다.

  5. 타임 유닛 항목에서 초, 분, 시간 단위로 그룹화된 데이터를 나눌 시간 기준을 설정하세요.

  6. 필드 항목에서 이벤트 발행 조건에 사용할 필드를 선택하세요. 다중 선택할 수 있습니다.

알림​

경고 알림 설정의 기본 정보를 입력합니다.

  • 이벤트 활성화: 토글 버튼을 활성화하면 이벤트가 동작합니다.

  • 레벨: 이벤트 레벨(Critical, Warning, Info)을 선택하세요.

    • 이벤트 상태가 해소되면 추가 알림: 토글 버튼을 활성화하면 이벤트가 해소되어 정상(RECOVERED) 상태의 알림이 전송됩니다.

  • 제목: 이벤트 규칙의 제목을 입력하세요.

  • 메시지: 이벤트 발생 시 전달받을 알림 메시지의 내용을 입력하세요. 메시지에 변수를 사용하여 이벤트 발생 시점의 실제 값을 포함할 수 있습니다.

    Message example

팁

변수 사용 규칙

  • 변수 형식: ${지표명}
  • 설정한 카테고리와 동일한 카테고리 내 지표만 변수로 사용 가능합니다.
  • 여러 변수를 조합해 상세한 메시지를 구성할 수 있습니다.
  • 사용 가능한 변수 목록은 메트릭스 조회에서 확인할 수 있습니다.

이벤트 발행 조건​

  • 데이터 조회 범위: 실시간 데이터 조회 범위를 선택하세요.

    • 조회 가능 범위: 30초, 1분, 2분, 5분, 10분, 30분, 1시간, 2시간, 3시간

  • 조건: 이벤트 발생 조건을 입력하세요. 이벤트 데이터 조회에 포함된 필드만 사용할 수 있습니다.

부가정보​

  • 인터벌: 선택한 시간(1분, 5분, 10분, 30분, 1시간, 12시간) 간격으로 알림 조건을 확인합니다.

  • 무음: 이벤트가 발생한 후, 선택한 시간(unset, 1분, 5분, 10분, 30분, 1시간, 12시간) 동안 같은 이벤트가 발생되지 않습니다.

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

    1. + 추가를 클릭하세요.

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

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

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

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

    주의

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

  • 이벤트 수신 태그: 이벤트에 수신 태그를 설정하면, 해당 태그를 가진 프로젝트 멤버에게 알림을 전송합니다. 수신 태그를 설정하지 않으면 프로젝트 내 모든 사용자에게 알림이 전송됩니다.

    1. + 태그 추가 또는 +를 클릭하세요.

    2. 이벤트 수신 태그 창 아래의 + 새 태그 생성을 클릭하세요.

    3. 태그 생성 창에서 태그 이름을 입력하고 색상을 선택한 후, [ 태그 생성 ] 버튼을 클릭해 태그를 생성하세요.

    4. 생성된 태그는 태그 목록의 수정 아이콘 아이콘을 클릭해 수정 또는 삭제하세요.

    5. 이벤트 수신 태그 창에서 태그 목록에서 원하는 태그를 선택하면 적용됩니다.

    팁

    이벤트 설정 시 이벤트 수신 태그를 선택하여 해당 태그를 가진 프로젝트 멤버와 3rd-party 플러그인에 알림을 전송할 수 있습니다. 경고 알림 > 이벤트 수신 설정에서 프로젝트 멤버와 3rd-party 플러그인에 각각 태그를 지정할 수 있습니다.

이벤트 규칙 테스트​

설정한 조건을 과거 데이터에 기반으로 테스트를 진행해, 몇 건의 이벤트가 발생할지 예측할 수 있습니다.

  1. 이벤트 규칙을 테스트할 날짜를 선택하고 [ 확인 ] 버튼을 클릭하세요.

  2. [ 실행 ] 버튼을 클릭해 이벤트 발생 건수를 확인하세요.

이벤트 수정/삭제​

  1. 경고 알림 > 이벤트 설정의 복합 메트릭스 탭으로 이동하세요.

  2. 복합 메트릭스 목록에서 수정 또는 삭제하려는 이벤트의 수정 컬럼 버튼을 클릭하세요.

  3. 오른쪽에 열린 이벤트 수정 창에서 옵션을 수정하고 저장 버튼을 클릭하세요.

    • 이벤트를 삭제하려면 이벤트 수정 창의 삭제 버튼을 클릭하세요.

    • 변경 사항을 저장하지 않고 닫으려면 취소 버튼을 클릭하세요.

이벤트 공유​

메트릭스 이벤트 설정을 JSON 파일로 저장해 다른 사용자와 설정을 공유하거나 다른 사용자의 설정을 가져올 수 있습니다.

  • JSON 파일명: event-rules-YYYYMMDD.json

내보내기

  1. 화면 오른쪽 위에 [ JSON 내보내기 아이콘 ] 버튼을 클릭하세요.
  2. JSON 편집 창이 나타나면 [ 내보내기 아이콘 내보내기 ] 버튼을 클릭하세요.
    • 이벤트를 검색 후 내보내기 기능을 이용하면 검색한 목록만 JSON 파일로 다운받을 수 있습니다.
  3. JSON 파일이 다운로드되면 공유할 다른 사용자에게 전달하세요.

가져오기

  1. 화면 오른쪽 위에 [ 가져오기 아이콘 ] 버튼을 클릭하세요.
  2. 내보내기 기능을 통해 다운로드한 JSON 파일을 선택하세요.
  3. JSON 편집 창이 나타나면 [ 목록에 추가하기 ] 또는 [ 덮어쓰기 ] 버튼을 클릭하세요.
주의

같은 종류의 제품 간에 이용할 것을 권장합니다. 다른 제품의 프로젝트로부터 이벤트 설정을 가져올 수는 있지만 정상 작동하지 않습니다.

Json 형식으로 수정하기​

  1. 화면 오른쪽 위에 [ JSON 내보내기 아이콘 ] 버튼을 클릭하세요.

  2. 편집 창이 나타나면 JSON 형식에 맞춰 내용을 수정하세요.

  3. 수정을 완료하면 화면 아래 [ 저장 ] 버튼을 클릭하세요.

노트

수정한 내용이 JSON 형식에 맞지 않으면 화면 아래에 에러 메시지가 표시되며, 저장할 수 없습니다. 표시되는 에러 메시지는 형식에 따라 다를 수 있습니다.

JSON error

알림 메시지 설정​

수신할 메시지의 상세 항목을 선택하고, 항목별 내용을 편집할 수 있습니다.

부록​

MXQL 문법 가이드​

복합 메트릭스는 MXQL 쿼리를 기반으로 동작합니다. 자세한 문법은 MXQL 문법 가이드를 참고하세요.

최종 수정: