NISC Muster Tracking

Appearance

Battery Health ​

The Battery Health page gives you a real-time overview of the battery status for every BLE device registered in the system — including personnel badges, asset tags, and other battery-powered beacons. Use this page to identify devices that need battery replacement before they go offline and interrupt mustering accuracy.

Getting to Battery Health ​

From the main navigation, select Battery Health under the Monitoring section.

Permissions note: You must have the battery.view permission to access this page. Contact your system administrator if the page is not visible.

Page Overview ​

When the page loads, it automatically fetches the current battery data for all devices and displays a summary at the top.

Screenshot placeholder: Battery Health page — summary stats and tab bar

Summary Stats ​

Four counters appear at the top of the page:

StatMeaning
TotalNumber of devices with known battery data
CriticalDevices at or below the critical threshold (default: 20%)
LowDevices between the low and critical threshold (default: 21%–40%)
NormalDevices above the low threshold

A Battery Health percentage is also displayed — this is the proportion of devices in Normal status out of the total.

Filtering by Status Tab ​

The page has four tabs that filter which devices are shown:

  1. All — Shows every device, regardless of battery level.
  2. Critical — Shows only devices at or below the critical threshold (red indicator).
  3. Low — Shows only devices between the low and critical thresholds (amber indicator).
  4. Normal — Shows devices with a healthy battery level (green indicator).

To switch tabs:

  1. Click the tab label (All, Critical, Low, or Normal) near the top of the device list.
  2. The device count updates immediately.

Tip: Start your daily check on the Critical tab. Devices listed there are at risk of powering off within hours and should be prioritised for battery replacement.

Searching for a Device ​

A search box is available above the device list.

  1. Click inside the search box.
  2. Type part of the device name or device ID.
  3. The list narrows in real time to show matching devices.

The search works across both the friendly device name and the raw device ID.

Understanding Battery Status Colours ​

Each device entry shows a coloured battery indicator:

ColourStatusMeaning
RedCriticalBattery at or below 20% — replace immediately
AmberLowBattery between 21% and 40% — schedule replacement soon
GreenNormalBattery above 40% — no action needed
GreyUnknownNo battery level reported by the device

Note: The thresholds (20% and 40% by default) can be adjusted by an administrator. See Configuring Alert Thresholds below.

Switching Between Table and Card View ​

Two display modes are available:

  • Table view — A dense, sortable list with all device details in columns. Best for scanning many devices quickly.
  • Card view — Each device appears as an individual card with larger text. Easier to read on screens with limited horizontal space.

To switch views:

  1. Find the view toggle buttons in the toolbar (table icon and card icon).
  2. Click your preferred icon.
  3. Your choice is remembered the next time you open the page.

Viewing Device Details ​

To see full details for a specific device:

  1. Click on a device row in the table, or click the detail icon on a card.
  2. A details panel opens showing:
    • Device name and ID
    • Current battery level with a visual percentage bar
    • Battery status (Critical / Low / Normal)
    • Last reported timestamp
    • Building and floor location
    • A battery history line chart showing the level trend over the past 24 hours

Screenshot placeholder: Device details panel with history chart

  1. Click the close button or click outside the panel to dismiss it.

Battery Distribution Chart ​

Below the device list, a doughnut chart shows the proportion of Critical, Low, Normal, and Unknown devices across the entire fleet. This gives a quick visual summary of overall fleet health.

The chart is colour-coded to match the status indicators (red, amber, green, grey).

Alerts by Location and Device Type ​

The system automatically groups battery alerts in two ways that help you plan replacement rounds:

  • By Location — Alerts are grouped by building and floor, so you can see which areas have the most devices needing attention. This is useful for maintenance staff who work floor-by-floor.
  • By Device Type — Alerts are grouped by device category (e.g. badge, asset tag). This helps when a specific batch of devices is running low.

These groupings appear as collapsible sections below the main device list.

Exporting Battery Data ​

You can export the current battery alert list in several formats:

Export to CSV ​

  1. Click the Export CSV button in the toolbar.
  2. A file named battery-alerts-YYYY-MM-DD.csv downloads to your browser's default download location.
  3. The file contains: Device ID, Device Name, Battery Level, Status, Last Reported, Location.

Export to PDF ​

  1. Click the Export PDF button.
  2. A PDF report is generated and downloads automatically.
  3. The report is formatted in landscape orientation for readability.

Print ​

  1. Click the Print button.
  2. Your browser's print dialog opens with a formatted battery report ready to print.

Tip: Export to CSV if you need to share data with a maintenance team or import it into a spreadsheet for replacement planning.

Real-Time Updates ​

The Battery Health page uses a live WebSocket connection (Centrifugo) to receive battery updates as they arrive. When a device reports a new battery level, the page updates automatically without requiring a manual refresh.

If the WebSocket connection is unavailable, the page automatically falls back to polling the server every 30 seconds to check for changes. You can tell the connection is active because the data refreshes smoothly without a visible loading spinner.

Configuring Alert Thresholds ​

Permissions note: Changing thresholds requires the battery.manage permission.

The default thresholds are:

  • Critical: below 20%
  • Low: below 40%

To change them:

  1. Click the Thresholds button (or gear icon) in the toolbar.
  2. A dialog opens showing the current critical and low percentage values.
  3. Adjust the sliders or type new values directly.
  4. Click Save to apply. The new thresholds take effect immediately and are saved to the server so all users see the same values.

Note: Raising the low threshold means more devices will appear in the Low category sooner. Lowering the critical threshold delays alerts — use caution.

Frequently Asked Questions ​

A device shows "Unknown" battery status — what does that mean? The device has not reported its battery level yet. This can happen with newly enrolled devices or devices that have been out of range of a gateway. The device will appear once it checks in.

Why is the battery level not updating? If a device is out of range of all gateways, it cannot transmit its battery reading. Check the Gateways page to confirm the gateways covering that area are online.

Can I acknowledge or dismiss a battery alert? No — battery alerts are informational only. Once the device is replaced or recharged and reports a normal level, it moves off the Critical or Low tabs automatically.

  • Gateways — Check gateway connectivity, which affects device reporting
  • Activity Log — See the last time a specific device transmitted
  • Analytics — Trend battery health data over time

NISC Muster Tracking Documentation