vnStat 2.12

• Fixed
  • QueryMode documentation in configuration file didn't match implementation
    or man page description
  • Daemon didn't try to import legacy databases when --noadd was used and no
    current version database initially existed resulting in the process
    exiting even when something could have been done
  • Daemon didn't try to import legacy databases when --initdb was used and
    no current version database initially existed, this behaviour can still
    be enabled by using --noadd in combination with --initdb
  • Using --nodaemon and --initdb at the same time didn't result in an error
    being shown
• New
  • Add 95th percentile output as --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
  • Add --json support for --alert
  • Database queries resulting in error exit with status 1
  • Show spinning animation at the beginning of -l / --live output line,
    visibility configurable using LiveSpinner configuration option
  • Add -ic / --invert-colors option to image output for facilitating for
    example dark mode switching without needing to have multiple separate
    color configurations
  • Add dark mode option to image output example cgi (examples/vnstat.cgi)
  • Add option 4 to QueryMode for selecting summary output of single
    interface regardless of the number of interfaces in the database
  • Add optional mode parameter to -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
  • Add --startempty option to daemon for starting and keeping the daemon
    running even if no interfaces were discovered and the database is empty
  • Add --noremove option to daemon for disabling the automatic removal of
    interfaces from database that aren't currently visible and haven't seen
    any traffic
  • Add third mode option to --iflist and --dbiflist for getting only the
    interface count as output

vnStat 2.11

• Fixed
  • Database queries worked only if SQLite double-quoted string (DQS)
    feature (https://www.sqlite.org/quirks.html#dblquote) was enabled
  • Disabling data resolutions in data retention configuration didn't result
    in possibly existing database entries getting removed from the database
  • Disabling data resolutions in data retention configuration didn't result
    in the data resolution getting disabled but instead storing data forever
  • expr: syntax error during configure in BSD (pull request by namtsui)
  • Image output summary would show only "no data available" text in case of
    zero total traffic even when the historical data of no traffic could have
    been shown instead
  • Image output -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 output
  • Configuration validation was too heavily limiting and enforcing image
    output 5 minute graph related configuration options for combinations that
    would have resulted in usable images
• New
  • Database cleanup has been changed to interpret data retention
    configuration as number of entries to be kept instead of calendar time,
    this restores the behaviour to similar as it was up to version 1.18, the
    difference is visible only on systems that aren't powered all the time
  • Database is vacuumed during daemon startup and reload, behaviour is
    configurable using VacuumOnStartup and VacuumOnHUPSignal configuration
    options
  • Add configuration option InterfaceOrder for controlling the interface
    order in outputs with multiple interfaces
  • Used data retention configuration is made visible during daemon startup
    and after configuration reloads
  • Daemon will no longer start if all data resolutions have been disabled
    in the configuration file
  • SQLite version is visible in --version outputs
• Notes
  • Not 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 active

vnStat 2.10

• Fixed
  • BandwidthDetection 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 Mbit
  • Image output of 5 minute graph wasn't possible if data retention of the
    5 minute time period was configured as unlimited
    (pull request by Sebastian Lechte)
  • Estimates and average rates weren't calculated correctly for daily,
    monthly and yearly time periods when monitoring of the interface had been
    started during the ongoing time period
  • Estimates weren't being shown in summary output when OutputStyle or
    --style was configured with a value less than 2 (vnstat)
  • Alignment of column header in short output wasn't correct when
    OutputStyle or --style was configured with the value 0 (vnstat)
• New
  • Support input of more than 31 characters in interface name when using
    interface1+interface2 syntax data merge queries
  • Support passing --config option multiple times, later files override
    earlier files if settings overlap (vnstat and vnstati)
  • Add configuration option EstimateVisible for controlling the visibility
    of the estimate line
  • Add configuration option EstimateText for modifying the default
    "estimated" text string when the estimate line is visible
  • Add --style support to -tr / --traffic output
  • Add summary option to --json and --xml outputs
  • Add timestamps to --json and --xml outputs
  • Add Prometheus compatible metrics endpoint cgi to examples
    (examples/vnstat-metrics.cgi)

vnStat 2.9

• Fixed
  • RescanDatabaseOnSave configuration option wasn't being read from the
    configuration file resulting in the feature always being enabled
  • Hourly graph image output using large fonts didn't correctly fade out
    the x-axis line for hours not having data available
• New
  • Add --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 parameters
  • Add configuration option InterfaceMatchMethod 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)
  • Image output file extension allows selecting the used image file format
    as long as the used LibGD supports it, PNG is no longer the only option
  • Add configuration option HourlyGraphMode for changing the output mode
    of the graph, 0 = 24 hour sliding window (default, as in previous
    releases), 1 = graph begins from midnight
  • Add mode parameter for -hg / --hoursgraph options for overriding the
    HourlyGraphMode configuration option setting from the command line
  • Add vertical line to image output hourly graph to visualize midnight
  • Add -t / --timestamp options to daemon for enabling timestamps to prints
    when the daemon is running in the foreground attached to a terminal
  • Accept ; as comment character in configuration file in addition to #
  • Comment out keywords which are using default values with ; character in
    provided configuration file and --showconfig output

vnStat 2.8

