Sidebar

Combodo

iTop Extensions

Data model for Proxmox

name:
Data model for Proxmox
description:
Advanced modelization of Proxmox CIs in iTop
version:
1.1.0
release:
2026-01-14
itop-version-min:
3.2
code:
combodo-proxmox-datamodel
state:
Stable
php-version-max:
PHP 8.4

This extension is dedicated to Proxmox, the server virtualization platform that automates the management of virtual machines. It enhances iTop's CMDB by modelizing Proxmox elements that are not part of iTop's default CIs (Clusters, Storage, Containers…) and by adding attributes to some of the existing devices (Servers, Virtual Machines). Combined with the Data collector for Proxmox, it allows Proxmox administrators to fetch in iTop the key elements of their Proxmox infrastructure.

Features

When installed on iTop, the extension creates or enhances a set of classes dedicated to or related to Proxmox virtualization environments:

  • Creations
    • Proxmox clusters
    • Proxmox High Availability groups
    • Proxmox containers
    • Proxmox disks
    • Proxmox storage
    • Proxmox storage type
    • Link High Availability groups / servers
  • Enhancements
    • Servers
    • Virtual Machines

Revision History

Version Release Date Comments
1.1.0 2026-01-14 First version

Limitations

None

Requirements

The extension can only be installed on iTop 3.2.0 and above, where Virtualization Management has been activated.

Installation

Use the Standard installation process for this extension.

Configuration

No specific configuration is required.

Usage

Proxmox Cluster

A Proxmox cluster is a group of physical servers that are pooled together and share resources to provide an overall fault tolerant system for hosting virtual machines and containers.

Cluster Properties

Name Type Description Mandatory?
General information
Name Alphanumeric string Name of the CI Yes
Organization Foreign key to a(n) Organization Organization to which the CI belongs Yes
Status Possible values: Implementation, Production, Obsolete No
Business criticality Possible values: high, low, medium No
More information
Version Alphanumeric string Software version of the cluster No
Node count Integer Number of nodes hosted by the cluster Yes
Total RAM Alphanumeric string No
Total CPU Integer Total number of CPUs Yes
Total Disk Alphanumeric string No
Quorum status Possible values: OK, Not OK Is the quorum reached ? No
Dates
Move to production date Date (year-month-day) No
Other information
Description Multiline character string No
Notes Multiline character string Notes as defined on Proxmox No

Tabs

Tab Description
Overview Quick overview on virtualized elements
Contacts All the contacts for this configuration item
Documents All the documents linked to this configuration item
Application solutions All the application solutions depending on this configuration item
Servers All the servers connected to the cluster
HA Groups All HA groups that host servers that belong to the cluster
Storages All the storages used by the cluster
Disks All the disks used by the cluster
Tickets All the tickets for this configuration item
Virtual machines All the virtual machines hosted by this cluster
Containers All the containers hosted by this cluster

Creating a new Proxmox cluster

Enter the Class name in the Quick create area to create a new object, then fill out the form and press the Create button.

Overview tab

This tab provides overall figures on the virtual machines and containers hosted by the cluster.

Relations

  • Impacts: A Proxmox cluster impacts the nodes that belong to it.
  • Depends on: N/A

Server / Proxmox Node

The class Server is used in iTop to document Proxmox nodes. The Proxmox datamodel extension enriches the server attributes, brought by iTop standard datamodel, with a few meaningful attributes that are documented in a Proxmox environment. These can of course be reused for non-Proxmox servers.

Proxmox Node additional Properties

Name Type Description Mandatory?
General information
Uptime Delay (days, hours, minutes, seconds) No
Proxmox cluster Alphanumeric string Name of the CI Yes
More information
CPU Model Alphanumeric string No
Proxmox information
PVE Version Alphanumeric string No
Version Alphanumeric string No
Kernel Alphanumeric string Version of the kernel No
Note Multiline character string Notes as defined on Proxmox No

New Tabs

Tab Description
Overview Quick overview on virtualized elements
HA groups List of all HA Groups that the server belongs to
Storages List of all Proxmox storage used by the node
Proxmox disks List of all Proxmox disks used by the node
Virtual machines List of all virtual machines hosted on the node
Proxomox containers List of all Proxmox containers hosted on the node

Overview tab

This tab provides global figures on the virtual machines and containers hosted by the node.

Relations

  • Impacts: A Proxmox node impacts the HA groups to which it belongs, depending to the redundancy parameters that have been defined for each of the groups.
  • Depends on: It simply depends on its Proxmox cluster.

HA Group

A HA Group is a subset of nodes linked together in order to provide a high-availability environment for resources hosted on the nodes, including virtual machines and containers.

Proxmox HA Group Properties

Name Type Description Mandatory?
Name Alphanumeric string Name of the CI Yes
Organization Foreign key to a(n) Organization Organization to which the CI belongs Yes
Proxmox cluster Foreign key to a(n) Proxmox Cluster Cluster to which the storage belongs Yes
Description Multiline character string No

Tabs

Tab Description
Servers List of the Proxmox nodes that make up the group
Virtual machines List of all virtual machines hosted on the nodes belonging to the group
Containers List of all Proxmox containers hosted on the nodes belonging to the group

