Kevin Veen-Birkenbach
b90a2f6c87
Use `systemd-escape --unescape` to restore human-readable unit identifiers in Telegram and Email alerts. Also ensure Telegram messages are URL-encoded and Email status checks try both raw and escaped forms for robustness. Fixes issue where slashes were shown as dashes in notifications. Context: see ChatGPT conversation https://chatgpt.com/share/68a4c171-db08-800f-8399-7e07f237a441
Automated Telegram Alerts for Service Failures
Description
This role installs and configures the necessary components for sending notifications via systemd when a service fails. It sets up the sys-ctl-alm-telegram service and configures parameters and customizable templates for sending messages through Telegram.
Overview
Optimized for real-time alerts, this role is a key component of the overall sys-ctl-alm-compose suite. It ensures that, upon failure of a critical service, a Telegram message is automatically sent to notify administrators and enable prompt troubleshooting.
Purpose
The primary purpose of this role is to provide a robust solution for automated Telegram notifications in a systemd environment. By integrating with Telegram’s Bot API and using customizable message templates, it delivers clear and timely alerts about service failures, thereby enhancing system observability and reliability.
Features
- Service Installation & Configuration: Installs and configures necessary components (including the
curlpackage). - Customizable Templates: Supports tailored Telegram message templates for service failure notifications.
- Secure Notifications: Leverages systemd to trigger alerts automatically when services fail.
- Suite Integration: Part of the
sys-ctl-alm-composesuite which includes related roles such as sys-ctl-alm-email and others.
Other Resources
This role was developed as part of a conversation with OpenAI's ChatGPT and can be found here.