Skip to main content

Change Tracking

The Change Tracking page records configuration changes made to your Proxmox infrastructure over time. It answers the critical question: who changed what, and when?

Overview

ProxCenter periodically snapshots the configuration of your VMs, containers, nodes, and storage. When a difference is detected between two snapshots, a change record is created with a diff view showing exactly what was modified.

This feature is particularly valuable in team environments where multiple administrators manage the same infrastructure, and for compliance requirements that mandate an audit trail of configuration changes.

What Gets Tracked

ResourceTracked Changes
VMsCPU, memory, disk, network, boot order, cloud-init, options, tags
ContainersCPU, memory, rootfs, mount points, network, features
NodesNetwork interfaces, DNS, hosts file, kernel parameters
StorageStorage configuration, content types, enabled state
FirewallRules, aliases, IP sets, options at cluster, node, and VM level

Diff View

Each change record includes a side-by-side or unified diff showing the previous and new values. Configuration keys that were added, removed, or modified are highlighted:

  • Green -- New configuration added
  • Red -- Configuration removed
  • Yellow -- Value changed (shows before and after)

Timeline

Changes are displayed on a timeline, grouped by day. You can filter the timeline by:

  • Resource type -- Only VMs, only nodes, etc.
  • Connection -- Limit to a specific Proxmox cluster
  • Date range -- Focus on a specific time window
  • User -- Show changes attributed to a specific Proxmox user (when available from the task log)

Notifications

You can configure alerts to be notified when specific types of changes occur. For example, get an email when a VM's network configuration changes, or when a firewall rule is modified.

warning

Change detection relies on periodic configuration snapshots. Changes made and reverted between two snapshot intervals may not be captured. The default snapshot interval is 5 minutes.

Enterprise Feature

Change Tracking is available in the Enterprise edition.

Permissions

PermissionDescription
audit.viewView change history across all resources
vm.viewRequired to see VM and container change details