本文へスキップ

복합 메트릭스

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

홈 > 프로젝트 선택 > 알림 아이콘 アラート通知 > イベント設定 > 複合指標 탭

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

기본 옵션​

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

권한

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

표 | 복합 메트릭스 이벤트 목록 구성
항목설명
이벤트 제목사용자가 지정한 이벤트명
- 최대 255byte까지 입력 가능
조건이벤트 발생 조건
이벤트 상태가 해소되면 추가 알림Critical과 Warning 레벨의 이벤트가 해소되면 RECOVERED(정상) 상태의 알림 수신 여부
– 활성화: 진행 중 → 정상 상태로 전환되면 RECOVERED 알림을 보내고, 이벤트 기록에서 진행 중/해소 상태를 구분해 볼 수 있음
– 비활성화: 임곗값을 초과할 때마다 단발성 이벤트 발생
이벤트 수신 태그해당 이벤트 알림을 받을 사용자 또는 그룹(수신 태그)
수정 아이콘이벤트 수정 및 삭제
토글 비활성화 아이콘이벤트의 활성화 여부
– 활성화: 조건을 충족하면 이벤트 발생
– 비활성화: 이벤트가 동작하지 않으며, 조건을 검사하지 않음

이벤트 설정​

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

이벤트 추가​

  1. 알림 아이콘 アラート通知 > イベント設定에서 複合指標 탭을 클릭하세요.

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

  3. 複合指標 창에서 차트로 생성하기를 클릭하세요.

    a. 제공하는 템플릿을 활용할 수 있습니다.

  4. イベント設定 화면에서 먼저 이벤트 데이터를 조회하고, 이벤트 조건을 설정하세요.

이벤트 데이터 조회​

이벤트 데이터를 조회하여 차트를 구성합니다. イベント設定 화면의 오른쪽 イベントデータ照会의 위젯 또는 텍스트 옵션을 선택해 이벤트를 설정하세요.

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

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

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

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

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

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

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

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

알림​

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

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

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

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

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

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

    Message example

Tips

변수 사용 규칙

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

이벤트 발행 조건​

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

    • 조회 가능 범위: 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. 이벤트 수신 태그 창에서 태그 목록에서 원하는 태그를 선택하면 적용됩니다.

    Tips

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

이벤트 규칙 테스트​

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

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

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

이벤트 수정/삭제​

  1. アラート通知 > 通知設定의 複合指標 탭으로 이동하세요.

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

  3. 通知設定 화면에서 옵션을 수정하고, [ 저장 ] 버튼을 클릭하세요.

    a. 선택한 이벤트를 삭제하려면 通知設定 화면의 오른쪽 위의 [ 삭제 ] 버튼을 클릭하세요.

이벤트 공유​

메트릭스 이벤트 설정을 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 문법 가이드를 참고하시기 바랍니다.

最終修正：