Skip to content

tigattack/VeeamNotify

Repository files navigation

VeeamNotify

Send Veeam Backup & Replication session summary notifications to Discord, Microsoft Teams, and Slack, detailing session result and statistics and optionally alerting you via mention when a job finishes in a warning or failed state.

VeeamNotify is a replacement for VeeamDiscordNotifications and the respective Teams and Slack projects, featuring improvements across the board and support for all the aforementioned messaging services in one, easy to use project.

Supported Notification Services

  • Discord
  • Slack
  • Microsoft Teams
  • Telegram

Please create a feature request if your preferred service isn't listed here.

Supported Veeam Job Types

  • VM Backup
  • VM Replication
  • Windows & Linux Agent Backup jobs*

*Agent job support

Due to limitations in Veeam, only some types of Agent jobs are supported.

Supported jobs are known as "Agent Backup" or "Managed by backup server". Unsupported jobs are known as "Agent policy" or "Managed by agent". See the spoilered illustration below if this isn't clear to you.

Illustrated screenshot showing an example of supported types

Note: Linux Agent Backup jobs are also supported, this image is only an example.

You can read about the difference between these two Agent job types here.

Unfortunately, even supported Agent jobs return a reduced amount of session information, so you won't see as much detail in the notification (see the example screenshots at the top).
As much relevant information as I've been able to discover from such backup sessions is included in the notifications, but I welcome any suggestions for improvement in this area.

Installation

Requirements:

  • Veeam Backup & Replication 11 or higher.
  • PowerShell 5.1 or higher.

Please see the How to Install wiki page.

Configuration

Default configuration can be found in C:\VeeamScripts\VeeamNotify\config\conf.json

Details and examples can be found in the Configuration Options wiki page.


Credits

MelonSmasher//TheSageColleges for the project which inspired me to make this.
dantho281 for various things - Assistance with silly little issues, the odd bugfix here and there, and the inspiration for and first works on the Updater.ps1 script.
Lee_Dailey for general pointers and the first revision of the ConvertTo-ByteUnit function.
philenst for committing or assisting with a number of core components of the project.
s0yun for the Installer.ps1 script.

Thank you all.