Veeam Telegram Notifier is a lightweight Go application I built for monitoring Veeam Backup & Replication 12 with real-time Telegram notifications. It runs as a Windows Service that watches the Event Log for backup job events and sends filtered alerts — from job failures and VM errors to success confirmations — directly to a Telegram chat. A companion CLI tool integrates as a Post-Job Script for immediate per-job notifications.
Two Components, Complete Coverage
- veeam-monitor-service.exe — Windows Service that continuously monitors the Veeam Event Log. Configurable check interval (default 60 seconds), flexible notification filters, and self-diagnostics
- veeam-notifier.exe — CLI utility designed as a Veeam Post-Job Script. Sends immediate notification when a specific job completes, with full status details
Flexible Notification Filtering
The service-config.json provides granular control over which events trigger Telegram notifications: job started, job finished, job success, job warning, job failed, VM failed, and session events. The recommended production configuration monitors only problems — warnings, failures, and VM errors — keeping noise minimal while ensuring no critical issue goes unnoticed.
Built-in Diagnostics
The service includes comprehensive diagnostic commands: status checks, event log inspection, one-time scan runs, Telegram connectivity tests, and real-event simulation. The -diagnose flag validates the entire pipeline from Event Log access to Telegram delivery.
Technology Stack
- Language: Go (compiled to native Windows executable)
- Windows integration: Windows Service API, Event Log reader
- Notifications: Telegram Bot API
- Build: Python build script with icon embedding
- Configuration: JSON config + .env for secrets
Practical Application
As a Fractional CTO managing backup infrastructure for clients, I need instant visibility into backup failures. Email notifications from Veeam are often delayed or buried. This Veeam Telegram Notifier delivers alerts within seconds to my phone, enabling rapid response to backup failures before they cascade into data loss scenarios.
The source code is available upon request. Contact me for access or infrastructure monitoring consulting.
FAQ
Does it require Veeam Enterprise license?
No. It works with any Veeam Backup & Replication 12 edition by reading the Windows Event Log, not the Veeam API.
Can it monitor multiple Veeam servers?
Each instance monitors one server. For multiple servers, install the service on each and configure different Telegram chat IDs or a shared group.
How fast are notifications?
With the Post-Job Script (veeam-notifier.exe), notifications are instant. The Windows Service checks every 60 seconds by default, configurable down to 10 seconds.
What information is included in alerts?
Job name, status (success/warning/failed), duration, processed VMs, data size, and specific error messages for failures. VM-level failures include the individual VM name and error details.
