Skip to main content
Version: Next

Alarm Journal

The append-only history of every alarm lifecycle event — raised, acknowledged, returned to normal, shelved, suppressed, restored — searchable and filterable, and fast over months of data.

The Alarm Journal component as it renders with its default settings.The Alarm Journal component as it renders with its default settings.

Reach for it when you need:

  • Shift handover: what happened, and what is still outstanding
  • Incident investigation: the exact order of events and who acknowledged what

Component name: AlarmJournal · Category: Alarm

In the palette: Append-only alarm history — searchable and paged, fast over months of data

Properties

Any property can be bound to a tag, another component's property, or a query.

PropertyTypeDefaultDescription
paginationobject{"rowsPerPage":100,"rowsPerPageOptions":"50, 100, 250, 500",… (truncated)
zebraobject{"enabled":true}Zebra-stripe alternate rows.
columnsobject{"event":true,"tag":true,"priority":true,"value":false,"desc… (truncated)Show / hide columns.
tableobject{"reorder":true,"resize":true,"sort":true}Column interactions: reorder, resize, and sort (click a header to sort the page).
filtersobject{"enabled":true,"search":"","priority":"","event":""}enabled = show the search/filter bar. The values (bindable) override the controls; blank = user-controlled.
priorityColorsobject{"critical":"#d32f2f","high":"#f57c00","medium":"#fbc02d","l… (truncated)Per-priority colours (ISA-18.2 default: red/orange/yellow/blue). Shared live across all alarm widgets — change once, applies everywhere.
dateFormatstringdd MMM yyyy HH:mm:ssdate-fns pattern, e.g. dd MMM yyyy HH:mm:ss, dd/MM/yy HH:mm, yyyy-MM-dd.
stylestyle{}Custom CSS properties

Events

Attach event actions to these in the Event Manager.

EventLabelGroupPayload
clickClickMouseThe DOM event.
dblclickDouble clickMouseThe DOM event.
contextmenuRight clickMouseThe DOM event.
mouseenterMouse enterMouseThe DOM event.
mouseleaveMouse leaveMouseThe DOM event.
Right-click behaves differently in the Designer

contextmenu fires your configured actions at runtime only — in LiveView and in preview. On the Designer canvas the right-click is captured to open the Event Manager, so testing it there will not run your actions. Test right-click in preview.

Notes

The journal is the alarm record, not the security audit journal. Use the audit journal for "who changed the setpoint"; use this one for "when did it trip".

See also