vzstats
< Vzstats
vzstats это инструмент для сбора статистики об использовании OpenVZ. Эта статья попробует объяснить для чего он нужен в форме вопросов и ответов.
vzstat состоит из клиента и сервера. Клиент(пакет vzstats) устанавливается на OpenVZ сервер(аппаратную ноду), так-что у него множество клиентов. И только один сервер, который размещен на stats.openvz.org.
Contents
Общее
Какова задача vzstats?
Мы, OpenVZ разработчики, любопытны. Мы хотим знать больше о наших пользователях. Мы хотим получать определенную статистику использования OpenVZ.
Мы хотим знать сколько OpenVZ серверов существует в мире. Это не простая задача, так-как OpenVZ это открыте програмное обеспечение и оно может быть получено из множества мест.
We want to know which OpenVZ kernels are our users run, say what is the proportion of RHEL5 to RHEL6 kernel user base.
We would like to see how many people use new technologies such as ploop and vswap.
It would be good to know for how many CPU cores, or number of containers, or gigabytes of disk space, should we optimize.
Finally, we share all that information back to you.
Why do I need to participate?
Maybe because you want to help OpenVZ out just a bit. Because sharing is good. Or perhaps you are just a good person.
Why is it opt-out rather than opt-in?
We just don't have a good place (such as installer or some GUI) to ask you for opt-in.
What about my privacy?
We are trying to keep the client very simple, so you can see for yourself what information is gathered and how it is being sent.
All submissions are anonymous and is not including your IPs, MAC addresses, host names etc.
Except for the information gathered, server knows client's UUID and IP.
UUID is random, it's only purpose to track each client as a separate distinct entity.
Client IP address is naturally known to the server. It is stored in httpd server logs but is not used for statistics.
Client
How the client works?
When vzstats is executed, it does the following:
- checks if UUID is obtained; asks the server for one if it's not;
- runs scripts from
/usr/libexec/vzstatsdirectory; - collects their output into separate text files, one per script;
- creates a tarball with all these text files
- sends this tarball together with UUID to the stats server, stats.openvz.org
Where can I see client source code?
Client is written in shell, so just check /usr/sbin/vzstats script.
There is a git repository for client code, see http://git.openvz.org/?p=vzstats;a=summary
What is UUID?
It's just a unique random ID, in UUID v4 format [1]. This is an example of UUID: 285ad6e8-fe62-433c-be2a-643e1c54b315
When vzstats is executed for the first time, it checks that there is no UUID, asks the stats server for one and stores it locally.
What info is collected?
For details, check the scripts in /usr/libexec/vzstats directory.
Download
For latest and previous versions of vzstats see Download/vzstats.
Source code
https://src.openvz.org/projects/OVZL/repos/vzstats/browse
When it is run?
vzstats run in the following cases
- Upon installation, if OpenVZ is already installed on the system
- When any of OpenVZ packages are updated (vzctl, vzquota, ploop, kernel)
- Periodically, once a month, from cron, if crond is running.
You can also run it manually (/usr/sbin/vzstats as root) if you like to update your stats on server.
How to opt-out
You can completely disable vzstats client on a machine by executing the following command:
touch /etc/vz/vzstats-disable
If you want to re-enable vzstats, just do
rm -f /etc/vz/vzstats-disable
Server
Server consists of the following components:
- database (MySQL)
- trivial UUID generation script
- submission receiver script, which just stores the received file
- submission processing scripts, populating the database
- web interface (http://stats.openvz.org/), showing statistics from the database