Skip to main content

🏗️ Matrix

Use the interactive kwatch manager to configure Matrix alerts. It stores credentials in Kubernetes Secrets and verifies the installation. The configuration fragments below explain provider settings; they are not separate installation steps.

ParameterDescriptionRequired
alert.matrix.homeServer🖥️ HomeServer URLYes
alert.matrix.accessToken🔑 Access tokenYes
alert.matrix.internalRoomID🆔 Room IDYes
alert.matrix.title✏️ Custom titleNo
alert.matrix.text✏️ Custom textNo

Configuration example​

alert:
matrix:
homeServer: "https://matrix.example.com"
accessToken: "${file:/config/matrix-access-token}"
internalRoomID: "!roomid:example.com"
title: "optional customized title"
text: "optional customized text"

Routing​

alert:
matrix:
homeServer: "https://matrix.example.com"
accessToken: "${file:/config/matrix-access-token}"
internalRoomID: "!roomid:example.com"
routes:
- namespaces: ["production"]
severities: ["high", "critical"]
- reasons: ["OOMKilled"]

Retry​

alert:
matrix:
homeServer: "https://matrix.example.com"
accessToken: "${file:/config/matrix-access-token}"
internalRoomID: "!roomid:example.com"
retry:
maxAttempts: 5
delay: 5s

Fallback​

alert:
matrix:
homeServer: "https://matrix.example.com"
accessToken: "${file:/config/matrix-access-token}"
internalRoomID: "!roomid:example.com"
fallback: <another_provider>

Compact mode​

alert:
matrix:
homeServer: "https://matrix.example.com"
accessToken: "${file:/config/matrix-access-token}"
internalRoomID: "!roomid:example.com"
compact: true

Screenshot​

Matrix notification screenshot