Skip to content

Reports Dashboard and Footer

alexphillips-dev edited this page Nov 4, 2026 · 1 revision

Reports, dashboard, and footer

The main page offers text metrics, vnStat-generated images, or both. Images require the host's image-generation support. The traffic overview stays visible; the Detailed Reports section starts collapsed. Expand it, then select a period's arrow to read the detailed report. Refreshes preserve whether the section is open or closed. The dashboard summarizes the primary interface. The footer's miniature period can be five minutes, hour, day, month, or year. The bottom-bar download arrow is green and the upload arrow is blue, with extra spacing between the two traffic values. Threshold colors on the values retain their normal meaning.

The footer, dashboard, and report refreshes wait for their current requests to settle before scheduling another batch. Requests time out after 15 seconds; failed or incomplete measurement queries retain the last valid sample and show a stale/error indication with the last successful refresh time. A valid sample with an unavailable threshold remains valid traffic data; the threshold itself is shown as unknown. Navigating away cancels pending refreshes.

Virtual, removed-interface, and matching settings affect available rows before filtering. Matching is case-sensitive. Container/VM name matching requires virtual service matching to be enabled.

Filter Meaning
Empty Show rows permitted by the other visibility settings.
eth0;Grafana Show rows matching either the interface or service name.
Grafana+Prometheus Match a row whose service labels include both names.
Grafana!Prometheus Include Grafana unless that row also has the excluded label.

A semicolon separates alternatives. Combined +/! expressions operate on matched service labels. Interface mappings are best-effort snapshots; prefer physical interfaces for important automation.

Understanding the two report views

The visible upper table is the quick traffic overview. The lower detailed vnStat reports are grouped in Detailed Reports, collapsed initially. Expand the section and then a period's triangle to read its report. These are two presentations of the same interface data, rather than separate accounting databases.

Text, image, and dual selections control the detailed report content. A valid traffic sample can coexist with an unknown threshold result; that is different from a failed measurement refresh. Stale status means the displayed retained sample is older than the failed refresh attempt.

Clone this wiki locally