vnStat - a network traffic monitor for Linux and BSD
QueryMode
documentation in configuration file didn't match implementation
or man page description--noadd
was used and no
current version database initially existed resulting in the process
exiting even when something could have been done--initdb
was used and
no current version database initially existed, this behaviour can still
be enabled by using --noadd
in combination with --initdb--nodaemon
and --initdb
at the same time didn't result in an error
being shown--95th
, also available via --alert
, --json
,
--xml
and image output, requires 5MinuteHours
configuration to be set to
at least 744 for storing all the necessary data--json
support for --alert
-l
/ --live
output line,
visibility configurable using LiveSpinner
configuration option-ic
/ --invert-colors
option to image output for facilitating for
example dark mode switching without needing to have multiple separate
color configurationsexamples/vnstat.cgi
)QueryMode
for selecting summary output of single
interface regardless of the number of interfaces in the database-q
/ --query
for overriding QueryMode
for summary output and for enabling control of summary output style
regardless of the number of interfaces in the database--startempty
option to daemon for starting and keeping the daemon
running even if no interfaces were discovered and the database is empty--noremove
option to daemon for disabling the automatic removal of
interfaces from database that aren't currently visible and haven't seen
any traffic--iflist
and --dbiflist
for getting only the
interface count as outputexpr: syntax error
during configure in BSD (pull request by namtsui)-o -
content could get corrupted due to info, warning and
error messages also using stdout, configuration file warnings being the
most likely source, now uses stderr in image outputVacuumOnStartup
and VacuumOnHUPSignal
configuration
optionsInterfaceOrder
for controlling the interface
order in outputs with multiple interfaces--version
outputsNot enough data available yet.
message has been replaced with
No data. Timestamp of last update is same YYYY-MM-DD HH:MM:SS as of database creation.
to better explain the reason why there's nothing to show, this message
is expected to disappear within configured SaveInterval
if the interface is activeBandwidthDetection
in BSD wasn't correctly converting kernel reported
bits per second values to Mbits per second resulting in a sanity check
being triggered and detected values not being used expect for PPPoE
interfaces which incorrectly were detected as 64000 MbitOutputStyle
or
--style
was configured with a value less than 2 (vnstat
)OutputStyle
or --style
was configured with the value 0
(vnstat
)interface1+interface2
syntax data merge queries--config
option multiple times, later files override
earlier files if settings overlap (vnstat
and vnstati
)EstimateVisible
for controlling the visibility
of the estimate lineEstimateText
for modifying the default
"estimated" text string when the estimate line is visible--style
support to -tr
/ --traffic
output--json
and --xml
outputs--json
and --xml
outputsexamples/vnstat-metrics.cgi
)RescanDatabaseOnSave
configuration option wasn't being read from the
configuration file resulting in the feature always being enabled--alert
for producing output and/or specific exit status when
configured condition and transfer limit is exceeded, can also be used
for "quota remaining" type of queries depending on used parametersInterfaceMatchMethod
which allows configuring
the possibility of specifying an interface for database queries by using
its alias instead of system provided interface name, enabled by default
to support case insensitive matching of the beginning of interface
aliases (vnstat
and vnstati
)HourlyGraphMode
for changing the output mode
of the graph, 0
= 24 hour sliding window (default, as in previous
releases), 1
= graph begins from midnight-hg
/ --hoursgraph
options for overriding the
HourlyGraphMode
configuration option setting from the command line-t
/ --timestamp
options to daemon for enabling timestamps to prints
when the daemon is running in the foreground attached to a terminal;
as comment character in configuration file in addition to #
;
character in
provided configuration file and --showconfig
output--live
and --json
wasn't flushing stdout after
each line resulting in buffered output if the output was being pipedEstimateStyle
was 0
, BarColumnShowsRate
was 1
and the last line had a
higher traffic rate than other linesBandwidthDetection
was being used for tun interfaces even when the
Linux kernel had the information hardcoded to 10 Mbit regardless of the
used real interface, interface specific MaxBW
will now be used instead
or MaxBandwidth
as fallbackMaxBW
values were getting overridden by
BandwidthDetection
when something could be detected64bitInterfaceCounters
with value -2
always assumed 32-bit on Linux
systems until a 64-bit value was seen if kernel headers weren't available
when binaries were built-i
/ --iface
options (vnstat
and vnstati
)RescanDatabaseOnSave
UseUTC
for using UTC as timezone for database
entries instead of following the system timezone configuration--iflist
uses user configured interface specific MaxBW
values in the
output when available instead of showing only the kernel provided
information when detectedAlwaysAddNewInterfaces
to expose the daemon
--alwaysadd
command line option which gains an optional mode parameterexamples/vnstat.cgi
) improvements
PATH_INFO
./configure
output could show invalid install paths with some parameter
combinations (pull request by Severin Glöckner)-5g
/ --fivegraph
options to image output with sizing related
parameters for the output of a 5 minute resolution bar graphSummaryGraph
and optional parameter for
--hsummary
and --vsummary
for selecting which graph is shown next to
the summary data in the horizontal and vertical summary image outputs--large
/ --small
options and configuration option LargeFonts
for
controlling the image output font size--scale
and configuration option ImageScale
for scaling the image
output to a given percentLineSpacingAdjustment
for adjusting the line
spacing of list format image outputs-
--initdb
to daemon for creating a new empty database without having
the daemon process staying running, doesn't discard data if a database
already existsBarColumnShowsRate
for having the bar column in
image list outputs be scaled according to the average rate column values
when those values are visible, disabled by default--dbiflist
for getting a list of interfaces in the database, both
--iflist
and --dbiflist
also get alternative more parseable outputsvnstat.cgi
--json
and --xml
didn't support having both mode
and limit
parameters
defined at the same time as documented, broken since previous release--limit
as an alternative way for controlling the length of outputs--traffic
and --live
when
the Interface
configuration setting was left empty--setalias
didn't do anything when used in combination with --add
-l
/ --live
and -tr
default to first interface instead of producing an
error if a interface merge is requested--daemon
when started
by PID 1 (issue seen at least in Docker containers)--rename
for renaming interfaces already existing the databaseSaveInterval
minutes of each
new hour, day, month and year)ProtectSystem=strict
but didn't
support StateDirectory
(issue seen at least with systemd 232 in Debian 9)Interface
configuration setting
is left empty (new default)DatabaseWriteAheadLogging
to enable SQLite
Write-Ahead Logging mode which may provide some disk i/o benefits,
see https://www.sqlite.org/wal.html for more details and note that
SQLite 3.22.0 or later is required to support read-only operationsDatabaseSynchronous
for changing the SQLite
setting of the "synchronous" flag, see
https://www.sqlite.org/pragma.html#pragma_synchronous for more details