---
name: "vzstats"
section: "8"
platform: "linux"
package: "vzstats"
version: "0.5.3-2.1"
release: "Debian 11 (Bullseye)"
platforms: ["linux"]
url: "https://new.carta.tech/vzstats"
---

# vzstats(8)

report OpenVZ usage statistics

## NAME

vzstats - report OpenVZ usage statistics

## SYNOPSIS

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

## DESCRIPTION

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 **/usr/lib/vzstats**), collects their output and sends it, as a tarball, to stats server.

## OPTIONS

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, **/etc/vz/vzstats-disable**. **vzstats** checks this file upon start, and exits if it is present.

- **--enable**

  Re-enable reporting.

- **--help**

  Show usage.

## FILES

```
/etc/vz/vzstats.conf
/etc/vz/vzstats-disable
/usr/lib/vzstats/*
```

## SEE ALSO

[**vzlist**(8)](/vzlist/8.md), **http://stats.openvz.org/**, **http://openvz.org/vzstats**.

## LICENSE

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