TelegramNotification Plugin for Graylog
TelegramNotification allows you to send Graylog alert messages to a specified Telegram chat.
Requirements
Requires Graylog 6. Check the release notes for details.
Installation
-
Download the latest TelegramNotification release and place the
graylog-plugin-telegram-notification-x.x.x.jar
file in yourplugin_dir
that is configured in yourgraylog.conf
as described in the Graylog documentation. -
Restart your graylog-server, i.e.
systemctl restart graylog-server
. -
Configure an alert notification as described in the next section.
Usage
Step 1 - Create Bot
Create a new Telegram bot with the BotFather and copy the bot token.
Step 2 - Get Channel ID
Use the Message Tool to find the Chat ID of the desired chat.
You can use a private chat, add the bot to a group-chat or to a channel. Just make sure to copy the correct Channel ID.
Step 3 - Add Notification
Navigate to Alerts > Notifications in your Graylog-interface and select Telegram Notification
as the notification type.
The message is a template that can be configured as described in the Graylog Documentation
Update
To update the plugin you need to remove the old graylog-plugin-telegram-notification-x.x.x.jar
(or telegram-alert-x.x.x.jar
) file from your plugins folder and follow the installation instructions again.
You may need to remove and re-create your Telegram Notifications.
Development
See docs/development/README.md for some notes on how to get started with development.
Contributions are welcome.
Credits
Thanks to:
- Alexey Medov - for his ideas and donation!
- Everyone that starred this repository ⭐️ - you keep me motivated 🙂
- Contributors that submitted useful pull-requests or opened good issues with suggestions or a detailed bug report.