This script enables the integration of Matrix notifications in Checkmk, optionally with E2E.

Notifications are usually sent via a Matrix group / room.

E2E is disabled by default as it requires additional steps to set up. However, you will find instructions below.
Great importance was also attached to an appealing display of messages with optional parameters.

As I do not use Checkmk as a Docker container, I cannot guarantee that it will work. If you have any suggestions, improvements, etc., please open an issue or create a fork and don't hesitate to open a PR.

If the previous state and the current state are identical, only the current state is output.

You can find detailed information about what you need and what is required in the template matrix-notify-py.

Further details can be found in the Configuration section.

On the Checkmk server:

apt install python3-pip

Change to your Checkmk site user, eg. monitoring:

su - SITENAME

Example:

su - monitoring

Install the packages:

pip install requests matrix-commander

Change to the notification directory:

cd ~/local/share/check_mk/notifications/

Download the script from Git repository:

wget https://raw.githubusercontent.com/fuchs-fabian/Checkmk-Matrix-Notifications/master/matrix.py

OR: Copy matrix.py file contents into the clipboard, create, paste and save the file:

nano ./matrix.py

Give the script execution permissions:

chmod +x ./matrix.py

If you decide to send messages end-to-end encrypted, you must continue here! However, if you don't need it, you can skip this part.

/omd/sites/SITENAME/.local/bin/matrix-commander --login PASSWORD --device 'REPLACE-ME' --user-login 'REPLACE-ME' --password 'REPLACE-ME' --homeserver 'REPLACE-ME' --room-default 'REPLACE-ME'

You have to replace all REPLACE-ME with your own credentials!

So that you can verify the session directly without waiting for Checkmk to send a message, you can use the following command.
You will of course need to customise it.

/omd/sites/SITENAME/.local/bin/matrix-commander --room 'REPLACE-ME' --message 'First encrypted message :)'

Verify a session (See also: matrix-notify-py):

/omd/sites/SITENAME/.local/bin/matrix-commander --verify emoji

1. (Activate on selected sites)
2. Restart host or

   su - SITENAME

   omd stop

   omd start

   or

   omd restart

This script has no dependencies except Python 3.10+, the requests and matrix-commander package.

It was written specifically to be very "compact" and understandable.

Create your own notification rule in Checkmk.

Setup → Events → Notifications

• Checkmk Docs
• Checkmk notification logfile

  nano /omd/sites/SITENAME/var/log/notify.log

To retrieve the current date on the host, use the following command:

date

Current output: Wed Feb 28 20:58:22 UTC 2024

To adjust the timezone:

timedatectl set-timezone Europe/Berlin

Expected result: Wed Feb 28 21:58:33 CET 2024

Restart the host or:

su - SITENAME

omd restart

A big difference to other Checkmk notification scripts is that you can test the functionality of whether the message is really sent to Matrix in advance in another operating system. All you have to do is adapt the following lines in the Python script:

CHECKMK_USES_THE_SCRIPT = False
MATRIX_HOMESERVER_URL = ""
MATRIX_ACCESS_TOKEN = ""
MATRIX_ROOM_ID = ""

Remove these entries again after the test!

More information

• Inspiration and partly quoted for the README - Hagbear - LICENSE
• Initial repository - Stanislav N. aka pztrn
• First fork (Replaced urllib.request by requests) - bashclub / Thorsten Spille aka thorstenspille
• Second fork (Prettify output) - rwjack