A Fork of 'check_mk_matrix_notifications' from Stanislav N. aka pztrn (https://gitlab.com/pztrn/check_mk_matrix_notifications) sends checkmk notifications to a matrix chat server.

Go to file

Stanislav N. aka pztrn b2d19bc5b8 Initial commit.		2019-01-08 22:24:08 +05:00
check_mk_notifications_configuration.png	Initial commit.	2019-01-08 22:24:08 +05:00
matrix.py	Initial commit.	2019-01-08 22:24:08 +05:00
README.md	Initial commit.	2019-01-08 22:24:08 +05:00

Check_mk notifications in Matrix

This scripts gives your Check_mk installation a possibility to send notifications into Matrix chatroom.

Installation

To install this script do the following:

Copy matrix.py file contents into clipboard.
Execute omd su SITENAME, where SITENAME is a site name for OMD. If you're using check_mk installed from source - skip this step.
Open ~/local/share/check_mk/notifications/matrix.py for editing and paste matrix.py file contents into it. Make it executable (chmod +x ~/local/share/check_mk/notifications/matrix.py). Check_mk installed from source can place it's files somewhere else and admins of these installations should figure out by themselves where to put this file.

This script has no dependencies except Python 3. It was written specifically to be very compact and understandable.

This script will send notifications as user, so you should create a separate user for it. Consult your homeserver's documentation about instructions.

You'll need these parameters:

Homeserver URL - this is what you're specifying in Riot and other clients.
Notification bot user's token. To get it log in as created user, tap on settings icon in bottom left part of Riot and scroll in the very end.
Room ID. It's available in room settings.

After obtaining all of them you should create new notification with parameters like this:

Where 1st parameter is a homeserver URL (with http or https), second parameter is a bot user's access token and third parameter is a room ID.