vnstati

Output a summary of the last 2 months, days, and all-time

$ vnstati --summary --iface [network_interface] --output [path/to/output.png]

$ vnstati --top 10 --iface [network_interface] --output [path/to/output.png]

$ vnstati --months --iface [network_interface] --output [path/to/output.png]

$ vnstati --hours --iface [network_interface] --output [path/to/output.png]

vnstati [options] -o file | --output file

vnstati generates PNG images from vnStat network traffic data, providing visual representations of bandwidth usage. It reads the same database as vnstat and outputs graphical summaries suitable for web pages or reports.
The tool supports various time ranges (hourly, daily, monthly, yearly) and can generate traffic summaries, top usage days, and 5-minute resolution graphs. Multiple style options allow customization of appearance.

-i, --iface interface

Select interface to use

Output filename (PNG format)

Output traffic summary

Output top days by traffic

Output hourly traffic statistics

Output daily traffic statistics

Output monthly traffic statistics

Output yearly traffic statistics

Output 5-minute resolution statistics

Modify visual appearance (0-4)

Update output only if database is newer than time

Custom header text

Toggle background transparency

Requires vnstat daemon to be running and collecting data. Output is PNG format only. The interface must have existing traffic data in the vnstat database.

Part of the vnStat project by Teemu Toivola. vnstati was added to provide graphical output capabilities, commonly used for generating bandwidth graphs for web-based monitoring dashboards and reports.

vnstat(1), nethogs(8), iftop(8)