Grafana Matrix Forwarder

Forward alerts from Grafana to a Matrix chat room

This project provides a simple way to forward alerts generated by Grafana to a Matrix chat room.

An open network for secure, decentralized communication
- Matrix website

I use Grafana a lot to gather and track metrics on various services and servers. When something goes wrong I want to get an automated alert that something went wrong.

This project serves as a translation layer between Grafana and Matrix. Grafana alerts get fired as POST requests, this tool then converts them to Matrix messages, and forwards them on to the specified chat room.


This is not the first time I have experimented with writing tools that integrate with chat protocols. My first experiments were with the XMPP protocol back around 2016.

There are a couple of reasons why I prefer Matrix to XMPP:

  1. End-to-end encryption is more standard
  2. Better SDKs for building apps
  3. Better, more modern chat clients

I wanted a practical way to put the protocol to use, and this is what I came up with.


Hector Smith