Platforms
Product Lines
Platforms Safecrete Safewall Mine Operating System (Coming Soon)
© 2026 IndustryOS
On this page

Alarm management

The IndustryOS Mobile Application provides comprehensive alarm management capabilities, enabling users to monitor, acknowledge, and resolve alarms from anywhere, ensuring rapid response to critical events.

Overview

Mobile alarm management includes:

  • Real-Time Alarm Monitoring: View active alarms with live updates
  • Push Notifications: Receive instant notifications for critical alarms
  • Alarm Acknowledgement: Acknowledge and clear alarms from mobile device
  • Alarm Details: View detailed alarm information and history
  • Filtering and Search: Find specific alarms quickly
  • Alarm Analytics: View alarm statistics and trends

Accessing Alarms

Alarms Screen

The main alarms screen displays all active alarms:

  1. Open the IndustryOS mobile app
  2. Tap the Alarms tab in the bottom navigation bar
  3. View the list of all active alarms ordered by severity and time

Alarm Badge Counter

The alarms tab displays a badge with the count of unacknowledged alarms:

  • Red Badge: Indicates critical or major alarms
  • Number: Shows count of unacknowledged alarms
  • Auto-Update: Updates in real-time as alarms are created or cleared

Pull-to-Refresh

Manually refresh the alarm list:

  1. Navigate to the Alarms screen
  2. Pull down from the top of the list
  3. Release to refresh alarm data

Alarm List Features

Alarm Card Display

Each alarm is displayed as a card showing:

  • Severity Indicator: Colour-coded bar (red for critical, orange for major, yellow for minor, blue for warning)
  • Alarm Type: The type of alarm (e.g., “High Temperature”, “Device Offline”)
  • Originator: Device, asset, or entity that triggered the alarm
  • Start Time: When the alarm was created (relative time, e.g., “5 minutes ago”)
  • Status: Current alarm status (Active, Acknowledged, Cleared)
  • Acknowledgement: User who acknowledged the alarm (if applicable)

Severity Levels

Alarms are categorised by severity:

  • Critical: Severe issues requiring immediate attention (red)
  • Major: Significant issues requiring prompt attention (orange)
  • Minor: Issues that should be addressed soon (yellow)
  • Warning: Informational notices (blue)
  • Indeterminate: Unknown severity (grey)

Alarm Status

Alarms can have the following statuses:

  • Active Unacknowledged: New alarm not yet acknowledged
  • Active Acknowledged: Alarm acknowledged but not yet cleared
  • Cleared Unacknowledged: Alarm cleared but not yet acknowledged
  • Cleared Acknowledged: Alarm fully resolved

Filtering and Searching Alarms

Severity Filter

Filter alarms by severity level:

  1. Tap the Filter icon on the alarms screen
  2. Select severity levels to display:
    • Critical
    • Major
    • Minor
    • Warning
  3. Tap Apply to filter the list

Status Filter

Filter alarms by status:

  • Active: Show only active alarms
  • Cleared: Show only cleared alarms
  • Acknowledged: Show only acknowledged alarms
  • Unacknowledged: Show only unacknowledged alarms

Search Alarms

Search for specific alarms:

  1. Tap the Search icon on the alarms screen
  2. Enter search terms:
    • Alarm type
    • Originator name
    • Details or message content
  3. Results update in real-time as you type

Time Range Filter

Filter alarms by time range:

  • Last Hour: Alarms from the past hour
  • Last 24 Hours: Alarms from the past day
  • Last 7 Days: Alarms from the past week
  • Custom Range: Specify start and end dates

Alarm Actions

Viewing Alarm Details

View detailed information about an alarm:

  1. Tap on an alarm card in the list
  2. View the alarm details screen showing:
    • Full alarm details
    • Originator information
    • Start and end times
    • Acknowledgement history
    • Alarm details dashboard (if configured)

Acknowledging Alarms

Acknowledge alarms to indicate you are aware of the issue:

Single Alarm:

  1. Tap on the alarm to open details
  2. Tap Acknowledge button
  3. Optional: Add acknowledgement comment
  4. Confirm acknowledgement

Multiple Alarms:

  1. Long-press on an alarm card to enter selection mode
  2. Tap additional alarms to select
  3. Tap Acknowledge action button
  4. Confirm bulk acknowledgement

Clearing Alarms

Manually clear alarms that won’t auto-clear:

  1. Tap on the alarm to open details
  2. Tap Clear button
  3. Optional: Add clear comment explaining resolution
  4. Confirm alarm clearance

Note: Some alarms automatically clear when the triggering condition resolves.

Alarm Comments

Add comments to alarms for collaboration:

  1. Open alarm details
  2. Scroll to Comments section
  3. Tap Add Comment
  4. Enter your comment
  5. Tap Submit

Comments are visible to all users with access to the alarm.

Alarm Details Dashboard

View custom dashboards with detailed context for each alarm:

Configuring Alarm Dashboards

System administrators can configure alarm-specific dashboards:

  1. Navigate to Device Profiles in IndustryOS
  2. Select the device profile
  3. Go to Alarm Rules tab
  4. Edit an alarm rule
  5. Set Mobile Dashboard field to the desired dashboard
  6. Save the alarm rule

See Configure Alarm Dashboards for detailed instructions.

Viewing Alarm Dashboards

When an alarm has a configured dashboard:

  1. Tap on the alarm card
  2. The alarm details screen displays the custom dashboard
  3. View real-time telemetry, charts, and controls related to the alarm
  4. Use dashboard widgets to diagnose and resolve issues

Dashboard Context

Alarm dashboards automatically receive context:

  • Alarm Entity: Dashboard aliases can reference the alarm’s originator
  • Time Range: Dashboard can show data from alarm start time
  • Attributes: Access alarm attributes and details in widgets

