statusboard-notify

Utility for django-statusboard that notifies users about service status changes. The system supports notifications via email, Telegram, and Google Chat.

This app periodically notifies about service status changes - except for changes from "Operational" to "Performance issues" (and viceversa).

Note the notification script attempts to send the message only once for each backend.

Installation

Install the package:

pip install django-statusboard-notify[with_telegram]

Note: this package requires the pandoc command installed on your system. Otherwise you can install the pypandoc_binary package (see https://pypi.org/project/pypandoc/)

If you don't need Telegram notifications, you can install the package without the with_telegram extra.

Configure the application

Add the following applications to your Django projects:

# settings.py
INSTALLED_APPS += [
    'statusboard',
    'statusboard-notify',
]

Internationalization and localization

django-statusboard supports the following languages:

• English
• Italian

Email notification

In order to enable the email notifications, you have to set the sender:

# settings.py
STATUSBOARD_NOTIFY_EMAIL_SENDER = "statusboard@localhost.localdomain

You can edit the subject:

# settings.py
STATUSBOARD_NOTIFY_EMAIL_SUBJECT = "Mysubject"

You can add a list of recipients that will receive the notifications about all the services:

# settings.py
STATUSBOARD_NOTIFY_EMAIL_RECIPIENTS = [
    "admin@localhost.localdomain",
    "anotheradmin@localhost.localdomain",
]

From the admin page you can associate an existing user to one or more services:

The email is sent in two formats: plain text and html. The email is created using the template statusboard_notify/templates/statusboard_notify/email.html and then is converted using pypandoc to create the plain text version.

It's possibile to customize the footer of the email: create the file templates/statusboard_notify/email.html that extends the original template:

{% extends "statusboard_notify/email.html" %}
{% block footer %}
    <footer class="footer">
        For more informations please visit <a href="https://localhost.localdomain/status">the statuspage</a>
    </footer>
{% endblock %}

Telegram notification

In order to enable the Telegram notifications, you have to:

1. Create a bot with BotFather.
2. Create a channel.
3. Make your bot an admin of your channel.
4. Go to https://web.telegram.org and open the channel: the URL is something like https://web.telegram.org/#/im?p=c1234567890_1231231231231231231. The channel id is the concatenation of -100 and the numbers between c and _ (in the example, 1234567890, then the chat id is -1001234567890).

Then add the following variables to your settings.py.

# settings.py
STATUSBOARD_NOTIFY_TELEGRAM_TOKEN = "TELEGRAM-TOKEN-FROM-BOTFATHER"
STATUSBOARD_NOTIFY_TELEGRAM_CHAT_ID = -1001234567890

Google Chat notification

To enable the Google Chat notifications, configure the STATUSBOARD_NOTIFY_GOOGLE_CHAT_WEBHOOK_URL setting.

Configure the notification script

The notifications are fired by command send_notifications, that reads the notification queue from the DB and sends the services status changes to the recipients (the notifications are then removed).

You can activate the command using crontab, systemd, celery, etc. Below, an example with crontab:

# Check every 10 minutes for service status changes
*/10 * * * * /path/to/django/project/manage.py send_notifications

Contact and copyright information

Copyright (C) 2021-2026 Emanuele Di Giacomo emanuele@digiacomo.cc

django-statusboard-notify is licensed under GPLv2+.