Overview

This check monitors Proxmox through the Datadog Agent. Proxmox is an open-source server management platform. It supports running both VMs and containers. The Proxmox integration collects data about your Proxmox cluster including the status and performance of nodes, VMs, containers, and more.

Setup

Follow the instructions below to install and configure this check for an Agent running on a host. For containerized environments, see the Autodiscovery Integration Templates for guidance on applying these instructions.

Installation

Install the Datadog Agent and configure the Proxmox integration on one Proxmox node to collect information about your entire Proxmox Cluster. The Proxmox check is included in the Datadog Agent package. No additional installation is needed on your server.

Configuration

1. Create an API Token in your Proxmox Management Interface.

2. Edit the proxmox.d/conf.yaml file, in the conf.d/ folder at the root of your Agent’s configuration directory to start collecting your proxmox performance data. See the sample proxmox.d/conf.yaml for all available configuration options. Ensure you have set the following parameters:

   instances:
   - proxmox_server: http://localhost:8006/api2/json
     headers:
         Authorization: PVEAPIToken=<USER>@<REALM>!<TOKEN_ID>=<YOUR_TOKEN>
   

3. Restart the Agent.

Validation

Run the Agent’s status subcommand and look for proxmox under the Checks section.

Data Collected

Metrics

Logs

To collect logs from all of the Proxmox services on your node:

1. Enable log collection in your datadog.yaml file:

   logs_enabled: true
   

2. Uncomment and edit the logs configuration block in your proxmox.d/conf.yaml file. For example:

   logs:
    - type: journald
      source: proxmox
      include_units:
        - pveproxy.service
        - pvedaemon.service
        - pve-firewall.service
        - pve-ha-crm.service
        - pve-ha-lrm.service
        - pvescheduler.service
        - pvestatd.service
        - qmeventd.service
   

Events

The Proxmox integration does not include any events.

Service Checks

The Proxmox integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.