Skip to main content

A simple and effective way to gather machine statistics (RAM, Storage, CPU, etc.) from virtual environment

Project description

Machine Stats for Hypervisors (Virt-Stats)

A simple and effective way to gather guest VM statistics (hostname, IP addresses) from a libvirt-based environment as a first layer of a Tidal Migrations discovery process. A common use case is to use this to integrate your KVM-based virtual machine inventory into the Tidal Migrations Platform.


  • Python 3+
  • libvirt >=3.0.0 installed on both operator machine (i.e where you run Virt-Stats) and on remote machine (i.e where you run your virtual environmnent and guest VMs)


Install locally in a Python 3 environment:

python3 -m pip install virt-stats

Data captured

As of now Virt-Stats captures the following metrics:

  • Hostname
  • IP Addresses
  • CPU count
  • RAM allocated (GB)
  • RAM used (GB)


virt-stats --connection URI

Please refer to the Connection URIs documentation for additional information.


Virt-Stats outputs a JSON document suitable to be piped to Tidal Tools:

virt-stats --connection qemu+ssh://me@ | tidal sync servers


virt-stats: command not found

If running Virt-Stats as a CLI failed, try running it as the following:

python3 -m virt-stats


If you're interested in contributing to Virt-Stats, please check our contributing guide.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

virt_stats-2.5.7.tar.gz (3.7 kB view hashes)

Uploaded source

Built Distribution

virt_stats-2.5.7-py3-none-any.whl (3.9 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page