Skip to main content

Acknowledging Machine Alarms

When a machine enters an alarm state, Shoplogix IMS gives you two options for managing that alert: Acknowledge it (signal that your team is aware and investigating) or Clear it (mark it as resolved). Both actions are tracked in the alarm history.

Alarm States​

A machine can be in one of three alarm states at any time:

StateMeaning
GoodVibration is within all configured thresholds
AlarmVibration has crossed one or more configured thresholds
AcknowledgedAn alarm is active but has been acknowledged by a team member

The platform sets Good and Alarm automatically based on sensor data. Acknowledged is a manual action — it signals that your team has seen the alert and is responding.

How to Acknowledge an Alarm​

  1. Open the machine's detail page in Shoplogix IMS
  2. The current alarm status is shown at the top of the page
  3. From the alarm status dropdown, select Acknowledge
  4. The machine state changes to Acknowledged and the action is recorded with a timestamp

Acknowledging an alarm does not clear it — the machine remains in an elevated state. It simply moves the alarm from "unattended" to "in progress."

How to Clear an Alarm​

  1. Open the machine's detail page
  2. From the alarm status dropdown, select Clear
  3. The machine state changes to Good

Only clear an alarm when you have confirmed the issue has been resolved or when you have determined the alert was a false positive. Vibration data continues to be evaluated regardless of the manual state — if the machine's vibration remains elevated, the platform will generate a new alarm.

Effect on Notifications and Webhooks​

  • Acknowledge and Clear are manual state transitions. They send a notification to subscribed users if the state changes (e.g., Alarm → Acknowledged, Acknowledged → Good).
  • In webhook deliveries, the machineEndAlarmState value reflects the new state: Acknowledged or Good.

Alarm History​

Every state transition — whether automatic (sensor-driven) or manual (Acknowledge / Clear) — is recorded in the machine's alarm history. The history shows:

  • The timestamp of each transition
  • The start and end state
  • Whether the transition was automatic or user-initiated

Use the alarm history to review how often a machine has alarmed, whether alarms are being responded to in a timely way, and whether a repaired machine has stayed in Good condition.

Who Can Acknowledge Alarms​

The Customer User role and above can acknowledge and clear machine alarms within their assigned account.