proxmox-logging

Log Proxmox VE automation events and errors in structured JSONL format.

Updated Jun 4, 2026
One-click install
npx skills add https://github.com/kngender5/hermes --skill proxmox-logging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: proxmox-logging
Source: https://github.com/kngender5/hermes/tree/main/skills/devops/proxmox-logging
Command: npx skills add https://github.com/kngender5/hermes --skill proxmox-logging

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires json, traceback, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides robust error handling and structured logging for Proxmox VE automation scripts, enhancing debugging and monitoring capabilities.

Core Features & Use Cases

  • Structured Logging: Record events, errors, and tasks in a structured JSONL format for easy analysis.
  • Error Handling: Implement retry logic, context capture, and alerting for automated script failures.
  • Use Case: For developers automating Proxmox VE with Python scripts, this Skill can track task progress, manage errors, and provide an audit trail for operations.

Quick Start

Initialize logging with log = ProxmoxLogger(base_dir="~/data/proxmox-logs", node="pve1"). Log an event using log.event("vm.start", vmid=100, name="web-server").

Frequently Asked Questions about proxmox-logging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add structured logging to Proxmox VE automation scripts?

Structured logging for Proxmox VE automation scripts is handled by recording events, errors, and task status in a JSONL format. You initialize the logger with a base directory and node name, then call the event method with task details like vmid and name.

What's the best way to handle errors and retries in Python scripts managing Proxmox VM and LXC containers?

Error handling for Proxmox VM and LXC management scripts can implement retry logic, context capture, and alerting for automated failures. This approach captures tracebacks during cluster operations or network configuration, ensuring reliable execution and detailed diagnostics.

Does structured logging in JSONL format work with Python's json and traceback modules for cluster operations?

Structured logging in JSONL format works with Python's json and traceback modules to capture event details and error stack traces. This combination ensures that cluster operations, network configurations, and VM management tasks generate a reliable audit trail.

How do I track task progress and create an audit trail for Proxmox VE network configuration?

Tracking task progress and creating an audit trail for Proxmox VE network configuration is achieved by logging structured events with specific task identifiers. The logger records the status and context of operations, providing a detailed historical record for diagnostics.

Can I use this logging approach for both VM and LXC management tasks in Proxmox VE?

This logging approach applies to both VM and LXC management tasks in Proxmox VE. It records structured events and handles errors uniformly across virtual machine operations, container management, and cluster configurations.

Why do my Proxmox automation scripts fail without detailed diagnostics during task execution?

Proxmox automation scripts fail without detailed diagnostics when structured logging and error handling are not implemented. Adding a dedicated logger captures tracebacks and event contexts, transforming silent failures into actionable error data.