Analytics
The Analytics page is a customisable dashboard for visualising system data over time. You can build a personal workspace of charts and statistics — line charts, bar charts, heatmaps, gauges, and more — to monitor trends in device activity, gateway performance, and signal quality. Panels can be resized, rearranged, and configured to show exactly the data you need.
Getting to Analytics
From the main navigation, select Analytics under the Monitoring section.
Permissions note: Viewing analytics requires the
analytics.readpermission. Creating or modifying dashboards requiresanalytics.createandanalytics.update. Contact your administrator if you need access.
Page Overview
Screenshot placeholder: Analytics page — default dashboard with four panels
When you first open Analytics, the default dashboard loads with four pre-built panels:
| Panel | Type | Description |
|---|---|---|
| Event Traffic | Line chart | Hourly BLE event counts over the selected time range |
| Active Devices | Statistic | Count of unique devices seen in the time range |
| Avg RSSI | Statistic | Average signal strength across all detections |
| Events by Gateway | Bar chart | Event count per gateway, for comparing coverage |
| Devices by Department | Pie chart | Distribution of tracked devices by department |
These panels give a useful starting overview and can be modified or removed as needed.
Selecting a Time Range
A time range selector at the top of the page controls the period covered by all panels simultaneously.
Available options:
| Label | 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 |
To change the time range:
- Click the time range dropdown in the toolbar.
- Select the desired period.
- All panels reload with data for the new range.
Auto-Refresh
The toolbar includes an Auto-Refresh setting. When enabled, all panels reload on a set interval without requiring a manual action.
- Click the auto-refresh selector.
- Choose an interval (for example, every 1 minute, 5 minutes, or 15 minutes).
- Select "Off" to disable auto-refresh.
Auto-refresh is useful on displays used for ongoing monitoring (for example, a security desk or operations room screen).
Chart Types
When adding or editing a panel, you choose a chart type. The available types are:
| Type | Best used for |
|---|---|
| Line Chart | Showing trends over time (e.g. event traffic rising or falling) |
| Bar Chart | Comparing values across categories (e.g. event count per gateway) |
| Pie Chart | Showing proportions at a point in time (e.g. devices by department) |
| Doughnut Chart | Same as pie, with a hollow centre — often easier to read at a glance |
| Heatmap | Gateway-by-hour signal strength matrix — shows patterns across time and location simultaneously |
| Gauge | Displaying a single value against a scale (e.g. system health score from 0–100%) |
| Radar | Comparing multiple metrics for up to 5 gateways side-by-side on a web/spider chart |
| Area + Zoom | A line chart with a scrollable zoom control — useful for exploring long time periods |
| Statistic | A large single-number display for a key metric (e.g. total events, active devices) |
| Table | Raw data displayed as a scrollable table inside a dashboard panel |
Data Sources
Each panel draws from one of the following data sources:
| Data Source | What it contains |
|---|---|
| Traffic Overview | Hourly event counts with unique device counts and average RSSI |
| Gateway Performance | Per-gateway event counts, unique devices seen, and average signal strength |
| Device Distribution | Device counts grouped by department and entity type |
| System Summary | Aggregate metrics: total events, active devices, average RSSI, online gateways |
| Custom Query | Build your own query — choose a metric, field, time interval, and optional grouping |
Custom Query Options
When selecting Custom Query as the data source, additional configuration options appear:
Metric — What to calculate for each time bucket:
| Metric | Meaning |
|---|---|
| Count | Total number of events |
| Average | Average value of the selected field |
| Minimum | Lowest value in the time bucket |
| Maximum | Highest value in the time bucket |
| Sum | Total of all values |
| Distinct Count | Number of unique values (e.g. unique devices) |
Field — Which data field to apply the metric to:
| Field | Description |
|---|---|
| Event ID | Unique event identifier (use with Count for event totals) |
| RSSI | Signal strength in dBm |
| Transmitter ID | Badge or device identifier (use with Distinct Count for unique devices) |
| Receiver ID | Gateway identifier |
| Number of Decodings | How many times each signal was decoded |
Time Interval — The size of each time bucket:
| Interval | Typical use |
|---|---|
| 1 Minute | Very recent, high-resolution data |
| 5 Minutes | Short-term monitoring |
| 15 Minutes | Intra-day operational view |
| 1 Hour | Standard daily trending |
| 1 Day | Week or month view |
| 1 Week | Long-term trends |
Group By — Optionally split each time bucket by a dimension:
| Group By | Effect |
|---|---|
| None | Single line or bar per time bucket |
| Receiver / Gateway | One series per gateway |
| Transmitter / Device | One series per device |
| Device Type | One series per device category |
| Building | One series per building |
| Floor | One series per floor |
Filter by Gateway — Optionally restrict the query to a specific gateway.
Adding a Panel
- Click the Edit button (pencil icon) in the toolbar to enter edit mode.
- Click Add Panel (the plus icon or "Add Panel" button).
- A configuration form appears. Fill in:
- Title — A short descriptive name for the panel
- Chart Type — Choose from the list above
- Data Source — Choose a pre-built source or Custom Query
- If using Custom Query, configure Metric, Field, Interval, and Group By as needed
- Unit — Optional label to append to values (e.g. " dBm", " events")
- Click Save to add the panel to the dashboard.
- The new panel appears in the grid and loads its data automatically.
Screenshot placeholder: Add panel configuration form
Resizing a Panel
While in Edit mode:
- Hover over the panel you want to resize.
- A resize handle appears at the bottom-right corner of the panel.
- Click and drag the handle to change the panel's width and height.
- Release to confirm the new size.
Panel sizes are defined in grid units (columns wide, rows tall). The dashboard grid is 12 columns wide. A full-width panel would span all 12 columns.
Moving a Panel
While in Edit mode:
- Click and hold the panel's title bar.
- Drag the panel to the desired position in the grid.
- Other panels shift automatically to accommodate the new position.
- Release to drop the panel in place.
Editing a Panel
While in Edit mode:
- Click the configure icon (gear or pencil) that appears on a panel when hovering.
- The panel configuration form opens with the current settings loaded.
- Adjust the title, chart type, data source, or query options as needed.
- Click Save to apply changes.
Removing a Panel
While in Edit mode:
- Click the remove icon (X or trash icon) that appears on a panel when hovering.
- The panel is removed from the dashboard immediately.
Note: Removing a panel is permanent for the current session. If you have not saved the dashboard layout, you can reload the page to restore the default layout.
Saving the Dashboard Layout
After making changes to panels (adding, moving, resizing, or removing), save the layout so it persists for your next visit.
- Click the Save Layout button in the toolbar while in edit mode.
- A confirmation notification confirms the layout was saved.
Tip: Save your layout before leaving the page. Unsaved changes are lost if you navigate away or refresh.
Exiting Edit Mode
- Click the Done Editing button (or toggle the edit mode button off) in the toolbar.
- The drag handles and resize controls disappear.
- Panels return to their read-only display mode.
Exporting Analytics Data
Each panel has export options accessible from its header menu (three-dot or gear icon):
- Export CSV — Downloads the raw data powering that panel as a comma-separated values file.
- Export JSON — Downloads the data in JSON format, useful for importing into other tools.
- Export PDF / Print — Sends the current dashboard view to your browser's print dialog.
You can also use the global Export buttons in the main toolbar to export all visible panel data at once.
Understanding the System Health Score (Gauge Panel)
When you add a Gauge panel and select the System Summary data source, it can display an overall system health score from 0 to 100. This score is calculated from three factors:
| Factor | Contribution |
|---|---|
| Gateway online percentage | What fraction of gateways are currently online |
| Device activity | Whether any devices have been active in the time range |
| Average RSSI health | How strong the average signal strength is across the system |
A score above 80 indicates a healthy system. A low score warrants checking the Gateways page and Battery Health page for issues.
Understanding the Heatmap Panel
The heatmap displays a grid where:
- Rows represent gateways (receivers)
- Columns represent time buckets (hours)
- Cell colour represents the average RSSI value during that hour for that gateway
Darker or more saturated colours indicate stronger signal activity. Light or empty cells indicate low or no activity. This view is useful for:
- Identifying which gateways are consistently busy throughout the day
- Spotting times when activity drops unexpectedly
- Comparing coverage patterns across different areas of the building
Understanding the Radar Panel
The radar (spider) chart compares up to 5 gateways across four dimensions simultaneously:
- Event count
- Unique devices seen
- Average RSSI
- Uptime (online/offline status)
Gateways that score well on all four dimensions appear as larger shapes. A gateway with a small radar footprint may need investigation or may simply cover a low-traffic area.
Data Caching
To reduce server load, the Analytics page caches query results for 30 seconds. If you run the same query again within 30 seconds, the cached result is returned instantly. The cache clears automatically after 30 seconds, so subsequent requests always fetch fresh data.
If you need to force fresh data immediately, change the time range selector briefly and then change it back — this invalidates the cache for your current query.
Frequently Asked Questions
My panel shows no data even though I know there is activity. Check that your selected time range covers the period when activity occurred. Also confirm that the data source and metric combination makes sense for the chart type — for example, a pie chart works best with a categorical grouping, not a time series.
Can I have multiple saved dashboards? The system supports multiple saved dashboards. Use the dashboard management controls (if available in your account) to create, name, and switch between different dashboard layouts. Contact your administrator if you do not see dashboard management options.
The heatmap looks empty — why? The heatmap requires sufficient historical data with gateway-level detail. If your system has been running for less than a few hours, or if RSSI data is not being stored, the heatmap will appear sparse or empty.
How do I get a printed report of the whole dashboard? Click the Print button in the toolbar. Your browser will open a print dialog with the current dashboard layout formatted for printing.
Related Pages
- Activity Log — Row-level event data for investigation
- Gateways — Gateway status and connectivity
- Battery Health — Device battery fleet overview