• Fixed
  • Using a combination of --live and --json wasn't flushing stdout after
    each line resulting in buffered output if the output was being piped
  • Image output would fail to show the last line bar graph in list outputs
    if EstimateStyle was 0, BarColumnShowsRate was 1 and the last line had a
    higher traffic rate than other lines
  • Image output didn't correctly horizontally align the "no data available"
    message in 5 minute graph depending on the width of the image
  • Image output related configuration warnings could get shown when image
    output wasn't being used
  • Warnings of mismatches between image output and data retention
    configuration didn't provide relevant details for solving the issues
  • BandwidthDetection 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 fallback
  • Configured interface specific MaxBW values were getting overridden by
    BandwidthDetection when something could be detected
  • Image output horizontal rx/tx bars often had one pixel too much width in
    the tx section resulting in slightly wrong ratio getting shown
  • Top days list wasn't always sorting entries with exactly the same traffic
    sum using ascending date
  • 64bitInterfaceCounters 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
• New
  • Add the possibility of specifying an interface without using the
    -i / --iface options (vnstat and vnstati)
  • The daemon can discover added interfaces from the database without
    requiring a restart, configurable with option RescanDatabaseOnSave
  • Add configuration option 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 detected
  • Add configuration option AlwaysAddNewInterfaces to expose the daemon
    --alwaysadd command line option which gains an optional mode parameter
  • Image output uses LibGD filled arc bug workaround only for LibGD
    versions that are known to be broken
  • Image output example cgi (examples/vnstat.cgi) improvements
    • Automatically lists all monitored interfaces instead of requiring the
      list to be filled manually, server name in page title comes from
      hostname command by default
    • Provides links for most available images to more detailed or longer
      versions of each image
    • Allows direct interface specific page access with /interfacename suffix
      for the cgi if the used httpd supports PATH_INFO
    • Page auto refresh can be enabled with configurable interval

vnStat 2.7

• Fixed
  • Possibility of segmentation fault with image list output when database
    existed but no data was available
  • ./configure output could show invalid install paths with some parameter
    combinations (pull request by Severin Glöckner)
  • Columns in text hours graph output could get misaligned if the selected
    system locale used a UTF-8 sequence for the thousands separator instead
    of a single character
• New
  • Add -5g / --fivegraph options to image output with sizing related
    parameters for the output of a 5 minute resolution bar graph
  • Add configuration option SummaryGraph 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
  • Add --large / --small options and configuration option LargeFonts for
    controlling the image output font size
  • Add --scale and configuration option ImageScale for scaling the image
    output to a given percent
  • Add configuration option LineSpacingAdjustment for adjusting the line
    spacing of list format image outputs
  • Add bar visualizations for traffic estimations in image output
  • Allow writing image output to a filename starting with -
  • Add --initdb to daemon for creating a new empty database without having
    the daemon process staying running, doesn't discard data if a database
    already exists
  • Add configuration option BarColumnShowsRate 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
  • Add --dbiflist for getting a list of interfaces in the database, both
    --iflist and --dbiflist also get alternative more parseable outputs
  • Add configuration option for large font output and make 5 minute
    resolution graph visible in vnstat.cgi

vnStat 2.6

• Fixed
  • --json and --xml didn't support having both mode and limit parameters
    defined at the same time as documented, broken since previous release
  • Documentation was using a mix of "count" and "limit" for the option of
    limiting the maximum number of shown entries in queries
  • Summary image output would segmentation fault when the database existed
    but didn't yet contain any daily or monthly data for the selected
    interface
• New
  • Add --limit as an alternative way for controlling the length of outputs

vnStat 2.5

• Fixed
  • Automatic interface selection wasn't done for --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

vnStat 2.4

• Fixed
  • Daemon didn't correctly wait when acquiring database lock for data write
    which could result in unnecessary errors and even process exit if an
    external database read operation had exactly the same timing as the
    daemon write operation
  • Daemon didn't fork() even when requested to with --daemon when started
    by PID 1 (issue seen at least in Docker containers)
  • Move vnstatd man page from section 1 to section 8
• New
  • Add --rename for renaming interfaces already existing the database

vnStat 2.3

• Fixed
  • Traffic rate wasn't being shown for the last entry of most lists during
    the first update of the next period (first SaveInterval minutes of each
    new hour, day, month and year)
  • Systemd example service file could result in database file write issues
    if the used systemd version supported ProtectSystem=strict but didn't
    support StateDirectory (issue seen at least with systemd 232 in Debian 9)
  • Debian and Red Hat init.d example files had wrong path for the pid file
  • Interfaces could end up staying marked as 'disabled' in the database even
    after becoming back active and monitored, only the shown status was wrong
    without resulting in any data loss
  • Some image outputs didn't allocate enough height for the image resulting
    in the last row having less space below it than intended
• New
  • Automatic interface selection when the Interface configuration setting
    is left empty (new default)
  • Add configuration option 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 operations
  • Add configuration option DatabaseSynchronous for changing the SQLite
    setting of the "synchronous" flag, see
    https://www.sqlite.org/pragma.html#pragma_synchronous for more details
  • Show warning in log if writing cached data to database is slow
  • Try database query for up to 5 seconds when database is busy or locked
    instead of giving up immediately
  • Continue daemon process execution with data caching if database writes
    fail due to disk being full