vzubc - show User Beancounters in a human-readable format
vzubc [option ...] [CTID ...]
This utility aims to show current values for User Beancounter in a
human-readable format. Values that are in pages are converted into bytes, then
long values are converted into kilo-, mega- gigabytes etc. For held and
maxheld, it shows how close the values are to the barrier and to the limit.
Zero and unlimited values are shown as -.
One or several CTIDs can be specified to limit the output
to the given containers. Each CTID can be either a name or a numeric
ID. Note that names can only be used if there is a container on the system
with that name (vzlist -o ctid name command is used for name
to ID conversion). Unknown CTIDs are ignored.
The utility can also be used from inside the container, in this
case it only shows the values for that container (and it doesn't make sense
to specify CTID).
- -w, --watch
- Watch mode: run itself under watch(1), redisplaying the output
every 2 seconds (by default) until interrupted by Ctrl-C.
- -wd
- Make watch(1) highlight the differences between current and
previous output (corresponds to watch -d option).
- -wn time
- Refresh interval for watch(1), in seconds (corresponds to watch
-n time).
- -q, --quiet
- Quiet mode. In this mode, vzubc only shows beancounters with fails
and those with held/maxheld values close to limits.
- -qh ratio
- Quiet threshold for held to limit ratio. Default is 0.5 (50%).
- -qm ratio
- Quiet threshold for maxheld to limit ratio. Default is 0.8
(80%).
- -r, --relative
- Relative mode: for fail counters, instead of showing the absolute value,
calculate the difference from the previous run. This mode is denoted by a
+ sign before the FAIL column header.
- -rd dir
- Set a directory for saving fail counters to dir (default is
/tmp/vzubc.store).
- -rc
- Clear all saved fail counter data.
- -i, --incremental
- Incremental mode. Shows an additional column with a difference in held
value from the previous run. This option also affects quiet mode: all
lines with changed held values are shown. Held data is saved to the same
directory as fail counter data.
- -id dir
- A synonym for -rd.
- -ic
- Clear all saved held data.
- -c, --color
- Enable color highlighting. Not compatible with --watch. Same
thresholds as for quiet mode are used to highlight "more
important" lines, plus the lines with non-zero fail counters are
highlighted.
- -f | --file filename
- Read User Beancounters from filename. By default this is
/proc/bc/resources or, if that one is not available,
/proc/user_beancounters. Use - to read from standard
input.
- vzubc 101 web dns
- Show all beancounters for CTID 101 and for CTs named web and
dns.
- vzubc -w -wd -wn 10 101
- Display beancounters for CT 101 every 10 seconds, highlighting the
changes. Interrupt with Control-C.
- vzubc -q -c
- Show beancounters with held or maxheld close to limits, plus those with
non-zero fail counters, with colors.
- vzubc -q -qh 0.8 -qm 1
- Show beancounters with held value equal to or more than 80% of a limit,
and/or with maxheld value equal or more than a limit, plus those with
non-zero fail counters.
- vzubc -w -q -r
- Display beancounters with held and maxheld close to limits, plus those
with increasing fail counters.
- vzubc -r -q -qh 2 -qm 2
- Only show beancounters with increased (since the last run) fail
counters.
- vzubc -rc -ic
- Show all beancounters, and clear all saved data for relative and
incremental mode (i.e. saved values for fail counter and held).
/proc/bc/resources
/proc/user_beancounters
/tmp/vzubc.store/ubc.*
Returns 0 upon successful execution, 1 otherwise.
watch(1), vzlist(8), vzmemcheck(8),
vzcfgvalidate(8), http://wiki.openvz.org/UBC.
Copyright (C) 2011, Parallels, Inc. Licensed under GNU GPL.