Push Notifications for Alarms

Enabling Push Notifications

Ensure push notifications are configured:

  1. Configure Firebase Cloud Messaging in Mobile Centre
  2. Grant notification permissions in mobile app
  3. Configure alarm notification rules in IndustryOS

See Push Notifications for setup instructions.

Notification Behaviour

Alarm notifications behave differently based on severity:

Critical Alarms:

  • High-priority notification with sound and vibration
  • Bypass Do Not Disturb mode (on some devices)
  • Persistent notification (won’t auto-dismiss)

Major Alarms:

  • Standard notification with sound and vibration
  • Auto-dismiss after user interaction

Minor/Warning Alarms:

  • Silent notification (no sound or vibration)
  • Grouped with other low-priority notifications

Notification Actions

Tap notifications to:

  • Open Alarm Details: View full alarm information and dashboard
  • Acknowledge: Quick-acknowledge from notification (future feature)
  • Dismiss: Remove notification without opening app

Alarm Analytics

Alarm Summary

View alarm statistics on the alarms screen:

  • Total Active Alarms: Count of all active alarms
  • By Severity: Breakdown by critical, major, minor, warning
  • By Status: Acknowledged vs. unacknowledged
  • By Originator: Top devices/assets with most alarms

Analyse alarm trends over time:

  1. Tap Analytics on the alarms screen
  2. View charts showing:
    • Alarms over time (hourly, daily, weekly)
    • Severity distribution trends
    • Top alarm types
    • Mean time to acknowledge (MTTA)
    • Mean time to resolve (MTTR)

Exporting Alarm Data

Export alarm data for further analysis:

  1. Apply desired filters to alarm list
  2. Tap Export icon
  3. Select export format (CSV, Excel, PDF)
  4. Share via email, cloud storage, or messaging app

Real-Time Updates

WebSocket Subscription

The mobile app maintains a WebSocket connection for real-time alarm updates:

  • New Alarms: Instantly appear in the alarm list
  • Status Changes: Alarm status updates in real-time
  • Acknowledgements: See when other users acknowledge alarms
  • Clearances: Alarms automatically removed when cleared

Auto-Refresh

The alarm list automatically refreshes:

  • Foreground: Updates every 5 seconds when app is active
  • Background: Updates when push notifications received
  • On Resume: Refreshes when app returns from background

Connection Status

Monitor real-time connection status:

  • Connected: Green indicator, live updates enabled
  • Connecting: Yellow indicator, attempting to reconnect
  • Disconnected: Red indicator, using cached data only

Offline Behaviour

Cached Alarms

When offline, the app displays cached alarm data:

  • Last Sync: Shows timestamp of last successful sync
  • Read-Only: Cannot acknowledge or clear alarms offline
  • Offline Indicator: Visual indicator shows offline status

Pending Actions

Actions performed offline are queued:

  1. User acknowledges alarm whilst offline
  2. Action queued locally
  3. When connection restored, action automatically executed
  4. User notified of success or failure

Troubleshooting

Alarms Not Appearing

Check Permissions:

  • Verify user has alarm access permissions
  • Check entity-level permissions for alarm originators

Check Filters:

  • Clear all filters and search terms
  • Verify selected time range includes alarm creation time

Refresh Data:

  • Pull down to refresh alarm list
  • Log out and log back in
  • Check network connectivity

Push Notifications Not Received

Check Notification Settings:

  • Verify app has notification permissions enabled
  • Check device Do Not Disturb settings
  • Ensure Battery Optimisation is disabled for the app

Check FCM Configuration:

  • Verify Firebase Cloud Messaging is configured in Mobile Centre
  • Check FCM server key is correct
  • Ensure device is registered in Mobile Centre

Check Alarm Rules:

  • Verify alarm rules are configured to send notifications
  • Check notification target users include the logged-in user

See Push Notifications Troubleshooting for more details.

Cannot Acknowledge Alarms

Check Permissions:

  • Verify user has alarm acknowledgement permission
  • Check role-based access control settings

Check Network:

  • Ensure device has internet connectivity
  • Verify IndustryOS server is accessible

Check Alarm Status:

  • Verify alarm is not already acknowledged
  • Check alarm is still active

Alarm Details Dashboard Not Loading

Check Configuration:

  • Verify alarm rule has Mobile Dashboard configured
  • Check dashboard exists and is accessible
  • Ensure user has permission to view the dashboard

Check Network:

  • Verify internet connectivity
  • Check WebSocket connection status

Clear Cache:

  • Clear app cache in settings
  • Reinstall the app if issue persists

See Alarm Dashboard Configuration for setup details.

Best Practices

Alarm Response

  • Acknowledge Promptly: Acknowledge alarms immediately to indicate awareness
  • Add Comments: Provide context when acknowledging or clearing alarms
  • Prioritise by Severity: Address critical and major alarms first
  • Root Cause Analysis: Investigate recurring alarms to identify underlying issues

Notification Management

  • Configure Appropriately: Only enable notifications for critical events
  • Use Severity Filters: Customise notifications by alarm severity
  • Respect User Preferences: Allow users to configure notification preferences
  • Avoid Notification Fatigue: Don’t overwhelm users with too many notifications

Performance

  • Limit Alarm History: Archive old alarms to improve list performance
  • Use Filters: Filter alarms to reduce data retrieval and rendering
  • Monitor Connection: Check WebSocket status for real-time updates

Collaboration

  • Use Comments: Communicate with team members via alarm comments
  • Document Resolutions: Explain how alarms were resolved for future reference
  • Track Metrics: Monitor MTTA and MTTR to improve response times