From b517d8a4bc8584c4870afb6c7ae0dc00675614b9 Mon Sep 17 00:00:00 2001 From: Simon Date: Tue, 3 Nov 2026 18:21:12 +0100 Subject: [PATCH 1/2] docs: improve matrix bot readme --- README.md | 26 ++++++++++++++++++++------ 1 file changed, 20 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index b8cb644..0d74b13 100644 --- a/README.md +++ b/README.md @@ -166,19 +166,33 @@ THX to the previous work of @decentral1se @knooflok @3wc @cellarspoon @mirsal ``` COMPOSE_FILE="$COMPOSE_FILE:compose.matrix-alertmanager-receiver.yml" ``` +
+2. Create a matrix bot account +Create user via cli, e.g. if SSO is enabled +``` +abra app run matrix.example.com app -- sh -c 'register_new_matrix_user -u --no-admin -k "$(cat /var/run/secrets/registration)" http://localhost:8008' +``` +Grab an access token: +``` +curl -XPOST --json '{"type": "m.login.password", "identifier": {"user": "botusername", "type": "m.id.user"}, "password": "passwordforuser"}' "https://matrix.example.com/_matrix/client/v3/login" +``` +
-2. Insert the matrix access token secret: +3. Insert the matrix access token secret: ``` abra app secret insert monitoring.marx.klasse-methode.it matrix_token v1 ``` -3. Set required configurations: +4. Set required configurations: ``` -GF_MATRIX_USER_ID= -GF_MATRIX_ROOM_ID= -GF_MATRIX_HOME_SERVER_URL= +GF_MATRIX_USER_ID= +GF_MATRIX_ROOM_ID= +GF_MATRIX_HOME_SERVER_URL=matrix.example.com ``` -4. Configure Alertmanager webhook and set the url to `http://matrix-alertmanager-receiver:12345/alerts/` +4. Configure Alertmanager webhook: + - Create contact point under Grafana → Alerting → Contact Points → New Contact Point + - Set Integration to "Webhook" + - Set the url to `http://matrix-alertmanager-receiver:12345/alerts/` ### Alerts -- 2.54.0 From b6731345eb87797711efa02268a310c1ca7d9ab1 Mon Sep 17 00:00:00 2001 From: Simon Date: Tue, 3 Nov 2026 18:23:29 +0100 Subject: [PATCH 2/2] docs: remove
shenanigans --- README.md | 11 +++-------- 1 file changed, 3 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 0d74b13..918a1ce 100644 --- a/README.md +++ b/README.md @@ -166,17 +166,12 @@ THX to the previous work of @decentral1se @knooflok @3wc @cellarspoon @mirsal ``` COMPOSE_FILE="$COMPOSE_FILE:compose.matrix-alertmanager-receiver.yml" ``` -
-2. Create a matrix bot account -Create user via cli, e.g. if SSO is enabled +2. Create a matrix bot account and get an access token: + ``` abra app run matrix.example.com app -- sh -c 'register_new_matrix_user -u --no-admin -k "$(cat /var/run/secrets/registration)" http://localhost:8008' -``` -Grab an access token: -``` curl -XPOST --json '{"type": "m.login.password", "identifier": {"user": "botusername", "type": "m.id.user"}, "password": "passwordforuser"}' "https://matrix.example.com/_matrix/client/v3/login" ``` -
3. Insert the matrix access token secret: ``` @@ -189,7 +184,7 @@ GF_MATRIX_USER_ID= GF_MATRIX_ROOM_ID= GF_MATRIX_HOME_SERVER_URL=matrix.example.com ``` -4. Configure Alertmanager webhook: +5. Configure Alertmanager webhook: - Create contact point under Grafana → Alerting → Contact Points → New Contact Point - Set Integration to "Webhook" - Set the url to `http://matrix-alertmanager-receiver:12345/alerts/` -- 2.54.0