알람 규칙

알람 규칙은 알람이 생성·갱신·해제되는 시점을 정합니다. 규칙마다 감시할 데이터 소스, 알람을 발생시키거나 해제하는 조건, 심각도 수준, 엔티티 계층으로 알람을 전파하는 방식을 지정합니다.

규칙은 HMI 장치, 자산, 그 프로필, 고객 수준에서 정의할 수 있습니다. 알람 개념, 상태, 심각도 수준의 개요는 알람을 참고하세요.

메시지(텔레메트리 갱신, 속성 변경, 비활성 이벤트)가 들어오면 MX On Cloud는 인자가 들어온 데이터와 맞는 모든 알람 규칙을 평가합니다.

테넌트 관리자는 Alarm rules 페이지에서 개별 엔티티와 프로필의 알람 규칙을 한곳에서 관리합니다.

1. 왼쪽 메뉴에서 알람을 엽니다.
2. Alarm rules 탭으로 이동합니다.
3. 오른쪽 위의 + 버튼을 클릭합니다.
4. 드롭다운 메뉴에서 Create new alarm rule을 선택합니다.

일반 영역에서 알람 규칙의 기본 정보를 정합니다.

• Alarm type: 알람의 이름이자 고유 식별자입니다(예: High Temperature). MX On Cloud는 알람 유형을 보고 새 알람을 만들지, 기존 활성 알람을 갱신할지 판단합니다.
• 개체 유형: 규칙을 적용할 대상 엔티티나 엔티티 프로필입니다.

디버그 모드를 켜면 규칙이 실행되는 동안의 이벤트, 상태, 오류를 추적할 수 있습니다.

알람 조건을 정의하기 전에, 규칙이 평가할 데이터 소스인 인자를 하나 이상 추가합니다.

인자 추가를 클릭하고 다음을 설정합니다.

개체 유형은 인자 값을 가져올 곳을 정합니다.

인자 유형은 인자가 나타내는 데이터 종류를 정합니다.

인자 이름은 조건과 수식에서 쓰는 식별자입니다(예: temperature, maxThreshold).

모든 필드를 채운 뒤 추가를 클릭합니다.

발생 조건은 알람이 생성되는 시점과 심각도를 정합니다. Add trigger condition을 클릭합니다.

이 발생 조건의 심각도 수준을 고릅니다. 수준별 설명은 알람 심각도를 참고하세요.

기존 알람이 활성인 상태에서 더 높은 심각도의 발생 조건이 충족되면, MX On Cloud는 새 알람을 만들지 않고 기존 알람의 심각도를 올립니다.

조건은 알람을 생성하거나 갱신할지 정하는 논리식입니다.

Add condition을 클릭한 다음 Add argument filter를 클릭하고 다음을 설정합니다.

• Argument: 비교할 변수입니다(예: temperature).
• Value type: 데이터 형식입니다. Numeric, Boolean, String 등.
• Filters: 비교를 하나 이상 지정합니다. 필터마다 다음을 설정합니다.
  • Operation: equal(같음), not equal(같이 않음), greater than(큼), less than(작음), missing for 등.
  • Value source: 고정 값이면 Static, 다른 인자의 값을 쓰려면 Dynamic.
  • Value: 비교할 값입니다.

필터가 여럿이면 AND(모두 참이어야 함)나 OR(하나 이상 참이어야 함)로 묶습니다.

조건은 직접 작성하거나, 복잡한 식이면 TBEL 스크립트 함수로 작성할 수 있습니다.

일정은 발생 조건이 동작할 수 있는 시간을 정합니다. 허용된 시간 밖에서 조건이 참이 되면 알람이 만들어지지 않습니다.

Static 일정에는 세 가지 모드가 있습니다.

Dynamic 일정에서는 정적 설정 대신 속성이나 텔레메트리로 일정 JSON 객체를 줄 수 있습니다. HMI 장치나 고객마다 일정이 다를 때 유용합니다. 동적 모드를 쓰려면 Schedule로 가서 Dynamic을 고르고, 일정 JSON이 든 인자를 선택합니다.

일정 JSON 예시:

항상 동작:

{ "type": "ANY_TIME" }

화요일과 목요일 하루 종일, Europe/Kiev 시간대:

{
  "type": "SPECIFIC_TIME",
  "daysOfWeek": [2, 4],
  "startsOn": 0,
  "endsOn": 0,
  "timezone": "Europe/Kiev"
}

사용자 지정 일정, 매일 24시간:

