Editing Vzstats
Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.
The edit can be undone.
Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
| Latest revision | Your text | ||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:vzstats}} | {{DISPLAYTITLE:vzstats}} | ||
| − | + | ||
| − | |||
| − | |||
'''vzstats''' is a tool to gather OpenVZ usage statistics. This page tries to explain it, mostly in form of questions and answers. | '''vzstats''' is a tool to gather OpenVZ usage statistics. This page tries to explain it, mostly in form of questions and answers. | ||
| − | |||
vzstats consists of a client and a server. A client (vzstats package) is installed on an OpenVZ server (hardware node), so there are many clients. There is only one server, it is deployed at stats.openvz.org. | vzstats consists of a client and a server. A client (vzstats package) is installed on an OpenVZ server (hardware node), so there are many clients. There is only one server, it is deployed at stats.openvz.org. | ||
| − | == General == | + | == General == |
| − | === What is the purpose of vzstats? === | + | === What is the purpose of vzstats? === |
| − | |||
We, OpenVZ developers, are curious. We want to know more about our users. We want some stats. | We, OpenVZ developers, are curious. We want to know more about our users. We want some stats. | ||
| − | |||
We would like to know how many OpenVZ servers are there in the wild. Since OpenVZ is free software available from many places, there is no easy way to find out. | We would like to know how many OpenVZ servers are there in the wild. Since OpenVZ is free software available from many places, there is no easy way to find out. | ||
| − | |||
We want to know which OpenVZ kernels are our users run, say what is the proportion of RHEL5 to RHEL6 kernel user base. | 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]]. | 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. | 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. | Finally, we share all that information back to you. | ||
| − | === Why do I need to participate? === | + | === 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. | 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? === | + | === 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. | We just don't have a good place (such as installer or some GUI) to ask you for opt-in. | ||
| − | === What about my privacy? === | + | === 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. | 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. | 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. | 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. | 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 IP address is naturally known to the server. It is stored in httpd server logs but is not used for statistics. | ||
| − | == Client == | + | == Client == |
| − | === How the client works? === | + | === How the client works? === |
| − | |||
When vzstats is executed, it does the following: | When vzstats is executed, it does the following: | ||
# checks if UUID is obtained; asks the server for one if it's not; | # checks if UUID is obtained; asks the server for one if it's not; | ||
| Line 69: | Line 52: | ||
# sends this tarball together with UUID to the stats server, stats.openvz.org | # sends this tarball together with UUID to the stats server, stats.openvz.org | ||
| − | === Where can I see client source code? === | + | === Where can I see client source code? === |
| − | |||
Client is written in shell, so just check /usr/sbin/vzstats script. | 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 | There is a git repository for client code, see http://git.openvz.org/?p=vzstats;a=summary | ||
| − | === What is UUID? === | + | === What is UUID? === |
| − | |||
It's just a unique random ID, in UUID v4 format [http://en.wikipedia.org/wiki/Universally_unique_identifier#Version_4_.28random.29]. This is an example of UUID: <code>285ad6e8-fe62-433c-be2a-643e1c54b315</code> | It's just a unique random ID, in UUID v4 format [http://en.wikipedia.org/wiki/Universally_unique_identifier#Version_4_.28random.29]. This is an example of UUID: <code>285ad6e8-fe62-433c-be2a-643e1c54b315</code> | ||
| − | |||
When <code>vzstats</code> is executed for the first time, it checks that there is no UUID, asks the stats server for one and stores it locally. | When <code>vzstats</code> 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? === | + | === What info is collected? === |
| − | |||
For details, check the scripts in <code>/usr/libexec/vzstats</code> directory. | For details, check the scripts in <code>/usr/libexec/vzstats</code> directory. | ||
| − | === Download === | + | === Download === |
| − | |||
For latest and previous versions of vzstats see [[Download/vzstats]]. | For latest and previous versions of vzstats see [[Download/vzstats]]. | ||
| − | === Source code === | + | === Source code === |
| − | |||
https://src.openvz.org/projects/OVZL/repos/vzstats/browse | https://src.openvz.org/projects/OVZL/repos/vzstats/browse | ||
| − | === When it is run? === | + | === When it is run? === |
| − | |||
vzstats run in the following cases | vzstats run in the following cases | ||
* Upon installation, if OpenVZ is already installed on the system | * Upon installation, if OpenVZ is already installed on the system | ||
| Line 109: | Line 84: | ||
* Periodically, once a month, from cron, if crond is running. | * Periodically, once a month, from cron, if crond is running. | ||
| − | |||
You can also run it manually (<code>/usr/sbin/vzstats</code> as root) if you like to update your stats on server. | You can also run it manually (<code>/usr/sbin/vzstats</code> as root) if you like to update your stats on server. | ||
| − | === How to opt-out === | + | === How to opt-out === |
| − | |||
You can completely disable vzstats client on a machine by executing the following command: | You can completely disable vzstats client on a machine by executing the following command: | ||
| − | + | touch /etc/vz/vzstats-disable | |
| − | |||
| − | touch /etc/vz/vzstats-disable | ||
| − | |||
If you want to re-enable vzstats, just do | If you want to re-enable vzstats, just do | ||
| − | + | rm -f /etc/vz/vzstats-disable | |
| − | rm -f /etc/vz/vzstats-disable | ||
| − | == Server == | + | == Server == |
| − | |||
Server consists of the following components: | Server consists of the following components: | ||
* database (MySQL) | * database (MySQL) | ||
| Line 137: | Line 105: | ||
* web interface (http://stats.openvz.org/), showing statistics from the database | * web interface (http://stats.openvz.org/), showing statistics from the database | ||
| − | == See also == | + | == See also == |
| − | |||
* http://stats.openvz.org | * http://stats.openvz.org | ||
* [[Man/vzstats.8|vzstats(8)]] | * [[Man/vzstats.8|vzstats(8)]] | ||
| − | + | ||
[[Category: Sub-projects]] | [[Category: Sub-projects]] | ||
