Activity Log
The Activity Log shows a real-time stream of BLE detection events — every time a badge, asset tag, or other tracked device is seen by a gateway, an event is recorded here. Use this page to investigate where a specific device has been, verify that a gateway is actively detecting devices, or troubleshoot missing personnel during a muster.
Getting to Activity Log
From the main navigation, select Activity Log under the Monitoring section.
Permissions note: You must have the
activity.readpermission to load activity data. If the page loads but shows no events after applying a filter, confirm your account has this permission with your administrator.
Page Overview
Screenshot placeholder: Activity Log — list view with filter bar
The Activity Log uses a lazy-loading approach: it does not fetch data until you apply at least one filter or click Refresh. This prevents the page from loading thousands of events unnecessarily on every visit.
When you first open the page, a message prompts you to adjust a filter or refresh to begin loading. Once loaded, a summary line shows how many events matched your current filters (for example, "Showing 1–25 of 4,832 events").
Loading Activity Data
To load events:
- Set at least one filter (search query, gateway, device type, or time range) or click the Refresh button directly.
- Events matching your criteria appear in the list.
- Adjust filters to narrow or widen the results at any time.
Tip: For a broad overview of recent activity, simply click Refresh without setting any other filters. This loads the most recent events within the default 24-hour window.
Filters
Four filters are available in the toolbar:
Search
Type any text to search by device name, device ID (MAC address), or manufacturer name. The search is applied with a short delay after you stop typing to avoid excessive server requests.
Gateway
A dropdown list of all configured gateways. Select a specific gateway to see only events detected by that gateway. This is useful for:
- Verifying a newly installed gateway is picking up devices
- Investigating a coverage gap in a specific zone
- Confirming which devices were present near a particular gateway at a given time
Select "All Gateways" to remove the gateway filter.
Device Type
A dropdown listing all device types seen in recent activity. Select a type to narrow the list to that category of device (for example, a specific badge model or asset tag type).
Select "All Device Types" to remove this filter.
Time Range
Controls how far back in time the query looks:
| Option | Window |
|---|---|
| Last 1 Hour | Past 60 minutes |
| Last 6 Hours | Past 6 hours |
| Last 24 Hours | Past 24 hours (default) |
| Last 7 Days | Past 7 days |
| Last 30 Days | Past 30 days |
Note: Wider time ranges return more data and may take slightly longer to load. For investigations involving thousands of events, consider using the Analytics page for aggregated trend data instead.
Understanding Event Data
Each row in the Activity Log represents a single detection event. The following fields are available:
| Field | Description |
|---|---|
| Time | When the event was recorded. Shown as a relative time ("5m ago") with the exact timestamp on hover. |
| Source | Whether the event came from a tracked device (a registered badge or asset — shown in green) or an ambient device (an unregistered BLE device such as a phone or IoT sensor — shown in amber). |
| Device | The friendly name of the device. For tracked devices, this is the assigned name. For ambient devices, this may be the manufacturer and model or a custom label from the Ambient Devices registry. |
| Device ID | The hardware MAC address of the device. Displayed in formatted XX:XX:XX:XX:XX:XX notation. |
| Employee ID | For tracked personnel badges, the associated employee ID if one is assigned. |
| Device Type | The category of device (badge, asset tag, ambient BLE, etc.). |
| Gateway | The name of the gateway that detected the event. |
| Location | The building and floor where the detecting gateway is installed. |
| Signal (RSSI) | The received signal strength of the detection. Displayed as a coloured indicator: strong (green), medium (amber), or weak (red). |
Customising Columns
Not all columns need to be visible at once. You can show or hide columns to suit your workflow.
- Click the Columns button (or the columns menu icon) in the toolbar.
- A checklist of available columns appears.
- Check or uncheck columns as needed.
- Changes take effect immediately.
- Your column preferences are saved automatically and restored the next time you visit the page.
Default visible columns: Time, Source, Device, Device Type, Gateway, Location, Signal
Hidden by default (useful for technical investigation): Device ID, Employee ID
Sorting
In table view, click any column header to sort by that column. Click again to reverse the sort order. Sorting triggers a fresh data fetch so that all matching records are sorted correctly, not just the current page.
The default sort is newest events first (Time, descending).
Pagination
Results are displayed in pages. The default page size is 25 events.
- Use the page navigation at the bottom to move between pages.
- Use the rows-per-page selector to show 10, 25, or more events per page.
- The summary line ("Showing X–Y of Z events") updates with each page change.
View Modes
Three display modes are available, toggled from the toolbar:
List View (default)
A compact, dense list where each event is a single row. Best for scanning large numbers of events quickly. All selected columns are shown.
Table View
A more structured data table with sortable column headers and gridlines. Best when you need to compare values across multiple columns or when copying data.
Card View
Each event appears as a separate card with more visual space per entry. Useful on touchscreens or when you need to read event details without horizontal scrolling.
Your view mode preference is saved automatically.
Ambient Device Details
Ambient devices are BLE devices that are detected by your gateways but are not registered personnel badges or tracked assets — for example, smartphones, smart watches, or environmental sensors.
To see enriched details for an ambient device:
- Click on any event row where the Source shows "ambient".
- A detail panel opens showing any additional information from the Ambient Devices registry: custom name, custom identifier, manufacturer, and model.
- Click close to dismiss the panel.
Exporting Activity Data
You can export the current event list in several formats.
Export to CSV
- Set your filters to define the data you want to export.
- Click Export CSV in the toolbar.
- A CSV file downloads containing the visible columns for all matching events.
Export to PDF
- Set your filters.
- Click Export PDF.
- A formatted PDF report downloads automatically.
Print
- Set your filters.
- Click Print.
- Your browser's print dialog opens with a formatted report ready to send to a printer.
Tip: If you need to export more than a few hundred records, apply specific filters (a narrow time range and/or a specific gateway) first to keep the export manageable.
Real-Time Updates
The Activity Log does not stream live events continuously by default — it fetches a snapshot based on your current filters. To see the latest events:
- Click the Refresh button at any time to reload data with your current filters applied.
- The Refresh button shows a spinner while the request is in progress.
- After refreshing, a brief "Refreshed" notification confirms the data is up to date.
Frequently Asked Questions
I applied filters but the list is empty. Confirm that your time range is wide enough to cover when you expect events to have occurred. Also check whether the gateway filter is set to a specific gateway that may not have seen any traffic in that window.
Why do some devices show a manufacturer name instead of a friendly name? Devices that are not registered in the system are identified by their hardware characteristics (manufacturer, model). If you regularly see a device and want to give it a label, it can be registered in the Ambient Devices section under Admin.
What does a "weak" signal (red RSSI) mean? The badge or device was at the edge of the gateway's detection range when the event was recorded. Weak signals are normal when a person is far from a gateway. If you see consistently weak signals for a person in a known location, the gateway coverage in that area may need review.
A specific person is not appearing in the Activity Log during a time I know they were present. Check:
- Whether the badge was assigned to that person and is functioning (see Battery Health)
- Whether the gateways in that area were online during that time (see Gateways)
- Whether the time range filter covers the period in question
How long is activity history retained? Data retention depends on your system configuration. Contact your administrator to confirm the retention policy.
Related Pages
- Gateways — Verify gateway status when expected events are missing
- Battery Health — Investigate badge issues if a device stops appearing
- Analytics — Analyse activity trends over longer time periods