알람

알람은 감시하는 조건이 충족되면 생성됩니다. 예를 들어 온도가 임계값을 넘거나 장치가 오프라인이 될 때입니다. MX On Cloud는 알람 규칙에 정의한 로직에 따라 알람을 자동으로 생성·갱신·해제합니다. 알람마다 발생 엔티티, 심각도, 수명 주기 상태를 추적하므로 운영자가 문제를 효율적으로 분류할 수 있습니다.

알람이 생성되거나 해제되면 알림 센터가 MX On Cloud 인스턴스에 설정된 전송 방식으로 알림을 보낼 수 있습니다.

알람에는 모두 다음 필드가 있습니다.

필드	설명
만든 사람	알람을 발생시킨 엔티티입니다. HMI 장치, 자산 등 지원되는 엔티티 유형입니다.
유형	알람 종류를 나타내는 문자열입니다(예: High Temperature). 발생 엔티티와 함께 고유성을 보장하는 데 쓰입니다.
심각도	조건이 얼마나 심각한지 나타내는 다섯 가지 수준 중 하나입니다. 알람 심각도를 참고하세요.
상태	현재 수명 주기 상태입니다. 활성 또는 해제, 확인 또는 미확인입니다. 알람 상태를 참고하세요.
시작 시각	알람 조건이 처음 감지된 시각입니다. 서버 처리 시각이 아니라 텔레메트리의 타임스탬프를 따릅니다. 예를 들어 센서가 12:05에 105 °F를 보고했지만 플랫폼이 12:08에 메시지를 처리했다면 시작 시각은 12:05입니다.
마지막 시각	알람 조건과 일치한 가장 최근 이벤트의 시각입니다. 알람이 활성이고 조건이 계속 충족되는 동안 계속 갱신됩니다.
담당자	알람을 조사하고 해결할 책임이 있는 사용자입니다. 담당자를 참고하세요.

알람은 발생 엔티티 + 유형 조합으로 구별됩니다. MX On Cloud는 조합마다 활성 알람을 한 번에 하나만 둡니다. 새 이벤트가 기존 활성 알람과 발생 엔티티·유형이 같으면, 플랫폼은 중복 알람을 만들지 않고 기존 알람을 갱신합니다(예: 심각도 상승). 발생 엔티티와 유형이 같은 새 알람은 이전 알람이 해제된 뒤에만 만들어집니다.

알람에는 서로 독립된 두 축, 활성/해제와 확인/미확인이 있어 상태가 네 가지 나옵니다.

상태	설명
활성, 미확인	조건이 활성이고 아무도 알람을 확인하지 않았습니다.
활성, 확인	조건이 활성이고 사용자가 알람을 확인했습니다.
해제, 미확인	조건은 더 이상 활성이 아니지만 알람은 확인되지 않았습니다.
해제, 확인	조건이 더 이상 활성이 아니고 알람도 확인되었습니다.

심각도는 알람 조건이 얼마나 심각한지 나타내며, 대응 우선순위를 정하는 데 도움을 줍니다.

수준	의미
심각한	장비 고장, 안전 위험, 데이터 손실 가능성처럼 즉시 조치가 필요합니다.
주요한	운영에 영향을 주지만 당장 치명적이지는 않은 중대한 문제입니다.
작은	나중에 살펴보거나 처리해도 되는 덜 심각한 상태입니다.
경고	아직 정상 운영에 영향을 주지 않는 잠재적 문제입니다.
중간	데이터가 불완전하거나 모호해 심각도를 정할 수 없는 경우입니다.

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

기본적으로 알람은 알람을 발생시킨 엔티티에서만 보입니다. 전파는 이 범위를 엔티티 계층 위쪽으로 넓힙니다. 예를 들어 HMI 장치의 알람을 그 장치가 속한 Building 자산에서도 보이게 합니다.

전파는 알람 규칙마다 설정합니다. 사용할 수 있는 전파 옵션은 알람 규칙 페이지를 참고하세요.

알람을 조사하고 해결할 책임자로 특정 사용자를 지정할 수 있습니다. 담당자는 알람 페이지, 알람 위젯, 엔티티의 알람 탭에 표시됩니다.

알람을 할당하려면 알람 행의 담당자 드롭다운을 클릭하고 사용자를 고릅니다.

알람마다 사용자와 시스템이 댓글을 남기는 활동 영역이 있습니다.

• 사용자 댓글: 접근 권한이 있는 사용자가 직접 남깁니다. 작성자가 편집하고 삭제할 수 있습니다.
• 시스템 댓글: 심각도 상승, 확인, 할당, 해제처럼 알람 상태가 바뀔 때 자동으로 만들어집니다. 읽기 전용 시스템 활동으로 표시됩니다.

상세 내역 작업으로 알람 상세 대화상자를 열어 알람 댓글을 보고 관리합니다.

왼쪽 메뉴에서 알람으로 이동하면 계정에서 볼 수 있는 모든 알람이 나옵니다. 표에는 생성 일시, 만든 사람, 유형, 심각도, 담당자, 상태가 나옵니다. 필터 툴바로 상태와 기간을 좁힙니다.

알람 행의 상세 내역 작업을 클릭하면 알람 상세 대화상자가 열리고, 알람 전체 기록, 담당자, 활동을 볼 수 있습니다.

특정 엔티티의 알람을 보려면 다음과 같이 합니다.

1. 엔티티 목록으로 이동합니다(예: 개체 > 장치).
2. 엔티티 이름을 클릭해 상세 정보를 엽니다.
3. 알람 탭을 선택합니다.

• 확인: 알람을 본 것으로 표시합니다. 확인한 시각과 확인한 사용자를 기록합니다. 알람 조건은 여전히 활성일 수 있습니다.
• 지우기: 알람 조건이 해결된 것으로 표시합니다. 해제한 시각을 기록합니다.

알람 페이지에서 알람을 확인하거나 해제하려면 행을 하나 이상 선택하고 표 작업 표시줄에서 확인이나 지우기를 클릭합니다. 알람 상세를 열고, 현재 상태에서 할 수 있는 경우 확인이나 지우기 버튼을 써도 됩니다.

REST API로 알람을 만들고, 조회하고, 확인하고, 해제하고, 삭제할 수 있습니다. X-Authorization 헤더에 JWT 토큰을 넣어 인증합니다. 주요 엔드포인트로는 발생 엔티티별 알람 검색, 상태 필터, 일괄 작업이 있습니다.

대시보드에 Alarm widgets 번들의 위젯으로 알람을 표시합니다.

• Alarms table: 선택한 엔티티의 알람을 상태, 심각도, 기간으로 걸러 나열합니다.
• Alarms count: 설정한 필터에 맞는 알람 수를 보여 줍니다.

기능	설명	안내
알람 조건 정의	텔레메트리 임계값, 비활성, 반복 이벤트를 기준으로 알람을 발생시키는 규칙을 만듭니다	알람 규칙
알림 보내기	알람이 생성·갱신·해제될 때 설정한 알림 전송 방식으로 알림을 보냅니다	알림
대시보드에서 시각화	대시보드에 알람 표와 알람 수를 추가합니다	대시보드
REST API로 관리	프로그램으로 알람을 만들고, 조회하고, 확인하고, 해제하고, 삭제합니다	REST API