User Documentation

Complete guide to the Predictive Maintenance Dashboard

Troubleshooting

Common Issues and Solutions

Alarm table is empty

  • Check if filters are applied (click KPI cards to clear filters)
  • Verify devices are online and reporting sensor data
  • Check browser console for JavaScript errors

Context panel won't open

  • Ensure you're clicking the alarm row (not the checkbox)
  • Try refreshing the page
  • Check if browser popup blocker is interfering

Custom deployment photo not uploading

  • Verify image file size is under 5MB
  • Ensure file format is JPG, PNG, or WebP
  • Check browser console for upload errors
  • Try a different image file

KPI cards not filtering correctly

  • Click the card again to clear the filter
  • Refresh the page to reset all filters
  • Check if multiple filters are applied simultaneously

Bulk actions not working

  • Ensure you've selected at least one alarm using checkboxes
  • Verify you have permission to perform the action
  • Check if alarms are in the correct lifecycle state for the action

Scheduled reports not sending

  • Verify email addresses are correct (comma-separated)
  • Check spam/junk folder for test reports
  • Ensure "Enable Scheduled Reports" toggle is ON
  • Verify SMTP settings are configured (contact administrator)

Theme toggle not working

  • Clear browser cache and cookies
  • Try a different browser
  • Check if localStorage is enabled in browser settings

Mobile bottom sheet not opening

  • Ensure you're tapping the alarm row (not swiping)
  • Try refreshing the page
  • Check if touch events are blocked by browser extension

Browser Compatibility

The dashboard is tested and supported on:

  • Chrome 90+
  • Firefox 88+
  • Safari 14+
  • Edge 90+

Older browser versions may experience compatibility issues. Update to the latest version for best performance.

Performance Optimization

For optimal performance with large datasets:

  • Use filters to reduce visible alarm count
  • Enable alarm storm suppression to group related alarms
  • Close the context panel when not in use
  • Disable "Include Charts" in scheduled reports if not needed
  • Use List View instead of Map/Twin view for faster rendering

Getting Help

If you encounter issues not covered in this documentation:

  1. Check the browser console for error messages
  2. Take a screenshot of the issue
  3. Note the steps to reproduce the problem
  4. Contact your system administrator or support team with the above information

System Status

Check the system status indicator in the top header:

  • Green — All systems operational
  • Yellow — Degraded performance or partial outage
  • Red — System unavailable or critical error

If the status is yellow or red, contact your system administrator.