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.
Prerequisutes
- 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)
Installation
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)
Usage
virt-stats --connection URI
Please refer to the Connection URIs documentation for additional information.
Output
Virt-Stats outputs a JSON document suitable to be piped to Tidal Tools:
virt-stats --connection qemu+ssh://me@10.0.0.1/system | tidal sync servers
Troubleshooting
virt-stats: command not found
If running Virt-Stats as a CLI failed, try running it as the following:
python3 -m virt-stats
Contributing
If you're interested in contributing to Virt-Stats, please check our contributing guide.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for virt_stats-2.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6164953e16d715c691d12dffc2e600f01beacd9983db4985a3cee833e083ea4e |
|
MD5 | dd815dd67b828743271e067b3cd79545 |
|
BLAKE2b-256 | aa57f38d191cb1063ef578259bff0d42191afbf7ddf09c322cd14a0c6e566f50 |