VNSTAT.CONF(5) User Manuals VNSTAT.CONF(5)NAMEvnstat.conf - vnStat configuration file
SYNOPSIS
/etc/vnstat.conf
DESCRIPTIONvnstat(1), vnstati(1) and vnstatd(1) all use the same configuration
file for configuration related settings. Some of the settings are com‐
mon for all three programs. The file consists of keyword-argument
pairs, one per line. Empty lines and lines starting with '#´ are inter‐
preted as comments and not processed. Arguments may optionally be
enclosed in double quotes (") in order to represent arguments contain‐
ing spaces. Arguments can be padded with spaces or tabulator charac‐
ters. A hardcoded default value will be used if a keyword can't be
found from the configuration file.
The configuration file is divided into three sections based on the
usage of each keyword. The first section contains keywords that are
considered generic for all commands, the second section is for daemon
related keywords and the last section for image output.
COMMON KEYWORDS
BandwidthDetection
Try to automatically detect MaxBandwidth value for each moni‐
tored interface. Mostly only ethernet interfaces support this
feature. MaxBandwidth or interface specfic MaxBW will be used
as fallback value if detection fails. 1 = enabled, 0 = dis‐
abled. (vnstat and vnstatd only)
BootVariation
Time in seconds how much the boot time reported by system kernel
can variate between updates. Value range: 0..300
CheckDiskSpace
Enable or disable the availability check of at least some free
disk space before a database write. 1 = enabled, 0 = disabled.
DatabaseDir
Specifies the directory where interface databases are to be
stored. A full path must be given and a leading '/' isn't
required.
DayFormat, MonthFormat, TopFormat
Formatting of date in available outputs. Uses the same format as
date(1). (vnstat and vnstati only)
Interface
Default interface used when no other interface is specified on
the command line. (vnstat and vnstati only)
Locale Locale setting to be used for prints. This replaces the LC_ALL
environment variable. Set to "-" or leave empty in order to use
the system default value. (vnstat and vnstati only)
MaxBandwidth
Maximum bandwidth for all interfaces. If the interface specific
traffic exceeds the given value then the data is assumed to be
invalid and rejected. Set to 0 in order to disable the feature.
Value range: 0..50000 (vnstat and vnstatd only)
MaxBW Same as MaxBandwidth but can be used for setting individual lim‐
its for selected interfaces. The name of the interface is speci‐
fied directly after the MaxBW keyword without spaces. For exam‐
ple MaxBWeth0 for eth0 and MaxBWppp0 for ppp0. Value range:
0..50000 (vnstat and vnstatd only)
MonthRotate
Day of month that months are expected to change. Usually set to
1 but can be set to alternative values for example for tracking
monthly billed traffic where the billing period doesn't start on
the first day. Value range: 1..28 (vnstat and vnstatd only)
OutputStyle
Modify the content and style of text outputs. 0 = minimal and
narrow output for terminal with limited width, 1 = normal output
with bar column visible, 2 = same as 1 except rate is visible in
summary and weekly outputs, 3 = rate column is visible in all
outputs where it is supported. (vnstat and vnstati only)
QueryMode
Default query mode when no parameters are given. 0 = normal, 1 =
days, 2 = months, 3 = top10, 4 = exportdb, 5 = short, 6 = weeks,
7 = hours and 8 = xml. (vnstat only)
RateUnit
Select which unit is used when traffic rate is visible. 0 =
bytes, 1 = bits. (vnstat and vnstati only)
RXCharacter, TXCharacter
Character used for representing the percentual share of received
and transmitted traffic in daily output. (vnstat only)
RXHourCharacter, TXHourCharacter
Character used for representing the percentual share of received
and transmitted traffic in hourly output. (vnstat only)
Sampletime
Defines how many seconds the -tr option will sample traffic.
Value range: 2..600 (vnstat only)
TrafficlessDays
Log days without any traffic to daily list. 1 = enabled, 0 =
disabled. (vnstat and vnstatd only)
UnitMode
Select how units are prefixed. This will option changes only the
prefix, not how traffic is calculated. 0 = IEC standard prefixes
(KiB/MiB/GiB/TiB), 1 = old style binary prefixes (KB/MB/GB/TB).
(vnstat and vnstati only)
UseFileLocking
Enable or disable the use of file locking during database
access. Disabling file locking may cause database corruption if
several processes are trying to write to the file at the same
time.
DAEMON RELATED KEYWORDS
BandwidthDetectionInterval
How often in minutes interface specific detection of MaxBand‐
width is done for detecting possible changes when BandwidthDe‐
tection is enabled. Can be disabled by setting to 0. Value
range: 0..30
CreateDirs
Enable or disable the creation of directories when a configured
path doesn't exist. This includes DatabaseDir , LogFile and Pid‐
File directories. The LogFile directory will be created only
when UseLogging has been set to 1. The PidFile directory will be
created only if the daemon is started as a background process.
The daemon process will try to create the directory using per‐
missions of the user used to start the process.
DaemonGroup
Specify the user to which the daemon process will switch during
startup. The user can either be the name of the group or a
numerical group id. Leave empty to disable the group switch.
This option can only be used when the process is started as
root.
DaemonUser
Specify the user to which the daemon process will switch during
startup. The user can either be the login of the user or a
numerical user id. Leave empty to disable the user switch. This
option can only be used when the process is started as root.
LogFile
Specify log file path and name to be used if UseLogging is set
to 1.
OfflineSaveInterval
How often in minutes cached interface data is saved to file when
all monitored interfaces are offline. Value range: SaveInter‐
val..60
PidFile
Specify pid file path and name to be used.
PollInterval
How often in seconds interfaces are checked for status changes.
Value range: 2..300
SaveInterval
How often in minutes cached interface data is saved to file.
Value range: ( UpdateInterval / 60 )..60
SaveOnStatusChange
Enable or disable the additional saving to file of cached inter‐
face data when the availability of an interface changes, i.e.,
when an interface goes offline or comes online. 1 = enabled, 0 =
disabled.
UpdateFileOwner
Enable or disable the update of file ownership during daemon
process startup. Only database, log and pid files will be modi‐
fied if the user or group change feature is enabled and the
files don't match the requested user or group. This option can
only be used when the process is started as root.
UpdateInterval
How often in seconds the interface data is updated. Value range:
PollInterval..300
UseLogging
Enable or disable logging. 0 = disabled, 1 = logfile and 2 =
syslog.
IMAGE OUTPUT RELATED KEYWORDS
CBackground
Background color.
CEdge Edge color if visible.
CHeader
Header background color.
CHeaderTitle
Header title text color.
CHeaderDate
Header date text color.
CLine Line color.
CLineL Lighter version of line color. Set to '-' in order to use a cal‐
culated value based on CLine.
CRx Color for received data.
CRxD Darker version of received data color. Set to '-' in order to
use a calculated value based on CRx.
CText Common text color.
CTx Color for transmitted data.
CTxD Darker version of transmitted data color. Set to '-' in order to
use a calculated value based on CTx.
HeaderFormat
Formatting of date in header. Uses the same format as date(1).
HourlyRate
Show hours with rate instead of transfered amount. 1 = enabled,
0 = disabled.
SummaryLayout
Select the used layout of the summary output. 1 = layout intro‐
duced in version 1.8 with monthly traffic included, 0 = layout
used before version 1.8, doesn't contain monthly traffic and
doesn't support average rate.
SummaryRate
Show rate in summary output if available. 1 = enabled, 0 = dis‐
abled.
TransparentBg
Set background color as transparent. 1 = enabled, 0 = disabled.
FILES
/etc/vnstat.conf
Config file that will be used unless $HOME/.vnstatrc exists or
alternative value is given as command line parameter.
AUTHOR
Teemu Toivola <tst at iki dot fi>
SEE ALSOvnstat(1), vnstati(1), vnstatd(1), units(7)version 1.14 APRIL 2015 VNSTAT.CONF(5)
