pxmon/docs/FEATURES.md

Feature Overview

1) Cluster inventory and connectivity

• Register clusters by SSH host/user/auth method.
• Keep one active cluster for short commands.
• Validate connectivity at connect time (or allow deferred validation).
• Support direct agent transport or SSH-tunneled transport (ipfabric).
• Store SSH key passphrases directly or via a passphrase file reference.

2) Interactive TUI operations

• Multi-view dashboard for overview, cluster inventory, network, settings, docs, usage, and live data.
• Integrated command console with history and aliases.
• Scrollable fixed-size panes for stable rendering.
• Privacy mode for masking sensitive output.

3) Agent lifecycle

• Build and bootstrap pxmon-agent remotely via SSH.
• Query agent status across all clusters.
• Compare node agent version with expected local version.
• Update and optionally restart bot processes.

4) Monitoring and analytics

• Realtime stats snapshots.
• Historical usage windows (live, 1h, 1d, 1mo, all).
• Traffic p95 and usage chart generation (PNG output).
• SLO reports and capacity forecasting.

5) Alerting and policy controls

• CPU/RAM/SWAP/DISK/NET threshold policies.
• Sustained network threshold detection.
• VM alert policy (e.g., minimum running VMs, shutoff warnings).
• Alert routing behavior controls (critical immediate vs warning batches).

6) Drift and change management

• Drift checks for configuration/runtime mismatches.
• Baseline set/show and timed acknowledgment.
• Change history inspection.

7) Tagging and grouping

• Cluster tags (add/remove/list).
• KVM VM-level tags.

8) Backup and disaster readiness

• Backup targets (SFTP/S3).
• Backup plans with schedules and retention settings.
• Manual backup run execution.
• Export/import bundles can carry referenced SSH/SFTP key files.

9) RepoTunneling

• Prepare a restricted squid gateway for repository traffic.
• Temporarily configure apt/dnf/yum proxy settings on ipfabric nodes.
• Run one-shot package install commands and clean up the route/proxy state.

10) Runbooks and automation

• Define and execute runbooks.
• Configure runbook triggers for selected alert conditions.
• Scheduler for periodic command execution.

11) Telegram bot integration

• Configure token and allow-list.
• Run/restart/disable bot daemon.
• Tail bot logs.

12) Security and data management

• Encrypted local registry storage.
• Locker controls to block critical commands until unlock.
• Encrypted export/import bundles for migration and backup.