Sys-ctl-alm-compose Role

Description: Unified systemd notification service dispatching service-failure alerts through both Telegram and email channels

Variables

  • author: Kevin Veen-Birkenbach

  • description: Unified systemd notification service dispatching service-failure alerts through both Telegram and email channels

  • license: Infinito.Nexus Community License (Non-Commercial)

  • company: Kevin Veen-Birkenbach https://www.veen.world

  • min_ansible_version: 2.9

  • platforms: [{‘name’: ‘ArchLinux’, ‘versions’: [‘all’]}, {‘name’: ‘Debian’, ‘versions’: [‘all’]}, {‘name’: ‘EL’, ‘versions’: [‘all’]}, {‘name’: ‘Fedora’, ‘versions’: [‘all’]}, {‘name’: ‘Ubuntu’, ‘versions’: [‘all’]}]

  • galaxy_tags: [‘systemd’, ‘notifier’, ‘telegram’, ‘email’, ‘notifications’]

  • issue_tracker_url: https://s.infinito.nexus/issues

README

Unified Service Failure Notifier

Description

This role installs a systemd service that sends notifications via both sys-ctl-alm-telegram and sys-ctl-alm-email when any service fails.

Overview

Optimized for prompt and comprehensive failure alerts, this role configures a unified notification service. It leverages the capabilities of both Telegram and Email notifications to ensure that administrators are quickly informed about service issues, enabling rapid troubleshooting.

Cosmos

The diagram places Unified Service Failure Notifier in the Infinito.Nexus cosmos: the components it deploys (capabilities), the central services it consumes (dependencies), and its outward reach (federation and bridged external networks).

flowchart LR
    subgraph role [sys-ctl-alm-compose 💻]
        svc_compose["compose"]
    end

Solid 1:1 edges are fixed relationships; dashed 0..1 edges are conditional (enabled only in matching deployments); red 0..0 edges are turned off in this role. Node markers show the role’s deploy modes (💻 host, 🐳 compose, 🐝 swarm); ❌ marks a service that is explicitly turned off, and ⚙️ an Ansible role dependency declared in meta/main.yml.

Purpose

The primary purpose of this role is to provide a centralized mechanism for service failure notifications. By integrating with both the Telegram and Email notifier roles, it delivers reliable alerts through multiple channels, enhancing overall system observability and responsiveness.

Features

  • Unified Notification Service: Installs a systemd service that triggers both Telegram and Email alerts.

  • Dependency Integration: Works seamlessly with the sys-ctl-alm-telegram and sys-ctl-alm-email roles.

  • Automated Service Management: Automatically restarts the notifier service upon configuration changes.

  • Centralized Alerting: Provides a unified approach to monitor and notify about service failures.

Credits

Implemented by Kevin Veen-Birkenbach. Part of the Infinito.Nexus Project and maintained by Kevin Veen-Birkenbach. Licensed under the Infinito.Nexus Community License (Non-Commercial).