Relations

  • Impacts: A Proxmox HA Group impacts the virtual machines and the containers it hosts.
  • Depends on: It depends on the different nodes that look after it, thus offering redundancy.

Virtual Machine

A Virtual Machine is the virtual equivalent of a Server. It is hosted either on an Hypervisor, on a Farm in the vSphere world or on a Node in the Proxmox world. The Proxmox datamodel extension enriches the virtual machine attributes, brought by iTop standard datamodel, with a few meaningful attributes that are documented in a Proxmox environment. These can of course be reused for non-Proxmox VMs.

Virtual Machine additional Properties

Name Type Description Mandatory?
General information
UUID Alphanumeric string Universal Unique IDentifier No
Power state Possible values: On, Off, Suspended, Template No
Virtual host Foreign key to a(n) Virtual Host No *
Physical host Foreign key to a(n) Node No
HA Group Foreign key to a(n) Proxmox HA Group No
CPU information
Socket count Integer No
Cores per socket Integer No
CPU model Alphanumeric string No
Numa Alphanumeric string Version of the kernel No

* The extension is making the virtual host NOT mandatory.

Relations

  • Impacts: a Virtual Machine impacts the software intances running on it, the Application Solutions which this VM is part of and all the contacts (Persons, Teams) directly linked to the VM.
  • Depends on: from a Proxmox standpoint, a Virtual Machine depends on the HA Group to which it belongs.

Proxmox Container

A Proxmox container is a lightweight virtualisation solution based on LXC (Linux Containers) technology. It allows you to create and manage isolated environments that share the host system's Linux kernel, unlike traditional virtual machines that emulate hardware and require their own operating system.

Proxmox Container Properties

Name Type Description Mandatory?
General information
Name Alphanumeric string Yes
UUID Alphanumeric string Universal Unique IDentifier No
Organization Foreign key to a(n) Organization Organization to which the CI belongs Yes
Status Possible values: implementation, obsolete, production, stock No
Business criticality Possible values: high, low, medium No
Physical host Foreign key to a(n) Node No
HA Group Foreign key to a(n) Proxmox HA Group No
More information
OS family Foreign key to a(n) OS Family No
OS version Foreign key to a(n) OS Version No
IP Alphanumeric string No
OS licence Foreign key to a(n) OS Licence No
RAM Alphanumeric string No
Other information
Move to production date Date (year-month-day) No
Description Multiline character string No
CPU information
Socket count Integer No
Cores per socket Integer No
CPU model Alphanumeric string No
CPU Alphanumeric string No
Numa Alphanumeric string Version of the kernel No

Tabs

Tab Description
Softwares All the softwares installed on this configuration item
Contacts All the contracts for this configuration item
Documents All the documents linked to this configuration item
Application solutions All the application solutions depending on this configuration item
Network Interfaces All the logical network interfaces
Logical volumes All the logical volumes used by this device
Active Tickets All the tickets for this configuration item

Relations

  • Impacts: a Proxmox container impacts the software intances running on it, the Application Solutions which this container is part of and all the contacts (Persons, Teams) directly linked to the container.
  • Depends on: from a Proxmox standpoint, a container depends on the HA Group to which it belongs.

Proxmox Storage Type

This typology class enables administrators to type the Proxmox Storages in alignment with Proxmox pre-defined types.

Proxmox Storage

Proxmox storage refers to the spaces in which Proxmox will store backups, virtual disks, bootable ISOs, etc. A wide range of storage types are supported, the simplest being an regular directory, while the most complex uses redundant systems such as Ceph.

Proxmox Storage Properties

Name Type Description Mandatory?
General information
Name Alphanumeric string Name of the CI Yes
Organization Foreign key to a(n) Organization Organization to which the CI belongs Yes
Parent storage Foreign key to a(n) Proxmox Storage Storage, usually defined at the cluster level, that the storage belongs to No
Proxmox cluster Foreign key to a(n) Proxmox Cluster Cluster to which the storage belongs Yes
Node Foreign key to a(n) Proxmox Node Node hosting the storage No
More information
Type Foreign key to a(n) Proxmox storage type Storage type yes
Size Integer Number of nodes hosted by the cluster No
Used Alphanumeric string No
Enabled Integer Total number of CPUs No
Shared Alphanumeric string No
Other information
Content Alphanumeric string Content type: VMs, ISO, backup, … No
Description Multiline character string No

Tabs

Tab Description
Children storage List of all storage objects attached to the current one

Proxmox Disk

Proxmox disk simply documents the hardware disks hosted within Proxmox nodes, i.e. servers.

Proxmox Disk Properties

Name Type Description Mandatory?
General information
Organization Foreign key to a(n) Organization Organization to which the CI belongs Yes
Proxmox cluster Foreign key to a(n) Proxmox Cluster Cluster to which the disk belongs Yes
Node Foreign key to a(n) Proxmox Node Node hosting the disk No
More information
Serial Alphanumeric string Yes
Type Foreign key to a(n) Proxmox storage type Storage type yes
Size Integer Number of nodes hosted by the cluster No
Other information
Description Multiline character string No

extensions/combodo-proxmox-datamodel.txt · Last modified: 2026/01/07 10:53 by 127.0.0.1
Back to top
Contact us