vzctl(8)

📦 version 0.5.3, in ubuntu jammy

💖 NAME 💖

vzstats — the lil cutie that reports your OpenVZ usage statistics back home 🏠✨ (you're reading the vzctl(8) manual page, bestie, and this one's all about vzstats)

🌸 SYNOPSIS 🌸

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

🦋 DESCRIPTION 🦋

okay so. the vzstats utility lives on your OpenVZ server and it's literally the most chill little reporter ever — it periodically collects some usage statistics and sends them over to the OpenVZ stats server, http://stats.openvz.org, where they get processed and analyzed. and the aggregated tea from all the reports? available through the web interface. iconic behavior, honestly. 💅

here's what actually gets reported, no cap:

  • some basic hardware info — CPU, RAM, file system and disk space usage for /vz
  • software info — distribution version, kernel version, OpenVZ software versions
  • some OpenVZ-specific info — number of containers running/total, number of containers using vswap and ploop, used OS templates etc.

and the vibe check on privacy? information submission is anonymous 🫶 — anything that could directly identify a particular host (i.e. MAC or IP addresses, hostnames etc.) is not being reported. periodt.

so that the server can anonymously identify reports coming from the same client, a unique random ID (UUID v4) gets requested from the server during the first vzstats run. it's then saved locally and used whenever reports get sent. lowkey genius tbh. 🧚

and if you run it with no options at all — and it's not disabled — vzstats runs the report scripts it finds in REPDIR (defined in vzstats.conf, default is /usr/lib/vzstats), collects their output, and sends it, as a tarball, to the stats server. bestie really said "i'll handle it." 😌

✨ OPTIONS ✨

heads up: in case any option is provided, no report is being sent — instead, an action denoted by the option is performed. no sneaky double-dipping. 💀

the following options are supported:

  • --view — Collect but do not send the report, giving a user an ability to see what exact information would be sent. it's giving "let me peek first" 👀🔍
  • --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. so like, don't leave that file lying around if you want reports going out, bestie 🚫📄
  • --enable — Re-enable reporting. welcome back queen 👑🫶
  • --help — Show usage. for when you're lost in the sauce 🙈

🎀 FILES 🎀

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

🌈 SEE ALSO 🌈

👑 LICENSE 👑

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

okay that's the whole page bestie, you ate that 💅✨ this one's from the OpenVZ crew, dated 11 May 2013, living inside the vzctl(8) manual — go forth and let your stats be anonymous and cute 🦋💖

📦 where this page comes from