Traffic & Insights
The Traffic view (/admin/traffic) is where you see how much data your devices
are moving and where that data is going. It groups several related tools into one
page with a row of tabs at the top:
- Traffic — a live list of active connections
- Insights — where each device's traffic is going, by country, ASN, and destination
- Bandwidth Summary — total data used per device (WAN and LAN)
- Bandwidth Timeseries — bandwidth charts over time
Switch tabs with the buttons at the top of the page. The two Bandwidth tabs are only shown in the web app, not the iOS app.
Traffic
The Traffic tab shows a live list of the connections currently tracked by the router. Each row is a source/destination pair with the number of bytes and packets counted for it. The list refreshes automatically every few seconds, so you can watch activity as it happens.
Use the radio buttons to filter by direction:
- Wan Out — traffic leaving your network to the internet
- Wan In — traffic coming from the internet to a device
- Lan In / Lan Out — traffic between local devices
For WAN traffic, the router looks up the ASN (network operator) of the remote address and shows it next to the connection. Domains are filled in from recent DNS lookups when available.
To focus on a single device, pick it from the client selector. The selected IPs appear
as badges; tap a badge to remove it, or Clear to drop all filters. Filtering by a
client updates the address bar (/admin/trafficlist/<ips>) so you can bookmark or share
the filtered view.
Insights
The Insights tab (/admin/traffic_insights) answers the question "where is my
device's traffic actually going?" Instead of listing individual connections, it rolls
external traffic up by destination and shows it broken down four ways:
- Countries — grouped by the destination country, with a flag and device count
- ASNs — grouped by network operator (for example a cloud or CDN provider)
- Devices — your local devices, sorted by total bytes
- Containers — the same, for SPR's own container traffic
Each row shows bytes down (in) and up (out) and a bar indicating its share of total traffic. Expand a Country or ASN row to see which of your devices contributed and the top networks involved.
Use the time-range buttons to change the window: Last hour, 24 hours, or 7 days. The totals down/up for the whole window are shown at the top.
Drilling into a device
Tap any device to open its detail view (/admin/traffic_insights/<ip>). This lists the
individual destinations that device talked to in the selected window — domain name, IP,
ASN, and country — each with its bytes in/out, share bar, and how long ago it was last
seen. Use Back to return to the overview.
Blocking a country or ASN
From a Country or ASN row you can press Block to add it to the geo/ASN deny list. This ties into Firewall → ASN/Geo Block; if geo blocking is currently disabled the rule is saved but not enforced until you enable it there. Use Unblock to remove a rule. The Blocking button jumps straight to the firewall settings.
Enabling and retention
Insights collection is on by default and keeps 7 days of history. Retention is
configurable from 1 to 90 days through the /traffic_insights/config API endpoint,
which also lets you turn collection off entirely. History is bucketed by the hour, so
newly collected traffic appears within a few minutes.
Country and ASN enrichment relies on the lookup plugin container. If that container isn't running, destinations still appear by IP but without country flags or network names.
Bandwidth Summary
The Bandwidth Summary tab (/admin/traffic/summary) answers "which devices used the
most data?" It shows two bar charts — Device WAN Traffic and Device LAN Traffic —
with one bar per device and its total incoming (Down) and outgoing (Up) bytes. Each chart
has its own time-range selector (All Time, 15 Minutes, 1 Hour, or 1 Day);
"All Time" reads the cumulative counters while the shorter ranges are computed from the
rolling history. Hovering a bar shows the device name, MAC, and exact size.
This differs from Insights: Bandwidth Summary tells you how much each device transferred, while Insights tells you where that traffic went.
This tab is fully featured in the web admin UI. In the iOS/Android apps it is currently a placeholder — use the Bandwidth Timeseries tab there for per-device history.
Bandwidth Timeseries
The Bandwidth Timeseries tab (/admin/timeseries) charts per-device bandwidth over
time. There is one chart for each direction — WAN outgoing, WAN incoming,
LAN incoming, and LAN outgoing — with each device drawn as its own colored band.
The router samples per-device byte counters once a minute and keeps rolling history (the last 60 minutes, 24 hours, and 30 days). For each chart you can:
- Change the time scale — 15 Minutes, 1 Hour, 1 Day, or All Time
- Switch between showing each device's percent share of total change or its raw byte delta
This is the best tab for spotting which device was responsible for a spike in usage and when it happened.