vnstat.1 (vnstat-2.8) | : | vnstat.1 (vnstat-2.9) | ||
---|---|---|---|---|
VNSTAT(1) User Manuals VNSTAT(1) | VNSTAT(1) User Manuals VNSTAT(1) | |||
NAME | NAME | |||
vnstat - a console-based network traffic monitor | vnstat - a console-based network traffic monitor | |||
SYNOPSIS | SYNOPSIS | |||
vnstat [-5bDedhlmqstvy?] [--add] [--begin date] [--config file] [--days | vnstat [-5bDedhlmqstvy?] [--add] [--alert output exit type condition lim | |||
[limit]] [--dbdir [directory]] | it unit] [--begin date] [--con- | |||
[--dbiflist [mode]] [--debug] [--end date] [--fiveminutes [limit]] [--h | fig file] [--days [limit]] [--dbdir directory] [--dbiflist [mode]] [--deb | |||
elp] [-hg] [--hours [limit]] | ug] [--end date] [--fiveminutes | |||
[--hoursgraph] [-i interface] [--iface interface] [--iflist [mode]] [ | [limit]] [--help] [-hg] [--hours [limit]] [--hoursgraph] [-i interface | |||
--json [mode] [limit]] [--limit | ] [--iface interface] [--iflist | |||
limit] [--live [mode]] [--locale locale] [--longhelp] [--months [limit]] | [mode]] [--json [mode] [limit]] [--limit limit] [--live [mode]] [--locale | |||
[--oneline [mode]] [--query] | locale] [--longhelp] [--months | |||
[--rateunit [mode]] [--remove] [--rename name] [-ru [mode]] [--setalias | [limit]] [--oneline [mode]] [--query] [--rateunit [mode]] [--remove | |||
alias] [--short] [--showconfig] | ] [--rename name] [-ru [mode]] | |||
[--style number] [--top [limit]] [-tr [time]] [--traffic [time]] [--ver | [--setalias alias] [--short] [--showconfig] [--style number] [--top [lim | |||
sion] [--xml [mode] [limit]] | it]] [-tr [time]] [--traffic | |||
[--years [limit]] [interface] | [time]] [--version] [--xml [mode] [limit]] [--years [limit]] [interface] | |||
DESCRIPTION | DESCRIPTION | |||
vnStat is a console-based network traffic monitor. It keeps a log of 5 minute interval, hourly, daily, | vnStat is a console-based network traffic monitor. It keeps a log of 5 minute interval, hourly, daily, | |||
monthly and yearly network traffic for the selected interface(s). Howeve r, it isn't a packet sniffer. | monthly and yearly network traffic for the selected interface(s). Howeve r, it isn't a packet sniffer. | |||
The traffic information is read from the proc(5) or sys filesystems depe nding on availability resulting | The traffic information is read from the proc(5) or sys filesystems depe nding on availability resulting | |||
in light use of system resources regardless of network traffic rate. That way vnStat can be used even | in light use of system resources regardless of network traffic rate. That way vnStat can be used even | |||
without root permissions on most systems. | without root permissions on most systems. | |||
Functionality is divided into two commands. The purpose of the vnstat com mand is to provide an interface | Functionality is divided into two commands. The purpose of the vnstat com mand is to provide an interface | |||
for querying the traffic information stored in the database whereas the d aemon vnstatd(8) is responsible | for querying the traffic information stored in the database whereas the d aemon vnstatd(8) is responsible | |||
for data retrieval, caching and storage. Although the daemon process is c onstantly running as a service, | for data retrieval, caching and storage. Although the daemon process is c onstantly running as a service, | |||
it is actually spending most of its time sleeping between data updates. | it is actually spending most of its time sleeping between data updates. | |||
OPTIONS | OPTIONS | |||
--add Create database entry for interface specified with -i or --iface o ption. The daemon can be run- | --add Create database entry for interface specified with -i or --iface o ption. The daemon can be run- | |||
ning during this operation and will automatically start mon itoring the interface without a | ning during this operation and will automatically start mon itoring the interface without a | |||
restart within SaveInterval minutes if configuration option Rescan DatabaseOnSave is enabled. Oth- | restart within SaveInterval minutes if configuration option Rescan DatabaseOnSave is enabled. Oth- | |||
erwise the daemon needs to be restarted in order for the added int erface to be monitored. | erwise the daemon needs to be restarted in order for the added int erface to be monitored. | |||
--alert output exit type condition limit unit | ||||
Depending on values of given parameters, show alert, use differe | ||||
nt exit status or a combination | ||||
of both when configured situation is met. | ||||
output parameter takes a number from 0 to 3 and controls when, if | ||||
at all, the command will result | ||||
in output. '0' never produces output, '1' always produces out | ||||
put, '2' shows output only when | ||||
usage estimate exceeds limit and '3' shows output only when limit | ||||
is exceeded. | ||||
exit parameter takes a number from 0 to 3 and controls the exit st | ||||
atus of the command. '0' always | ||||
uses exit status 0, '1' always uses exit status 1, '2' uses | ||||
exit status 1 if usage estimate | ||||
exceeds limit but otherwise exit status 0 and '3' uses exit status | ||||
1 if limit is exceeded but | ||||
otherwise exit status 0. | ||||
type parameter defines to which time range type usage the limit | ||||
is compared against. Available | ||||
options: 'h', 'hour', 'hourly', 'd', 'day', 'daily', 'm', 'mon | ||||
th', 'monthly', 'y', 'year', | ||||
'yearly'. | ||||
condition parameter defines if limit is compared to received ( | ||||
rx), transmitted (tx), total or | ||||
estimated usage of these three. Available options: 'rx', 'tx', 'to | ||||
tal', 'rx_estimate', 'tx_esti- | ||||
mate', 'total_estimate'. | ||||
limit is a greater than zero integer without decimals which define | ||||
s the traffic usage limit using | ||||
the unit defined with the unit parameter. unit accepts the follow | ||||
ing options: 'B', 'KiB', 'MiB', | ||||
'GiB', 'TiB', 'PiB', 'EiB', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB'. U | ||||
sage must exceed limit in order | ||||
for the alarm to activate. Exactly the same usage as limit does no | ||||
t raise the alarm. | ||||
Estimate calculation isn't limited to the estimate options in cond | ||||
ition parameter but can also be | ||||
achieved by using the estimate option in output or exit parameters | ||||
. Missing or invalid parameters | ||||
will result in --alert specific help output being shown. | ||||
-b, --begin date | -b, --begin date | |||
Begin the list output with a specific date / time defined by | Begin the list output with a specific date / time defined by date | |||
date instead of the begin being | instead of the begin being | |||
selected based on the number of entries to be shown. If date isn' | selected based on the number of entries to be shown. If date | |||
t available in the database | isn't available in the database | |||
then the closest later date will be used. date supports the foll | then the closest later date will be used. date supports the follo | |||
owing formats: YYYY-MM-DD HH:MM | wing formats: YYYY-MM-DD HH:MM, | |||
and YYYY-MM-DD. This option can only be used with --json , --xml | YYYY-MM-DD and "today". This option can only be used with --json | |||
and list outputs. | , --xml and list outputs. | |||
--config file | --config file | |||
Use file as configuration file instead of using automatic configur ation file search functional- | Use file as configuration file instead of using automatic config uration file search functional- | |||
ity. | ity. | |||
-d, --days [limit] | -d, --days [limit] | |||
Show traffic statistics on a daily basis for the last days. The | Show traffic statistics on a daily basis for the last days. The le | |||
length of the list will be lim- | ngth of the list will be lim- | |||
ited to 30 entries unless configured otherwise or unless the optio | ited to 30 entries unless configured otherwise or unless the op | |||
nal limit parameter is used. | tional limit parameter is used. | |||
All entries stored in the database will be shown if limit is set t o 0. | All entries stored in the database will be shown if limit is set t o 0. | |||
--dbdir directory | --dbdir directory | |||
Use directory as database directory instead of using the directory specified in the configuration | Use directory as database directory instead of using the directory specified in the configuration | |||
file or the hardcoded default if no configuration file is availabl e. | file or the hardcoded default if no configuration file is availabl e. | |||
--dbiflist [mode] | --dbiflist [mode] | |||
List interfaces currently in the database. If mode is not defined | List interfaces currently in the database. If mode is not defined | |||
or is set to 0 then the output | or is set to 0 then the output | |||
will use a one line verbose format. If mode is set to 1 then the | will use a one line verbose format. If mode is set to 1 then the o | |||
output will contain one inter- | utput will contain one inter- | |||
face per line. See also --iflist. | face per line. See also --iflist. | |||
-D, --debug | -D, --debug | |||
Show additional debug output. | Show additional debug output. | |||
-e, --end date | -e, --end date | |||
End the list output with a specific date / time defined by date in stead of the latest date / time | End the list output with a specific date / time defined by date in stead of the latest date / time | |||
in the database. If date isn't available in the database then t | in the database. If date isn't available in the database then the | |||
he closest earlier date will be | closest earlier date will be | |||
used. date supports the following formats: YYYY-MM-DD HH:MM and | used. date supports the following formats: YYYY-MM-DD HH:MM a | |||
YYYY-MM-DD. This option can | nd YYYY-MM-DD. This option can | |||
only be used with --json , --xml and list outputs. The top list a | only be used with --json , --xml and list outputs. The top list al | |||
lso requires --begin to be used | so requires --begin to be used | |||
at the same time with this option. | at the same time with this option. | |||
-5, --fiveminutes [limit] | -5, --fiveminutes [limit] | |||
Show traffic statistics with a 5 minute resolution for the last ho | Show traffic statistics with a 5 minute resolution for the last | |||
urs. The length of the list | hours. The length of the list | |||
will be limited to 24 entries unless configured otherwise or unle | will be limited to 24 entries unless configured otherwise or unles | |||
ss the optional limit parameter | s the optional limit parameter | |||
is used. All entries stored in the database will be shown if limit is set to 0. | is used. All entries stored in the database will be shown if limit is set to 0. | |||
-h, --hours [limit] | -h, --hours [limit] | |||
Show traffic statistics on a hourly basis. The length of the list | Show traffic statistics on a hourly basis. The length of the lis | |||
will be limited to 24 entries | t will be limited to 24 entries | |||
unless configured otherwise or unless the optional limit paramete | unless configured otherwise or unless the optional limit parameter | |||
r is used. All entries store in | is used. All entries store in | |||
the database will be shown if the limit is set to 0. | the database will be shown if the limit is set to 0. | |||
-hg, --hoursgraph | -hg, --hoursgraph | |||
Show traffic statistics on a hourly basis for the last 24 hours us ing a bar graph followed by a | Show traffic statistics on a hourly basis for the last 24 hours using a bar graph followed by a | |||
table representing the numerical data. | table representing the numerical data. | |||
-i, --iface interface | -i, --iface interface | |||
Select one specific interface and apply actions to only it. For q | Select one specific interface and apply actions to only it. For da | |||
ueries, it is possible to merge | tabase queries, it is possible | |||
the information of two or more interfaces using the interface1+int | to merge the information of two or more interfaces using the int | |||
erface2+... syntax. All pro- | erface1+interface2+... syntax. | |||
vided interfaces must be unique and must exist in the database whe | All provided interfaces must be unique and must exist in the datab | |||
n the merge syntax is used. | ase when the merge syntax is | |||
used. Optionally, depending on the InterfaceMatchMethod configur | ||||
ation setting, interface can be | ||||
replaced with alias previously set using --setalias. Merge syntax | ||||
isn't supported when alias is | ||||
used. The -i, --iface option is optional and interface can be u | ||||
sed as parameter on the command | ||||
line for selecting the used interface even without the option bein | ||||
g explicitly used. | ||||
--iflist [mode] | --iflist [mode] | |||
List currently available interfaces. If mode is not defined or i s set to 0 then the output will | List currently available interfaces. If mode is not defined or is set to 0 then the output will | |||
use a one line verbose format. If mode is set to 1 then the output will contain one interface per | use a one line verbose format. If mode is set to 1 then the output will contain one interface per | |||
line. See also --dbiflist. | line. See also --dbiflist. | |||
--json [mode] [limit] | --json [mode] [limit] | |||
Show database content for selected interface or all interfaces in json format. All traffic values | Show database content for selected interface or all interfaces in json format. All traffic values | |||
in the output are in bytes. An optional mode parameter can be used | in the output are in bytes. An optional mode parameter can be | |||
for limiting the output to | used for limiting the output to | |||
only selected information. Everything is shown by default. Setti | only selected information. Everything is shown by default. Settin | |||
ng mode to 'f' will output only | g mode to 'f' will output only | |||
5 minute resolution entries, 'h' hours, 'd' days, 'm' months, 'y' | 5 minute resolution entries, 'h' hours, 'd' days, 'm' months, | |||
years and 't' the top days. | 'y' years and 't' the top days. | |||
Alternatively or in combination with mode an optional limit par | Alternatively or in combination with mode an optional limit parame | |||
ameter can be used to limit the | ter can be used to limit the | |||
number of entries in the output. The --json option can be used in combination with -l, --live and | number of entries in the output. The --json option can be used in combination with -l, --live and | |||
-tr options without mode or limit having any effect to the outpu t. The jsonversion field in the | -tr options without mode or limit having any effect to the output. The jsonversion field in the | |||
output contains the API version information. It will be changed on ly when the names or structures | output contains the API version information. It will be changed on ly when the names or structures | |||
of previously existing content gets changed. In comparison, the vnstatversion field exists only | of previously existing content gets changed. In comparison, the vn statversion field exists only | |||
as extra information. | as extra information. | |||
--limit limit | --limit limit | |||
Set the maximum number of shown entries in list outputs to limit. Usage of --limit overrides the | Set the maximum number of shown entries in list outputs to limit. Usage of --limit overrides the | |||
default list entry limit values and the optional limit parameter g iven directly for a list query. | default list entry limit values and the optional limit parameter g iven directly for a list query. | |||
All entries stored in the database will be shown if limit is set t o 0. --limit can also be used | All entries stored in the database will be shown if limit is set to 0. --limit can also be used | |||
to control the length of --json and --xml outputs. | to control the length of --json and --xml outputs. | |||
-l, --live [mode] | -l, --live [mode] | |||
Display current transfer rate for the selected interface in real | Display current transfer rate for the selected interface in real t | |||
time until interrupted. Statis- | ime until interrupted. Statis- | |||
tics will be shown after interruption if the runtime was more than | tics will be shown after interruption if the runtime was more th | |||
10 seconds. An optional mode | an 10 seconds. An optional mode | |||
parameter can be used to select between the displaying of packets | parameter can be used to select between the displaying of packets | |||
per second (mode 0) and trans- | per second (mode 0) and trans- | |||
fer counters (mode 1) during execution. --style can also be used | fer counters (mode 1) during execution. --style can also be u | |||
to affect the layout of the | sed to affect the layout of the | |||
output. The output will be in json format if used in combination w ith --json option. | output. The output will be in json format if used in combination w ith --json option. | |||
--locale locale | --locale locale | |||
Use locale instead of using the locale setting specified in the c onfiguration file or the system | Use locale instead of using the locale setting specified in the co nfiguration file or the system | |||
default if no configuration file is available. | default if no configuration file is available. | |||
--longhelp | --longhelp | |||
Show complete options list. | Show complete options list. | |||
-m, --months [limit] | -m, --months [limit] | |||
Show traffic statistics on a monthly basis for the last months. Th e length of the list will be | Show traffic statistics on a monthly basis for the last months. The length of the list will be | |||
limited to 12 entries unless configured otherwise or unless the op tional limit parameter is used. | limited to 12 entries unless configured otherwise or unless the op tional limit parameter is used. | |||
All entries stored in the database will be shown if limit is set t o 0. | All entries stored in the database will be shown if limit is set t o 0. | |||
--oneline [mode] | --oneline [mode] | |||
Show traffic summary for selected interface using one line with a | Show traffic summary for selected interface using one line wit | |||
parsable format. The output | h a parsable format. The output | |||
contains 15 fields with ; used as field delimiter. The 1st field | contains 15 fields with ; used as field delimiter. The 1st field c | |||
contains the API version infor- | ontains the API version infor- | |||
mation of the output that will only be changed in future versions | mation of the output that will only be changed in future versions | |||
if the field content or struc- | if the field content or struc- | |||
ture changes. The following fields in order 2) interface name, 3) | ture changes. The following fields in order 2) interface name, 3) | |||
timestamp for today, 4) rx for | timestamp for today, 4) rx for | |||
today, 5) tx for today, 6) total for today, 7) average traffic rat | today, 5) tx for today, 6) total for today, 7) average traffic r | |||
e for today, 8) timestamp for | ate for today, 8) timestamp for | |||
current month, 9) rx for current month, 10) tx for current mont | current month, 9) rx for current month, 10) tx for current month, | |||
h, 11) total for current month, | 11) total for current month, | |||
12) average traffic rate for current month, 13) all time total rx, 14) all time total tx, 15) all | 12) average traffic rate for current month, 13) all time total rx, 14) all time total tx, 15) all | |||
time total traffic. An optional mode parameter can be used t o force all fields to output in | time total traffic. An optional mode parameter can be used to for ce all fields to output in | |||
bytes without the unit itself shown. | bytes without the unit itself shown. | |||
-q, --query | -q, --query | |||
Force database query mode. | Force database query mode. | |||
--remove | --remove | |||
Delete the database entry for the interface specified with -i or - -iface and stop monitoring it. | Delete the database entry for the interface specified with -i or --iface and stop monitoring it. | |||
The daemon can be running during this operation and will automatic ally detect the change. | The daemon can be running during this operation and will automatic ally detect the change. | |||
--rename name | --rename name | |||
Rename the interface specified with -i or --iface in the databa se with new name name. The new | Rename the interface specified with -i or --iface in the database with new name name. The new | |||
name cannot already exist in the database. This operation doesn't cause any data loss. The daemon | name cannot already exist in the database. This operation doesn't cause any data loss. The daemon | |||
should not be running during this operation. | should not be running during this operation. | |||
-ru, --rateunit [mode] | -ru, --rateunit [mode] | |||
Swap the configured rate unit. If rate has been configured to be s hown in bytes then rate will be | Swap the configured rate unit. If rate has been configured to be s hown in bytes then rate will be | |||
shown in bits if this option is present. In the same way, if rate has been configured to be shown | shown in bits if this option is present. In the same way, if rate has been configured to be shown | |||
in bits then rate will be shown in bytes when this option is pr | in bits then rate will be shown in bytes when this option is prese | |||
esent. Alternatively, mode with | nt. Alternatively, mode with | |||
either 0 or 1 can be used as parameter for this option in order to | either 0 or 1 can be used as parameter for this option in order | |||
select between bytes (0) and | to select between bytes (0) and | |||
bits (1) regardless of the configuration file setting. | bits (1) regardless of the configuration file setting. | |||
--setalias alias | --setalias alias | |||
Set alias as an alias for the selected interface to be shown i | Set alias as an alias for the selected interface to be shown in qu | |||
n queries. The set alias can be | eries. The set alias can be | |||
removed by specifying an empty string for alias. The daemon can b | removed by specifying an empty string for alias. The daemon ca | |||
e running during this opera- | n be running during this opera- | |||
tion. | tion. | |||
-s, --short | -s, --short | |||
Use short output mode. This mode is also used when more than on e interface is available in the | Use short output mode. This mode is also used when more than one i nterface is available in the | |||
database and no specific interface is selected. | database and no specific interface is selected. | |||
--showconfig | --showconfig | |||
Show current configuration using the same format as the configurat ion file itself uses. | Show current configuration using the same format as the configurat ion file itself uses. | |||
--style number | --style number | |||
Modify the content and style of outputs. Set number to 0 for a nar | Modify the content and style of outputs. Set number to 0 for a | |||
rower output, 1 for enabling | narrower output, 1 for enabling | |||
bar column, 2 for same as previous but with average traffic rate | bar column, 2 for same as previous but with average traffic rate v | |||
visible in summary output and 3 | isible in summary output and 3 | |||
for enabling average traffic rate in all outputs where it is suppo | for enabling average traffic rate in all outputs where it is s | |||
rted. 4 disables the use of | upported. 4 disables the use of | |||
terminal control characters in -l / --live mode. | terminal control characters in -l / --live mode. | |||
-t, --top [limit] | -t, --top [limit] | |||
Show all time top traffic days. The length of the list will be li mited to 10 entries unless con- | Show all time top traffic days. The length of the list will be lim ited to 10 entries unless con- | |||
figured otherwise or unless the optional limit parameter is used. All entries stored in the data- | figured otherwise or unless the optional limit parameter is used. All entries stored in the data- | |||
base will be shown if limit is set to 0. When used with --begin and optionally with --end, the | base will be shown if limit is set to 0. When used with --begin an d optionally with --end, the | |||
list will be generated using the daily data instead of separate to p entries. The availability of | list will be generated using the daily data instead of separate to p entries. The availability of | |||
daily data defines the boundaries the date specific query can acce ss. | daily data defines the boundaries the date specific query can acce ss. | |||
-tr, --traffic [time] | -tr, --traffic [time] | |||
Calculate how much traffic goes through the selected interface dur ing the given time seconds. The | Calculate how much traffic goes through the selected interface dur ing the given time seconds. The | |||
time will be 5 seconds if a number parameter isn't specified. The | time will be 5 seconds if a number parameter isn't specified. Th | |||
output will be in json format | e output will be in json format | |||
if used in combination with --json option. However, in that cas | if used in combination with --json option. However, in that case, | |||
e, the countdown before results | the countdown before results | |||
isn't shown. | isn't shown. | |||
-v, --version | -v, --version | |||
Show current version. | Show current version. | |||
--xml [mode] [limit] | --xml [mode] [limit] | |||
Show database content for selected interface or all interfaces in | Show database content for selected interface or all interfaces in | |||
xml format. All traffic values | xml format. All traffic values | |||
in the output are in bytes. An optional mode parameter can be | in the output are in bytes. An optional mode parameter can be used | |||
used for limiting the output to | for limiting the output to | |||
only selected information. Everything is shown by default. Settin | only selected information. Everything is shown by default. Setti | |||
g mode to 'f' will output only | ng mode to 'f' will output only | |||
5 minute resolution entries, 'h' hours, 'd' days, 'm' months, | 5 minute resolution entries, 'h' hours, 'd' days, 'm' months, 'y' | |||
'y' years and 't' the top days. | years and 't' the top days. | |||
Alternatively or in combination with mode an optional limit parame | Alternatively or in combination with mode an optional limit par | |||
ter can be used to limit the | ameter can be used to limit the | |||
number of entries in the output. The xmlversion field in the | number of entries in the output. The xmlversion field in the outp | |||
output contains the API version | ut contains the API version | |||
information. It will be changed only when the names or structures | information. It will be changed only when the names or structures | |||
of previously existing content | of previously existing content | |||
gets changed. In comparison, the vnstatversion field exists only a s extra information. | gets changed. In comparison, the vnstatversion field exists only a s extra information. | |||
-y, --years [limit] | -y, --years [limit] | |||
Show traffic statistics on a yearly basis for the last years. Th | Show traffic statistics on a yearly basis for the last years. The | |||
e list will show all entries by | list will show all entries by | |||
default unless configured otherwise or unless the optional limit p | default unless configured otherwise or unless the optional limit | |||
arameter is used. All entries | parameter is used. All entries | |||
stored in the database will also be shown if limit is set to 0. | stored in the database will also be shown if limit is set to 0. | |||
-?, --help | -?, --help | |||
Show a command option summary. | Show a command option summary. | |||
FILES | FILES | |||
/var/lib/vnstat/ | /var/lib/vnstat/ | |||
Default database directory. | Default database directory. | |||
/etc/vnstat.conf | /etc/vnstat.conf | |||
Config file that will be used unless $HOME/.vnstatrc exists. See v nstat.conf(5) for more informa- | Config file that will be used unless $HOME/.vnstatrc exists. See v nstat.conf(5) for more informa- | |||
tion. | tion. | |||
EXAMPLES | EXAMPLES | |||
vnstat Display traffic summary for the default interface or multiple inte rfaces when more than one is | vnstat Display traffic summary for the default interface or multiple i nterfaces when more than one is | |||
monitored. | monitored. | |||
vnstat -i eth0+eth1+eth3 | vnstat -i eth0+eth1+eth3 | |||
Display traffic summary for a merge of interfaces eth0, eth1 and e th3. | Display traffic summary for a merge of interfaces eth0, eth1 and e th3. | |||
vnstat -i eth2 --xml | vnstat -i eth2 --xml | |||
Output all information about interface eth2 in xml format. | Output all information about interface eth2 in xml format. | |||
vnstat --json | vnstat --json | |||
Output all information of all monitored interfaces in json format. | Output all information of all monitored interfaces in json format. | |||
vnstat -i eth0 --setalias local | vnstat -i eth0 --setalias local | |||
Give interface eth0 the alias "local". That information will b e later visible as a label when | Give interface eth0 the alias "local". That information will be la ter visible as a label when | |||
eth0 is queried. | eth0 is queried. | |||
vnstat -i eth2 --remove | vnstat -i eth2 --remove | |||
Delete database entries for interface eth2 and stop monitoring it. | Delete database entries for interface eth2 and stop monitoring it. | |||
RESTRICTIONS | RESTRICTIONS | |||
Updates need to be executed at least as often as it is possible for the | Updates need to be executed at least as often as it is possible for t | |||
interface to generate enough | he interface to generate enough | |||
traffic to overflow the kernel interface traffic counter. Otherwise, i | traffic to overflow the kernel interface traffic counter. Otherwise, it i | |||
t is possible that some traffic | s possible that some traffic | |||
won't be seen. With 32-bit interface traffic counters, the maximum time b | won't be seen. With 32-bit interface traffic counters, the maximum time | |||
etween two updates depends on | between two updates depends on | |||
how fast the interface can transfer 4 GiB. Note that there is no gua | how fast the interface can transfer 4 GiB. Note that there is no guarant | |||
rantee that a 64-bit kernel has | ee that a 64-bit kernel has | |||
64-bit interface traffic counters for all interfaces. Calculated theoreti cal times are: | 64-bit interface traffic counters for all interfaces. Calculated theoreti cal times are: | |||
10 Mbit: 54 minutes | 10 Mbit: 54 minutes | |||
100 Mbit: 5 minutes | 100 Mbit: 5 minutes | |||
1000 Mbit: 30 seconds | 1000 Mbit: 30 seconds | |||
Virtual and aliased interfaces cannot be monitored because the kernel doe | Virtual and aliased interfaces cannot be monitored because the kernel d | |||
sn't provide traffic informa- | oesn't provide traffic informa- | |||
tion for that type of interfaces. Such interfaces are usually named et | tion for that type of interfaces. Such interfaces are usually named eth0: | |||
h0:0, eth0:1, eth0:2 etc. where | 0, eth0:1, eth0:2 etc. where | |||
eth0 is the actual interface being aliased. | eth0 is the actual interface being aliased. | |||
Using long date output formats may cause misalignment in shown columns if the length of the date exceeds | Using long date output formats may cause misalignment in shown columns if the length of the date exceeds | |||
the fixed size allocation. | the fixed size allocation. | |||
AUTHOR | AUTHOR | |||
Teemu Toivola <tst at iki dot fi> | Teemu Toivola <tst at iki dot fi> | |||
SEE ALSO | SEE ALSO | |||
vnstatd(8), vnstati(1), vnstat.conf(5), proc(5), ifconfig(8), units(7) | vnstatd(8), vnstati(1), vnstat.conf(5), proc(5), ifconfig(8), units(7) | |||
version 2.8 SEPTEMBER 2021 VNSTAT(1) | version 2.9 JANUARY 2022 VNSTAT(1) | |||
End of changes. 37 change blocks. | ||||
141 lines changed or deleted | 196 lines changed or added |