Difference between revisions of "Man/vzstats.8"

From OpenVZ Virtuozzo Containers Wiki
< Man
Jump to: navigation, search
(Automated import of articles)
 
(Automated import of articles *** existing text overwritten ***)
 
Line 22: Line 22:
 
<p style="margin-left:11%; margin-top: 1em">Statistics
 
<p style="margin-left:11%; margin-top: 1em">Statistics
 
reported include some basic hardware information (CPU, RAM,
 
reported include some basic hardware information (CPU, RAM,
PCI information, file system and disk space usage for
+
file system and disk space usage for <b>/vz</b>), software
<b>/vz</b>), software information (distribution version,
+
information (distribution version, kernel version, OpenVZ
kernel version, OpenVZ software versions), and some
+
software versions), and some OpenVZ-specific information
OpenVZ-specific information (number of containers
+
(number of containers running/total, number of containers
running/total, number of containers using <b>vswap</b> and
+
using <b>vswap</b> and <b>ploop</b>, used OS templates
<b>ploop</b>, used OS templates etc.). Information
+
etc.). Information submission is anonymous; information that
submission is anonymous; information that can be used to
+
can be used to directly identify a particular host (i.e. MAC
directly identify a particular host (i.e. MAC or IP
+
or IP addresses, hostnames etc.) is not being reported.</p>
addresses, hostnames etc.) is not being reported.</p>
 
  
 
<p style="margin-left:11%; margin-top: 1em">For the server
 
<p style="margin-left:11%; margin-top: 1em">For the server

Latest revision as of 21:50, 18 July 2013

NAME[edit]

vzstats − report OpenVZ usage statistics

SYNOPSIS[edit]

vzstats
vzstats --view
|--status
vzstats --enable
|--disable
vzstats --help

DESCRIPTION[edit]

Utility vzstats, installed on an OpenVZ server, periodically collects some usage statistics and sends it to the OpenVZ stats server, http://stats.openvz.org, for processing and analysis. Aggregated statistics from all reports are available through the web interface.

Statistics reported include some basic hardware information (CPU, RAM, file system and disk space usage for /vz), software information (distribution version, kernel version, OpenVZ software versions), and some OpenVZ-specific information (number of containers running/total, number of containers using vswap and ploop, used OS templates etc.). Information submission is anonymous; information that can be used to directly identify a particular host (i.e. MAC or IP addresses, hostnames etc.) is not being reported.

For the server to anonymously identify reports from the same client, a unique random ID (UUID v4) is requested from the server during the first vzstats run. It is then saved locally and used when sending reports.

If run without any options and unless disabled, vzstats runs report scripts found in REPDIR (defined in vzstats.conf, default is @REPDIR@), collects their output and sends it, as a tarball, to stats server.

OPTIONS[edit]

In case any option is provided, no report is being send, instead an action denoted by the option is performed.

The following options are supported:

--view

Collect but do not send report, giving a user an ability to see what exact information would be send.

--config

Output current vzstats configuration, including:
• current version number;
• status (enabled or disabled);
• an URL used to submit reports to;
• vzstats UUID;
• report scripts directory.

--disable

Disable reporting. This is performed by creating a marker file, @ETCDIR@/vzstats-disable. vzstats checks this file upon start, and exits if it is present.

--enable

Re-enable reporting.

--help

Show usage.

FILES[edit]

@ETCDIR@/vzstats.conf
@ETCDIR@/vzstats-disable
@REPDIR@/*

SEE ALSO[edit]

vzlist(8), http://stats.openvz.org/, http://openvz.org/vzstats.

LICENSE[edit]

Copyright (C) 2013, Parallels, Inc. Licensed under GNU GPL.