https://github.com/bashclub/check_mk_matrix_notifications

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.
https://github.com/bashclub/check_mk_matrix_notifications

checkmk checkmk-extension matrix matrix-org monitoring notification-service omd synapse

Last synced: 8 days ago
JSON representation

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.

• Host: GitHub
• URL: https://github.com/bashclub/check_mk_matrix_notifications
• Owner: bashclub
• License: mit
• Created: 2021-05-19T11:56:19.000Z (almost 4 years ago)
• Default Branch: master
• Last Pushed: 2021-05-25T19:50:44.000Z (almost 4 years ago)
• Last Synced: 2025-04-14T02:13:41.002Z (8 days ago)
• Topics: checkmk, checkmk-extension, matrix, matrix-org, monitoring, notification-service, omd, synapse
• Language: Python
• Homepage: https://sysops.tv
• Size: 352 KB
• Stars: 9
• Watchers: 1
• Forks: 4
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Check_mk notifications in Matrix

This scripts gives your Check_mk installation a possibility to send notifications into [Matrix](https://matrix.org) chatroom.

## Installation

To install this script do the following:

1. Copy matrix.py file contents into clipboard.

2. Execute ``omd su SITENAME``, where ``SITENAME`` is a site name for OMD. If you're using check_mk installed from source - skip this step.

3. 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.

### Dependencies

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

## Configuration

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:

![Check_mk notifications configuration](/check_mk_notifications_configuration.png)

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.

## How it will look like?

![Check_mk notifications example](/notifications_in_matrix.png)