Sys-ctl-alm-telegram Role¶

Description: No description available

Variables¶

author: Kevin Veen-Birkenbach
description: Installs and configures components for sending Telegram notifications through systemd. This role is part of the sys-ctl-alm-compose suite, providing automated alerts when services fail.
license: Infinito.Nexus NonCommercial License
license_url: https://s.infinito.nexus/license
company: Kevin Veen-Birkenbach

Consulting & Coaching Solutions https://www.veen.world

min_ansible_version: 2.9
platforms: [{‘name’: ‘Archlinux’, ‘versions’: [‘rolling’]}]
galaxy_tags: [‘telegram’, ‘systemd’, ‘notifications’, ‘automation’, ‘curl’]
repository: https://s.infinito.nexus/code
issue_tracker_url: https://s.infinito.nexus/issues
documentation: https://docs.infinito.nexus

README¶

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 curl package).
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-compose suite <../>`__ 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.