Skip to main content

OEE Alarm Record

Overview

The OeeAlarmRecord entity represents a historical record of an alarm event within the OEE system. Each object captures the state and metadata of Ignition alarms for OEE analysis and reporting. The entity contains several parameters such as the Location and Oee State Record corresponding to the alarm record, the Ignition source that produced the alarm, and the time the alarm was active.

Table Structure

The following table outlines the SQL columns for the oee_alarm_records table, providing a brief description of each.

ColumnTypeDescriptionExample
idString (ULID)Unique identifier for the entity.01JAP8RJBN-8ZTPXSGY-J9GSDPE1
enabledBooleanIf the entity is enabled or not. Default is true.true
created_dateDateTimeDate the entity was created.2025-12-09T19:48:44Z
created_byStringPerson who created the entity.TamakiMES
modified_dateDateTimeDate the entity was modified. Value is null upon creation, and gets initially populated upon the first edit.2025-12-09T19:48:44Z
modified_byStringLast person to modify the entity. Value is null upon creation, and gets initially populated upon the first edit.TamakiMES
notesStringNotes about the entity.This entity has these extra notes
spare1StringThe first spare column that can be used for additional context on the entity.extra context 1
spare2StringThe second spare column that can be used for additional context on the entity.extra context 2
spare3StringThe third spare column that can be used for additional context on the entity.extra context 3
location_idString (ULID)References the location where the alarm record was recorded. See Location.01JAP8RJBN-8ZTPXSGY-J9GSDPE1
oee_state_record_idString (ULID)References the OEE state record for the property. See Oee State Record.02K4M9QX7A-LR8ZV2WD-PF6C1H9B
nameStringThe alarm name as configured in Ignition.Alarm
ignition_alarm_idStringReferences the ignition alarm corresponding to the record.a]prov://path/alarm
sourceStringThe tag path or source that generated this alarm.provider/tag/alarm
priorityString (Enum)The configured priority level of the alarm.Low
display_pathStringThe hierarchical display path of the alarm in the tag structure.Filler On Hold: Over Torque
labelStringThe human-readable display name for the alarm.Alarm
active_dateDateTimeIndicates when the alarm condition became active.2025-12-09T19:48:44Z
cleared_dateDateTimeIndicates when the alarm condition cleared.2025-12-09T20:48:44Z
acknowledged_dateDateTimeIndicates when the alarm was acknowledged by an operator.2025-12-09T20:50:44Z
shelved_dateDateTimeIndicates when the alarm was temporarily suppressed.2025-12-09T20:50:44Z
stateString (Enum)The current state of the alarm in Ignition's state machine.ClearAcked
last_event_stateString (Enum)The most recent state transition that occurred for this alarm.Clear
downtime_reason_code_overrideIntegerOptional downtime reason code override value.1003
state_code_overrideIntegerOptional state code override value.1

Field Details

location_id

References the location where the alarm record was recorded. See Location for details.

oee_state_record_id

References the OEE state record active at the location at the time the alarm record was recorded. See Oee State Record for details.

name

The alarm name as configured in Ignition. The name must be less than 255 characters.

ignition_alarm_id

References the ignition alarm corresponding to the record.

source

The tag path or source that generated this alarm. Should be in the form provider/tag/alarm.

priority

The configured priority level of the alarm. Alarm priorities from lowest to highest are Diagnostic, Low, Medium, High, and Critical.

display_path

The hierarchical display path of the alarm in the tag structure.

label

The human-readable display name for the alarm.

active_date

Indicates the date and time when the alarm condition became active.

cleared_date

Indicates the date and time when the alarm condition cleared.

acknowledged_date

Indicates the date and time the alarm was acknowledged by an operator, if it has been.

shelved_date

Indicates the date and time the alarm was temporarily suspended, if it has been.

state

The current state of the alarm in Ignition's state machine.

last_event_state

The most recent state transition that occurred for this alarm.

downtime_reason_code_override

The optional downtime reason code override value.

state_code_override

The optional state code override value. When set, alarms from this configuration will use the value from that associated data property instead of deriving the state code from the alarm data.