observability/roles/matrix-alertmanager/README.md

finallycoffee.observability.matrix-alertmanager ansible role

Overview

Runs matrix-alertmanager in a docker container, and bridges alerts from alertmanager into a configured matrix room (per configured receiver).

Configuration

Required configuration

The following variables need to be defined in order for matrix-alertmanager to be able to work:

• matrix_alertmanager_secret: The secret configured in alertmanager for this receiver
• matrix_alertmanager_homeserver_url: URL to the homeserver to log in to, including scheme and port.
• matrix_alertmanager_mxid: The matrix ID in the form @local:server.tld to use
• matrix_alertmanager_access_token: The matrix access token for matrix_alertmanager_mxid (Note: this is not the password)
• matrix_alertmanager_rooms: A list of objects { name, room_id } where name is the receiver name in alertmanager and room_id is a matrix room ID (not an alias)