VNSTAT(1) User Manuals VNSTAT(1) (NAME) vnstat - (SYNOPSIS) vnstat [-5bDedhlmqstvy?] [--95th] [--add] [--alert output exit type condition limit unit] [--begin date] [--config file] [--days [limit]] [--db file] [--dbdir directory] [--dbiflist [mode]] [--debug] [--end date] [--fiveminutes [limit]] [--help] [-hg] [--hours [limit]] [--hoursgraph] [-i interface] [--iface interface] [--iflist [mode]] [--json [mode] [limit]] [--limit limit] [--live [mode]] [--locale locale] [--longhelp] [--merge source destination] [--months [limit]] [--oneline [mode]] [--query [mode]] [--rateunit [mode]] [--remove] [--rename name] [-ru [mode]] [--setalias alias] [--short] [--showconfig] [--style number] [--top [limit]] [-tr [time]] [--traffic [time]] [--version] [--xml [mode] [limit]] [--years [limit]] [interface].SH (DESCRIPTION) vnStat . () . . proc(5) sys . vnStat root . . vnstat vnstatd(8) (caching) . . (OPTIONS) --95th (95th percentile) . . . 5MinuteHours 744 . --add -i --iface. RescanDatabaseOnSave SaveInterval . . --alert output exit type condition limit unit . output 0 3 . '0' '1' '2' limit '3' limit . exit 0 5 . '0' 0 '1' 1 '2' limit 1 0 '3' limit 1 0 . '4' '5' '2' '3' 1 2 . 1 . type limit . : 'h' 'hour' 'hourly' 'd' 'day' 'daily' 'm' 'month' 'monthly' 'y' 'year' 'yearly' 'p' '95' '95%'. condition limit (rx) (tx) . : 'rx' 'tx' 'total' 'rx_estimate' 'tx_estimate' 'total_estimate'. type . limit unit . unit : 'B' 'KiB' 'MiB' 'GiB' 'TiB' 'PiB' 'EiB' 'KB' 'MB' 'GB' 'TB' 'PB' 'EB'. type : 'B/s' 'KiB/s' 'MiB/s' 'GiB/s' 'TiB/s' 'PiB/s' 'EiB/s' 'kB/s' 'MB/s' 'GB/s' 'TB/s' 'PB/s' 'EB/s' 'bit/s' 'Kibit/s' 'Mibit/s' 'Gibit/s' 'Tibit/s' 'Pibit/s' 'Eibit/s' 'kbit/s' 'Mbit/s' 'Gbit/s' 'Tbit/s' 'Pbit/s' 'Ebit/s'. limit . limit . condition output exit . --alert . -b, --begin date / date . date . date : YYYY-MM-DD HH:MM YYYY-MM-DD "today". --json --xml . --config file file . --config . -d, --days [limit] . limit . limit 0 . --db file file ( ). --dbdir . --dbdir directory directory ( ). --db . --dbiflist [mode] . mode 0 (verbose) . mode 1 mode 2 . : --iflist..TP -D, --debug . -e, --end date / date / . date . date : YYYY-MM-DD HH:MM YYYY-MM-DD. --json --xml . . . date . --begin . -5, --fiveminutes [limit] . limit . limit 0 . -h, --hours [limit] . limit . limit 0 . -hg, --hoursgraph . -i, --iface interface interface . interface1+interface2+... . . InterfaceMatchMethod interface alias --setalias . alias . -i, --iface interface . --iflist [mode] . mode 0 . mode 1 mode 2 . : --dbiflist. --json [mode] [limit] json. . mode . . mode 's' 'f' 'h' 'd' 'm' 'y' 't' 'p' . mode limit . --json -l, --live -tr mode limit . jsonversion API . . vnstatversion . --limit limit limit. --limit limit . limit 0 . --limit --json --xml . -l, --live [mode] . . mode ( 0) ( 1) . --style . --json json . --locale locale locale . --longhelp . --merge source destination source destination. source destination . destination . destination source . destination . source . destination . . ..IP source destination file:interface : . source source destination . destination . -m, --months [limit] . limit . limit 0 . --oneline [mode] . ; . API . : ) ) ) rx ) tx ) ) ) ) rx ) tx ) ) ) rx ) tx ) . mode . -q, --query [mode] . mode . 'a' . 's' . mode QueryMode . --remove -i --iface . . --rename name -i --iface name. . . . -ru, --rateunit [mode] . . . mode 0 1 (0) (1) . --setalias alias alias . alias . . -s, --short . . --showconfig . --style number . number 0 1 2 3 . 4 -l, --live -tr, --traffic . -t, --top [limit] . limit . limit 0 . --begin --end . . -tr, --traffic [time] time . time . --json json . . --style . -v, --version . --xml [mode] [limit] xml. . mode . . mode 's' 'f' 'h' 'd' 'm' 'y' 't' 'p' . mode limit . xmlversion API . . vnstatversion . -y, --years [limit] . limit . limit 0 ..TP -?, --help . (FILES) /var/lib/vnstat/ . /etc/vnstat.conf $HOME/.vnstatrc . vnstat.conf(5) . (EXAMPLES) vnstat ( ). vnstat -i eth0+eth1+eth3 eth0 eth1 eth3. vnstat -i eth2 --xml eth2 xml. vnstat --json json. vnstat -i eth0 --setalias local <> eth0. eth0 . vnstat -i eth2 --remove eth2 . (RESTRICTIONS) . . 4 GiB . . : 10 Mbit: 54 100 Mbit: 5 1000 Mbit: 30 (aliased) . eth0:0 eth0:1 eth0:2 eth0 . . (AUTHOR) Teemu Toivola (SEE ALSO) vnstatd(8), vnstati(1), vnstat.conf(5), proc(5), ifconfig(8), units(7) version 2.13 FEBRUARY 2025 VNSTAT(1)