Reports

Enterprise Feature

The Reports feature requires an Enterprise license. If you are on the Community plan, this page will display an upgrade prompt.

The Reports page lets you generate, schedule, and manage infrastructure reports for your Proxmox environment. Reports are produced as PDF documents and can be customized by type, date range, language, and sections.

In MSP / IaaS deployments, reports respect tenant boundaries. Tenant users can report on their own resources, while provider administrators can generate tenant and vDC reports across the platform.

Overview

The Reports page is organized into three tabs:

1. Generate -- Create a new on-demand report
2. History -- View previously generated reports and download PDFs
3. Schedules -- Configure automated recurring report generation

Operational Requirements

• The orchestrator service must be running.
• PostgreSQL must be reachable by the application.
• PDF generation requires the WeasyPrint sidecar in Docker deployments.
• Scheduled email delivery requires notification settings and SMTP to be configured.
• Tenant and vDC reports require multi-tenancy and vDC assignments to be configured first.

Generating a Report

To create a new report:

1. Navigate to the Generate tab
2. Select a Report Type from the dropdown (each type includes a description)
3. Optionally set a custom Name for the report
4. Choose a Date Range using the date pickers (defaults to the last 30 days)
5. Select the Language for the report output (English, French, etc.)
6. Choose which Sections to include:
   • All Sections is selected by default
   • Uncheck "All Sections" to pick individual sections from the list
   • Each section shows its name and description to help you decide
7. Click Generate to start report generation

tip

Report generation happens asynchronously. After clicking Generate, you will be automatically switched to the History tab where you can track the report's progress.

Report Configuration

Date Range

Select the start and end dates to define the reporting period. The date range determines which data is included in metrics, charts, and tables within the report.

Language Selection

Reports can be generated in multiple languages. The language selection affects all text content within the generated PDF, including section headers, labels, and descriptions.

Section Selection

Each report type defines a set of available sections. You can include all sections or pick specific ones to create a focused report. This is useful when you only need certain aspects of the infrastructure overview.

vDC Reports

The vDC report type is available to provider administrators. It summarizes one or more virtual datacenters across the selected period, including:

• Tenant and vDC identity
• Quota allocation and consumption
• VM and container inventory
• Backup coverage and restore points
• Alert and event summary
• Green IT estimates when datacenter factors are configured

Tenant users remain scoped to their own visible resources. Provider-only vDC reports are intended for MSP operations, customer reviews, and capacity planning.

Report History

The History tab shows all previously generated reports with their:

• Report name and type
• Generation status (Pending, Generating, Completed, Failed)
• Date range covered
• File size
• Creation timestamp

Downloading Reports

Once a report has completed generation, you can download the PDF file directly from the History tab.

Deleting Reports

Reports can be deleted individually from the History tab. This removes both the report metadata and the generated PDF file.

Scheduled Reports

The Schedules tab allows you to configure automated, recurring report generation.

Creating a Schedule

Configure a schedule with:

Field	Description
Name	A descriptive name for the schedule
Report Type	The type of report to generate
Frequency	Daily, Weekly, or Monthly
Day of Week	For weekly schedules, which day to run
Day of Month	For monthly schedules, which day to run
Time	What time of day to generate the report
Connections	Which Proxmox connections to include
Sections	Which report sections to include
Recipients	Email addresses to send the completed report to

Managing Schedules

For each schedule you can:

• Enable/Disable the schedule
• Edit the schedule configuration
• Run Now to trigger an immediate generation outside the normal schedule
• Delete the schedule

The schedule list shows the last run time and next scheduled run for each entry.

warning

Scheduled reports require the ProxCenter orchestrator service to be running. If the orchestrator is down, scheduled reports will not be generated until it is restored.

PDF Export

All reports are exported as PDF documents. The generated PDF includes:

• A cover page with report name, type, and date range
• Table of contents based on selected sections
• Charts, tables, and metrics for each section
• Timestamps and metadata

Reports are stored on the server and can be downloaded at any time from the History tab until they are manually deleted.

WeasyPrint Sidecar

Scheduled PDF rendering uses a dedicated WeasyPrint sidecar container. This keeps PDF generation isolated from the main application process and improves reliability for large scheduled report batches.

If report generation remains stuck in Generating, verify that the orchestrator can reach the sidecar and that container logs do not show missing font or rendering errors.