{
  "type": "CUSTOM",
  "timezone": "Europe/Kiev",
  "items": [
    { "dayOfWeek": 1, "enabled": true, "startsOn": 0, "endsOn": 0 },
    { "dayOfWeek": 2, "enabled": true, "startsOn": 0, "endsOn": 0 },
    { "dayOfWeek": 3, "enabled": true, "startsOn": 0, "endsOn": 0 },
    { "dayOfWeek": 4, "enabled": true, "startsOn": 0, "endsOn": 0 },
    { "dayOfWeek": 5, "enabled": true, "startsOn": 0, "endsOn": 0 },
    { "dayOfWeek": 6, "enabled": true, "startsOn": 0, "endsOn": 0 },
    { "dayOfWeek": 7, "enabled": true, "startsOn": 0, "endsOn": 0 }
  ]
}

필드 설명:

• timezone: 일정을 해석할 시간대.
• daysOfWeek: 숫자로 쓴 요일(1 = 월요일, 7 = 일요일).
• startsOn / endsOn: 하루 시작부터의 밀리초. 둘 다 0이면 하루 종일입니다.

해제 조건은 MX On Cloud가 알람을 자동으로 해제 상태로 바꾸는 시점을 정합니다.

해제 조건이 없으면 알람은 자동으로 해제되지 않으며, UI나 API로 직접 해제해야 합니다.

Add clear condition을 클릭하고 다음을 설정합니다.

• Condition: 알람이 해결되는 시점을 정하는 식입니다(예: temperature ≤ 30). 발생 조건과 같은 필터·인자 설정을 씁니다.
• Condition type: Simple, Duration, Repeating 중 하나. 동작은 조건 유형을 참고하세요.
• Schedule: 해제 조건이 동작할 수 있는 시간입니다. 허용된 시간 밖에서 조건이 충족되면 알람이 해제되지 않습니다.
• Additional info: 해제되는 순간 알람 상세에 저장되는 추가 데이터입니다. ${attributeName} 자리 표시자를 지원합니다.
• Mobile dashboard: 모바일 앱에서 해제된 알람을 볼 때 열리는 대시보드입니다.

Additional info 필드는 알람과 함께 추가 맥락 데이터를 저장하며, 이 데이터는 알람 상세 보기에 표시됩니다. ${attributeName}으로 동적 자리 표시자를 쓸 수 있습니다.

운영자 메모, 문제 해결 절차, 문서 링크, 구역 ID 같은 데이터에 씁니다.

Mobile dashboard 필드는 사용자가 알람으로 이동할 때 MX On Cloud 모바일 앱에서 열릴 대시보드를 지정합니다. 현장 엔지니어가 관련 위젯과 진단 정보를 바로 볼 수 있습니다.

전파는 엔티티 계층의 어느 수준까지 알람이 보이는지 정합니다. 개념은 알람 전파를 참고하세요.

Propagate alarm to related entities: 관계 유형과 상관없이 발생 엔티티와 관계가 있는 모든 엔티티에서 알람이 보입니다. HMI 장치 → Office → Building 사슬이면 세 엔티티 모두에서 알람이 보입니다.

Propagate alarm to entity owner (Customer or Tenant): 명시적인 관계가 없어도 발생 엔티티의 직접 소유자에게 알람이 보입니다.

Propagate alarm to Tenant: 소유나 관계와 상관없이 테넌트 수준에서 알람이 보입니다. 테넌트 관리자가 인프라 전체의 알람을 봐야 할 때 씁니다.

알람 규칙은 알람 → Alarm rules 페이지의 표에 나옵니다. 표에는 알람 유형, 대상 엔티티, 심각도 수준, 해제 조건 설정 여부가 나옵니다.

규칙 행마다 작업 버튼이 있습니다.

규칙 행을 클릭하면 전체 상세 정보가 보입니다. 규칙을 편집하려면 상세 패널에서 편집 모드 전환(연필)을 클릭하고, 바꾼 뒤 변경사항 적용(체크 표시)을 클릭해 저장합니다.

규칙을 내보내려면 알람 → Alarm rules로 가서 규칙 행의 내보내기(다운로드 아이콘)를 클릭합니다.

규칙을 가져오려면 다음과 같이 합니다.

1. 알람 → Alarm rules로 이동합니다.
2. + 버튼을 클릭하고 Import alarm rule을 선택합니다.
3. JSON 파일을 가져오기 대화상자에 끌어 놓거나 직접 선택합니다.
4. 가져오기를 클릭합니다.
5. 규칙을 적용할 엔티티나 프로필을 지정합니다.
6. 추가를 클릭합니다.

저장하면 규칙이 바로 동작합니다.

다음 튜토리얼은 기본 임계값부터 동적 일정까지 자주 쓰는 알람 규칙 설정을 차례로 보여 줍니다. 모든 예시가 Thermometer HMI 장치를 쓰며 앞 예시에 이어서 진행합니다.

단계별 전체 안내는 알람 규칙 튜토리얼을 참고하세요.