Overview
Sessions let you record telemetry data over a defined period. They are designed for professional use: documenting installations, tracking performance during travel, and creating reports for clients.
Starting a Session
- Navigate to the Sessions view from the sidebar
- Click the Record button in the toolbar
- Enter a session name (e.g. “Starlink Mini Test”)
- Optionally set a duration limit or leave as Unlimited
- Recording begins immediately
During recording, the toolbar shows a red indicator with the session name and elapsed time.
Recording Options
- Duration: Set a time limit or record indefinitely
- Speed Tests: Toggle automatic speed test recording
- GPS Interval: Set how frequently GPS coordinates are captured (1s default)
What Gets Recorded
| Data | Description |
|---|---|
| Telemetry | Download, upload, latency, drop rate, power, satellites, every polling interval |
| GPS coordinates | Latitude, longitude tracked throughout the session |
| Markers | Timestamped events (session start, speed changes, outages, notes) |
| Speed test results | Any speed tests triggered during recording |
During Recording
While recording, two sub-views are available:
Charts View
The same streaming charts as the main dashboard (download, upload, latency, drop rate, power) but scoped to the session duration.
Route View
An interactive map showing your GPS route in real-time. The route is colour-coded by latency quality:
| Colour | Latency |
|---|---|
| Green | < 30 ms |
| Yellow | 30–60 ms |
| Orange | 60–150 ms |
| Red | > 150 ms |
| Grey | No data |
Adding Markers
Use the marker buttons in the toolbar to tag points of interest during recording:
- Tunnel In / Tunnel Out: Mark when entering or exiting a tunnel
- Obstruction: Flag an obstruction event
- Weather: Note a weather change
- Speed Change: Mark a speed change
- Location: Tag a specific location
- Note: Add a free-text note
- Speed Test: Record a speed test result
- Outage: Mark a connection drop
Saved Sessions
After stopping a recording, the session appears in the Saved tab of the session panel. The panel shows:
- Session name with a terminal type badge (e.g. “Mini”)
- Date, time, and duration
- A search bar for finding sessions by name
Click a saved session to load it for review. The charts and route map populate with the recorded data.
Session Summary
The summary panel shows:
- Start and end timestamps with duration
- Average and peak download/upload speeds
- Average latency and best latency
- Average drop rate and average power
- Data points, GPS points, and query time
Exporting Sessions
Click the Export dropdown to save session data:
| Format | Description |
|---|---|
| JSON | Full telemetry data with timestamps for programmatic analysis |
| CSV | Spreadsheet-compatible format |
| Excel | Native .xlsx with separate sheets for telemetry, markers, and summary |
| PDF Report | Branded multi-page report (see below) |
PDF Reports
The PDF report generates a professional document containing:
- Cover page: Nexus Pro branding, session name, date/time range, duration, and location
- Performance summary: Key statistics in a structured layout
- Performance charts: Download, upload, and power consumption charts over the session duration
- Outage summary: Any outages recorded during the session
- Route map: GPS route plotted on a map, colour-coded by latency quality, with distance and GPS point count
The report footer shows generation timestamp and nexustelemetry.com branding.