🚀 v0.6.5 — Metrics Warning Messages Clarity

This release fixes confusing and empty metrics warning messages in notification reports by implementing intelligent message formatting and proper initialization timing. The system now displays clear, actionable warnings instead of generic summaries, and eliminates false positive warnings for automatically-created directories.
It addresses notify.sh category extraction compatibility, redundant warning messages, and improved troubleshooting experience for backup monitoring.

⚙️ Main Script

/script/proxmox-backup.sh

Fixes

• ⏱️ Moved metrics module initialization after directory setup to prevent false positive warnings.
• 🔧 Added explicit initialize_metrics_module() call after setup_dirs() (line 492).
• ✅ Metrics validation now runs after required directories are created, eliminating false warnings about LOCAL_BACKUP_PATH.

🧩 Core Libraries

/lib/metrics.sh

Fixes

• 🔍 Fixed metrics validation warnings appearing generic/empty in notification reports (e.g., "METRICS WARNING [validation]" with no details).
• 🎯 Changed message format from "METRICS WARNING [operation]: message" to "message [metrics.operation]" for compatibility with notify.sh category extraction regex.
• 📝 Removed redundant summary warnings that duplicated detailed error messages:
  • ❌ Removed "Proxmox environment validation completed with N warnings".
  • ❌ Removed "Metrics module initialized with environment warnings".
• ✅ Improved validation messages with actionable suggestions:
  • 📁 Local backup path: "Local backup path does not exist: /path (will be created automatically)".
  • 🔧 Secondary backup (parent missing): "Secondary backup parent directory does not exist: /path - Create it with: mkdir -p /path".
  • 📊 Secondary backup (parent exists): "Secondary backup path does not exist: /path (will be created if parent exists)".
• 🛡️ Removed auto-initialization that was causing validation to run before directories were created.

Behavior Changes

• Before (v0.6.4): 3 generic warnings without actionable details.
  Metrics module initialized with environment warnings WARNING 1 Proxmox environment validation completed with 1 warnings WARNING 1 METRICS WARNING [validation] WARNING 1
• After (v0.6.5): 1 clear warning with specific actionable message (only if real problem exists).
  Secondary backup parent directory does not exist: /rpool/proxmox-backups - Create it with: mkdir -p /rpool/proxmox-backups WARNING 1
• ✅ Result: No false positives for LOCAL_BACKUP_PATH (created automatically by setup_dirs()).
• 🎯 Real warnings only: Only shows warnings for actual configuration issues (e.g., missing secondary backup parent directory).

✅ Overall Improvements

• 🎯 Clear, actionable messages replace confusing generic warnings in Telegram/email notifications.
• 🔧 Better troubleshooting with specific paths and suggested commands.
• 📊 Eliminates false positives for directories created automatically during initialization.
• 🔍 Proper timing ensures validation happens after directory creation.
• 🛡️ Preserved functionality while dramatically improving user experience.

✨ Result: Users no longer receive mysterious empty warnings like "METRICS WARNING [validation]" in their notification reports. Instead, they get clear, specific messages telling them exactly what's wrong and how to fix it (e.g., "Create it with: mkdir -p /path"). False warnings about missing directories that are created automatically have been eliminated.

Compatibility: PVE and PBS
Installation: bash -c "$(curl -fsSL https://raw.githubusercontent.com/tis24dev/proxmox-backup/main/install.sh)"
Dev Branch: bash -c "$(curl -fsSL https://raw.githubusercontent.com/tis24dev/proxmox-backup/main/install.sh)" -- dev