Releases · vergoh/vnstat

Fixed
- Opening of body html tag was missing on some pages in image output
  example cgi (examples/vnstat.cgi)
New
- Add database data merge support as --merge
- Add --db for specifying database file for queries (vnstat and vnstati)
- Add exit status 2 options to --alert for making it possible to
  differentiate alerts from errors (exit status 1)
- Add --dbiflist also to vnstati command
- Image output example cgi (examples/vnstat.cgi) improvements
  - Remove dependency to vnstat command
  - Add option for selecting how many images are shown per row on the index
    page when the database has more than one interface
  - Add option for selecting which image output is used on the index page
    when the database has more than one interface
  - Add options for selecting which interfaces are shown or hidden from the
    index page without disabling access to all interface specific page when
    the database has more than one interface
  - Harmonize layout style between pages

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

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

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)

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

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

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

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

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

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

Releases: vergoh/vnstat

vnStat 2.13

Uh oh!

vnStat 2.12

Uh oh!

vnStat 2.11

Uh oh!

vnStat 2.10

Uh oh!

vnStat 2.9

Uh oh!

vnStat 2.8

Uh oh!

vnStat 2.7

Uh oh!

vnStat 2.6

Uh oh!

vnStat 2.5

Uh oh!

vnStat 2.4

Uh oh!