21 lines
985 B
Markdown
21 lines
985 B
Markdown
|
# `finallycoffee.observability.matrix-alertmanager` ansible role
|
||
|
|
|
||
|
|
## Overview
|
||
|
|
|
||
|
|
Runs [matrix-alertmanager](https://github.com/jaywink/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)
|