Virtuozzo Virtual Machines - Version 1.2

Overview

The Virtuozzo Virtual Machines collector retrieves virtual machine resource allocation data from a Virtuozzo Hybrid Infrastructure (VHI) environment using the OpenStack Compute API.

This collector provides visibility into virtual machine configurations across projects and tenants, capturing CPU, memory, and disk allocations for each virtual machine. This enables organizations to validate resource usage, reconcile allocations, and bill customers within Varibill.

The collector retrieves unrated allocation data, meaning no monetary values are supplied by the source system. Pricing and billing calculations are applied within Varibill based on configured contracts and pricing rules.

This is a point-in-time collector, meaning each execution retrieves the current state of virtual machine resources at the time of collection.

For general instructions on creating and running Source Collectors, see: Configuring a New Cloud Source Collector

Collector Summary

About Virtuozzo

Virtuozzo is a cloud infrastructure software company that provides hyperconverged infrastructure and cloud management solutions for service providers, hosting companies, and enterprises. Virtuozzo enables organizations to build and manage cloud environments that deliver compute, storage, and networking services.

Virtuozzo Hybrid Infrastructure (VHI) is a hyperconverged platform that combines compute, storage, and networking into a single software-defined solution. VHI is built on OpenStack and exposes standard OpenStack APIs for managing infrastructure resources including virtual machines, volumes, networks, and projects.

Service providers and hosting companies use VHI to deliver Infrastructure-as-a-Service (IaaS) to their customers, with each customer’s resources organized under OpenStack projects (tenants).

Data Collected

The Virtuozzo Virtual Machines - Version 1.2 collector retrieves unrated virtual machine resource allocation data from Virtuozzo Hybrid Infrastructure. For each virtual machine in the environment, the collector captures three categories of resource data:

VCPU Records

For each virtual machine, the collector submits a record representing the number of virtual CPUs allocated. The quantity reflects the vCPU count configured for the VM.

Memory Records

For each virtual machine, the collector submits a record representing the amount of memory allocated. Memory values are converted from megabytes (MB) to gigabytes (GB) before submission to Varibill.

Hard Disk Records

For each volume (disk) attached to a virtual machine, the collector submits a separate record. The quantity reflects the disk size in gigabytes (GB). A virtual machine with multiple attached volumes will produce multiple hard disk records, each identified by its volume ID.

Each record includes the VM name, VM status (for example, ACTIVE), and the tenant (project) name for identification and billing purposes.

Prerequisites

Before configuring this collector, ensure that:

• You have access to a Virtuozzo Hybrid Infrastructure environment
• You have a Virtuozzo user account with read access to compute resources (virtual machines, servers, volumes) across the projects you intend to collect
• You have noted the Virtuozzo Host URL (the base URL of the VHI management interface, for example https://compute.example.com)
• You know the Domain ID for your Virtuozzo environment (for example, default)
• You know the Project Name for the administrative project used to authenticate (for example, admin)
• You have access to the Varibill Source Collector configuration screen

Configuration Parameters

The parameters below are entered when configuring the collector in Varibill. They are grouped by function.

Connection Parameters

These parameters identify and authenticate against your Virtuozzo Hybrid Infrastructure environment. The collector uses OpenStack Keystone v3 password authentication to obtain an access token, which is then used for subsequent API calls.

Billing Parameters

These parameters control the Product Identifier prefix for each resource type. Each resource category (VCPU, Memory, Hard Disk) uses a separate prefix, allowing distinct product configuration in Varibill.

Operational Parameters

These parameters control file management behavior.

Virtuozzo References

The following resources may assist with locating values or configuring your Virtuozzo environment.

Virtuozzo Documentation (External)

• Virtuozzo Website
• Virtuozzo Hybrid Infrastructure Compute API Reference

Configuration Steps

Step 1: Prepare Your Virtuozzo Environment

1. Log in to the Virtuozzo Hybrid Infrastructure management interface.
2. Confirm that you have a user account with read access to compute resources across the projects you intend to collect.
3. Note the Host URL of your VHI environment (for example, https://compute.example.com).
4. Note the Domain ID for your environment (commonly default).
5. Note the Project Name used for authentication (commonly admin).

Step 2: Configure the Collector in Varibill

1. In the Varibill User Interface, open the Source Collector configuration screen.

2. Enter the required field values under the Details tab:

   • Hosting Provider: Select Varibill Cloud
   • Source Collector Name: Select Virtuozzo Virtual Machines - Version 1.2

3. Enter the connection parameters:

   • Virtuozzo Host: The base URL of the VHI environment (for example, https://compute.example.com)
   • Virtuozzo Username: The Virtuozzo user account name
   • Virtuozzo Password: The Virtuozzo user account password
   • Virtuozzo Domain ID: The OpenStack domain ID (for example, default)
   • Virtuozzo Project Name: The OpenStack project name (for example, admin)

4. Configure the billing parameters:

   • VCPU Product Identifier: The prefix for VCPU records (for example, VCPU)
   • Memory Product Identifier: The prefix for Memory records (for example, Memory)
   • Hard Disk Product Identifier: The prefix for Hard Disk records (for example, HardDisk)

5. Save the collector configuration.

Step 3: Run the Collector

Run or schedule the collector according to your standard Source Collector execution process.

For detailed instructions, see: Configuring a New Cloud Source Collector

Troubleshooting

If the collector fails to connect to Virtuozzo Hybrid Infrastructure, verify that:

• The Virtuozzo Host URL is correct and includes https:// with no trailing slash.
• The Virtuozzo Username is correct and the account is active.
• The Virtuozzo Password is valid and has not been changed since it was last configured.
• The Virtuozzo Domain ID is correct for your environment.
• The Virtuozzo Project Name is correct and the user has access to the specified project.
• No firewall or IP restriction rules are blocking the Varibill collector’s IP address from reaching the Virtuozzo API endpoints.

If the collector connects successfully but returns no data, verify that:

• There are active virtual machines in the Virtuozzo environment.
• The authenticated user has read access to compute resources across the target projects.
• The Virtuozzo Hybrid Infrastructure environment is accessible and returning data correctly.