Notification Plugins
On top of email notifications, you also have the option to install and activate additional notification plugins to integrate with JetBackup, allowing you to send JetBackup notifications via other third-party messaging applications. Below is a list of notification plugins available by default and instructions on how to setup each.
Natively Supported Notification Plugins:
Slack
Create a Slack App
- Visit https://api.slack.com/ and sign-in to your Slack Workspace to create a new app. Specify the name for your app and choose the Slack Workspace where the notification will be sent.
- Under the "Add features and functionality" section, click on "Permissions" .
- Scroll down to "Scopes: Bot Token Scopes", click on "Add an OAuth Scope" and apply the following permissions:
- channles:read
- channels:join
- chat:write
- Click on "Install App to Workspace" then authorize the permissions you have specified for the app.
Slack will then generate a "Bot User OAuth Access Token". Take note of this token as it will be required to authorize the Slack Plugin in JetBackup.
Install and Activate the Slack Plugin
Once you have your Slack App configured, open JetBackup 5 and navigate to the Notification Settings (Settings > Notification).
- On the Slack Notification Plugin, click "Install" then hit "Activate"
- On the Slack Notification Integration window, configure the following available options:
- Select the Notification Alert Levels and the frequency you would like to send your notifications. For more information about alert types, please visit Alerts.
- Specify the Slack Channel Name you would like to receive the JetBackup notifications to.
- Enter the Bot User OAuth Access Token generated in your Slack App then hit "Enable".
JetBackup will then attempt to verify that the Slack Plugin is properly configured by sending a notification to the channel you specified on the plugin, and should receive the following prompt: "JetBackup notification integration configured successfully". JetBackup will now be able to send notifications through Slack.
Syslog
Syslog is used for logging and tracking system messages in the Linux environment. This service constitutes the system log daemon (syslogd), where any program can do its logging in addition to kernel messages.
To Enable this plugin, navigate to Notification Settings (Settings > Notification). On the Syslog Notification Plugin, click "Install" then hit "Activate"
On the Slack Notification Integration window, configure the Notification Alert Levels and the frequency you would like to send your notifications to Slack then hit "Enable". For more information about alert types, please visit Alerts.
Once successfully activated, JetBackup will now be able to send notifications to /var/log/messages via syslog.
Google Hangouts
Configure a JetBackup Google Bot
Visit your Google Developer Console and sign in with your GSuite Account.
On the search box, look for "Hangouts Chat API" and click "ENABLE".
Once enabled, navigate to "Credentials", click "+ CREATE CREDENTIALS" and select "Service Account".
Fill in the necessary information and hit "CREATE". The setup will then ask for optional account and user access permissions which you can skip.
After setting up your JetBackup Bot Service Account, click on the ellipsis icon under the Actions column and click "Create Key"
Choose JSON for the Key type and hit "CREATE". This will download a JSON File which you will use to authenticate the Google Hangouts Plugin in JetBackup.
Once you generate your service account private key, navigate to "Configuration" to configure your JetBackup Bot. On this page, you set up the name, avatar and description for your bot, as well as set permissions and available functionality. Under "Connection settings", select Bot URL and specify your server hostname.
Add Bot to a Google Chat Room
If you don't have a Google Chat Room setup yet, please click here for instructions.
Once you have a Chat Room setup, click on the + icon in the Bot section to open the bot catalog.
Enter the bot name we just configured in the search box. On the Bot Card, click on "Add" > "Add to room" then select which room(s) you would like to add the bot to.
Install and Activate the Google Hangouts Plugin
Once you have your Google Chat Bot and Chat Room configured, open JetBackup 5 and navigate to the Notification Settings (Settings > Notification).
- On the Google Hangouts Notification Plugin, click "Install" then hit "Activate"
- On the Google Hangouts Notification Integration window, configure the following available options:
- Select the Notification Alert Levels and the frequency you would like to send your notifications. For more information about alert types, please visit Alerts.
- Specify the Space Name (Google Chat Room) you would like to receive the JetBackup notifications to.
- Enter the Service Account Key generated in your Google Developer Console then hit "Enable".
JetBackup will then attempt to verify that the Google Hangouts Plugin is properly configured by sending a notification to the space(room) you specified on the plugin. The room should receive the following prompt: "JetBackup notification integration configured successfully". JetBackup will now be able to send notifications through Google Chat.
