Alarms

Alarms are generated when a monitored condition is met, for example, a temperature exceeding a threshold or a device going offline. iRis Cloud creates, updates, and clears alarms automatically based on the logic you define in alarm rules. Each alarm tracks the originator, severity, and lifecycle status so operators can triage issues efficiently.

When an alarm is created or cleared, the Notification Center can deliver alerts through the delivery methods configured for your iRis Cloud instance.

Every alarm contains the following fields:

Field	Description
Originator	The entity that triggered the alarm, such as a HMI Device, Asset, or another supported entity type.
Type	A string identifying the alarm category, such as High Temperature. Used together with the originator to enforce uniqueness.
Severity	One of five levels indicating how critical the condition is. See Alarm severity.
Status	The current lifecycle state: active or cleared, acknowledged or unacknowledged. See Alarm states.
Start time	Timestamp when the alarm condition was first detected. This reflects the telemetry timestamp, not the server processing time. For example, if a sensor reports 105 °F at 12:05 but the platform processes the message at 12:08, the start time is 12:05.
End time	Timestamp of the most recent event that matched the alarm condition. Updated continuously while the alarm remains active and the condition keeps firing.
Assignee	The user responsible for investigating and resolving the alarm. See Assignee.

An alarm is uniquely identified by its originator + type combination. iRis Cloud allows only one active alarm per combination at any time. If a new event matches an existing active alarm’s originator and type, the platform updates the existing alarm, for example by escalating severity, instead of creating a duplicate. A new alarm with the same originator and type can only be created after the previous one is cleared.

An alarm has two independent dimensions, active/cleared and acknowledged/unacknowledged, producing four possible states:

State	Description
Active Unacknowledged	The condition is active and no user has acknowledged the alarm.
Active Acknowledged	The condition is active and a user has acknowledged the alarm.
Cleared Unacknowledged	The condition is no longer active, but the alarm has not been acknowledged.
Cleared Acknowledged	The condition is no longer active and the alarm has been acknowledged.

Severity indicates how critical the alarm condition is and helps prioritize response.

Level	Meaning
Critical	Requires immediate action, such as equipment failure, safety risks, or potential data loss.
Major	Significant issue that affects operation but is not immediately critical.
Minor	A less severe condition to monitor or address later.
Warning	A potential issue that does not yet affect normal operation.
Indeterminate	Severity cannot be determined, often due to incomplete or ambiguous data.

Severity is set per trigger condition in the alarm rule. When an existing alarm is active and a new trigger fires at a higher severity, iRis Cloud upgrades the severity of the existing alarm rather than creating a new one.

By default, an alarm is visible only on the entity that triggered it. Propagation extends that visibility up the entity hierarchy, for example, making an alarm from a HMI Device visible on the Building Asset that contains it.

Propagation is configured per alarm rule. See the Alarm rules page for the available propagation options.

An alarm can be assigned to a specific user who is responsible for investigating and resolving it. The assignee is visible on the Alarms page, in alarm widgets, and on the entity’s Alarms tab.

To assign an alarm, click the Assignee dropdown on the alarm row and select a user.

Each alarm has an Activity section where users and the system can leave comments:

• User comments: added manually by any user with access. Editable and deletable by the author.
• System comments: generated automatically when the alarm state changes, such as severity escalation, acknowledgment, assignment, or clearing. Displayed as read-only system activity.

Open the alarm details dialog from the Details action to view and manage alarm comments.

Go to Alarms in the left-hand menu to see all alarms visible to your account. The table shows creation time, originator, type, severity, assignee, and status. Use the filter toolbar to narrow by status and time range.

Click the Details action in an alarm row to open the Alarm details dialog, which shows the full alarm record, assignee, and activity.

To view alarms for a specific entity:

1. Go to the entity list, such as Entities > Devices.
2. Click the entity name to open its details.
3. Select the Alarms tab.

• Acknowledge: marks the alarm as seen. Records the acknowledgment time and the user who acknowledged it. The alarm condition may still be active.
• Clear: marks the alarm condition as resolved. Records the clear time.

To acknowledge or clear alarms from the Alarms page, select one or more rows and click Acknowledge or Clear in the table action bar. You can also open an alarm’s details and use the Acknowledge or Clear buttons when the current status allows the action.

Alarms can be created, queried, acknowledged, cleared, and deleted via the REST API. Authenticate with a JWT token in the X-Authorization header. Key endpoints include alarm search by originator, status filtering, and bulk operations.

Display alarms on dashboards using widgets from the Alarm widgets bundle:

• Alarms table: lists alarms for selected entities with filtering by status, severity, and time range.
• Alarms count: shows the number of alarms matching configurable filters.

Capability	Description	Guide
Define alarm conditions	Create rules that trigger alarms based on telemetry thresholds, inactivity, or repeated events	Alarm rules
Send notifications	Deliver alerts through configured notification delivery methods when alarms are created, updated, or cleared	Notifications
Visualize on dashboards	Add alarm tables and alarm counts to dashboards	Dashboards
Manage via REST API	Create, query, acknowledge, clear, and delete alarms programmatically	REST API