assets/img/logo.svg
Realtime

Alarms

Real-time alarm monitoring and acknowledgment

The Alarms page allows you to monitor all active alarms in real-time for one or more plants. It is intended for control room operators.


What are alarms

An alarm represents an abnormal condition detected by the monitoring system during plant operation. Each alarm has two independent dimensions:

  • Status: ON (active condition) or OFF (condition cleared)
  • Acknowledgment (ACK): ACK (operator has seen it) or Not ACK (pending attention)

These combine into four states:

StateMeaningRow Color
ON - Not ACKActive alarm, not acknowledged — requires immediate attentionBright red
ON - ACKActive alarm, acknowledged — operator is awareDark red
OFF - Not ACKCondition cleared, not yet acknowledgedDark gray
OFF - ACKCleared and acknowledged — fully resolvedGreen

Plant selection

To view alarms, you must:

  1. Select one or more plants from the tree in the toolbar
  2. Click Load Alarms
If no plant is selected, the system displays a warning message and the load is not performed.

After loading, alarms auto-refresh periodically while the page is open. You do not need to click Load again unless you change the plant selection.


Alarm list

When alarms are loaded, the table displays all active alarms for the selected plants.

The total number of alarms found is shown above the table and updates based on applied filters.

Table columns

ColumnDescription
TimeDate and time of the alarm with millisecond precision
PlantPlant where the alarm originated
SectionElectrical distribution line the device belongs to. Hidden by default
DeviceDevice that generated the alarm (inverter, turbine, meter)
NameTechnical name of the alarm
DescriptionExtended description of the alarm condition
ValueNumeric value associated with the alarm
ValidIndicates whether the data was valid at the time of recording. Invalid data usually results from communication issues
LevelSeverity level 1-5 (Very Low, Low, Medium, High, Very High)
StatusAlarm state badge: ON or OFF, with ACK status
AckAcknowledgment state: true (acknowledged) or false (pending)
UserOperator who acknowledged the alarm

State filter badges

Above the table, four color-coded badges show the count of alarms in each state:

  • ON - Not ACK (red)
  • ON - ACK (dark red)
  • OFF - Not ACK (gray)
  • OFF - ACK (green)

These badges are clickable toggle filters. Click a badge to hide/show alarms of that state. Dimmed badges indicate that state is currently filtered out.


Column filters and navigation

Each table column has a filter accessible by clicking the icon in the header.

  • The alarm counter above the table shows the number of alarms matching the applied filters
  • The Filters indicator shows the number of active filters in parentheses (e.g., "Filters (3)")
  • Active filter badges show the currently applied filters. Click the X on a badge to remove that specific filter
  • To remove all filters: click the X icon next to the filter count
  • Filters are applied in real-time on the table

Acknowledging alarms

Acknowledgment (ACK) is the process of confirming that an operator has seen and is aware of an alarm.

In list view

  1. Select one or more alarm rows using the checkboxes
  2. A floating bar appears at the bottom showing the number of selected alarms
  3. Click Acknowledge to ACK the selected alarms
  4. Click X to clear the selection
Viewport safety: Only alarms currently visible in the table viewport will be acknowledged. If you have selected alarms that are scrolled out of view, the system will warn you that those alarms will NOT be acknowledged. Scroll to see them before confirming.

In grouped view

Each alarm group card provides:

  • Ack All — acknowledges all alarms in that group
  • Ack Selected — acknowledges only the checked alarms within the group (appears when checkboxes are ticked)

Grouped view

Switch between List and Grouped view using the toggle button in the toolbar.

In grouped view, alarms are organized by alarm name into expandable cards:

  • Each card shows the group name, a severity badge (highest level among child alarms), the count of active alarms, and the total count
  • Click a card to expand and see individual alarms with checkboxes
  • Groups are sorted by the number of ON - Not ACK alarms (most critical first)

Severity badge

The severity badge next to each group name reflects the highest severity level among all alarms in that group:

  • Level 4-5: Red (High / Very High)
  • Level 3: Amber (Medium)
  • Level 1-2: Blue (Very Low / Low)

Buzzer

When there are ON - Not ACK alarms, the system plays an audible alarm chime — a two-tone "bi-bop" pattern designed for control room use.

  • The chime repeats every 4 seconds
  • It stops automatically when all alarms are acknowledged or cleared
  • Use the Mute/Unmute button in the toolbar to silence the buzzer
  • Mute preference is saved in your browser and persists across sessions

Data export

Displayed alarms can be exported in CSV format using the dedicated button (list view only). The export generates exactly what you see in the table:

  • Filtered data: Only rows matching the active filters are exported
  • Current sorting: Rows are exported in their current sort order
  • Visible columns: Only visible columns are exported, in their current display order
The export button is disabled if no data is available in the table.

Auto-refresh

While the page is open, alarms are automatically refreshed every 10 seconds. The refresh:

  • Preserves your current scroll position
  • Preserves your row selections
  • Preserves applied filters
  • Pauses during ACK operations to avoid conflicts
Table preferences (column order, width, visibility), applied filters, plant selection, and view mode are automatically saved in your browser and restored on your next visit.

Frequently asked questions

What happens if a new alarm appears while I'm viewing the page?

The table updates automatically during the next refresh cycle (every 10 seconds). New alarms appear at the top of the list (sorted by most recent timestamp).

Can I see who acknowledged an alarm?

Yes, the User field shows the operator who acknowledged the alarm.

Why can't I acknowledge alarms that are scrolled out of view?

This is a safety feature. Acknowledging an alarm means the operator has visually verified its existence. The system requires alarms to be visible in the viewport before they can be acknowledged.

Copyright © 2026