Telegram Bot

Telegram Bot

Knightwatch includes a Telegram bot for remote monitoring and alerting without opening the web dashboard.

Setup

Store your bot token in persistent config:

knightwatch config set telegram-token <YOUR_BOT_TOKEN>

Clear it if needed:

knightwatch config set telegram-token --clear

Verify it was saved:

knightwatch config get telegram-token

Enabling

Pass the --telegram flag at runtime:

knightwatch --pid <PID> --telegram

Notifications

The bot sends push notifications for all process events when tracking at least one process:

• 🟢 Initial snapshot — root and children when tracking begins
• 🆕 Children appeared — new child processes detected
• 🔴 Children exited — specific child PIDs exited
• ✅ All children gone — all child processes have exited
• 💀 Root process exited — the root process itself has stopped

When --system-resources is also enabled:

• ⚠️ CPU threshold exceeded — aggregate CPU usage above 90%
• ⚠️ Memory threshold exceeded — memory usage above 90%
• ⚠️ Disk threshold exceeded — a mount point usage above 90%
• 🔋 Battery low — charge below 15% while discharging
• 🔌 Battery state changed — plugged in, unplugged, or full

When --systemd is also enabled:

• 🔴 Unit failed — a unit transitioned to failed
• 🟢 Unit recovered — a previously failed unit is active again
• 🆕 Unit appeared — a new unit became visible to systemd
• 💨 Unit disappeared — a tracked unit is no longer present