Service for managing and receiving Alertmanager alerts
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Silke baf6bfb595 Rename ok to resolved 11 months ago
alertmanager Move generic Alertmanager functionality to separate package 1 year ago
matrix Refactor Matrix functionality 1 year ago
.gitignore Add bot interaction 1 year ago
LICENCE.md Add licence and documentation 1 year ago
README.md Fix information icon 1 year ago
alertmanager_matrix.go Add list labels command 1 year ago
alertmanager_matrix.service Rename service/main file to match repo 1 year ago
formatting.go Rename ok to resolved 11 months ago
matrix.go Fix misspelling 1 year ago
prometheus.go Fix status unmarshal 1 year ago
util.go Remove markdown() from util 1 year ago

README.md

alertmanager-matrix

Service for sending alerts from the Alertmanager webhook to a Matrix room and managing Alertmanager.

Usage

The service is configured either through command line arguments or environment variables. With the provided systemd service file (alertmanager_matrix.service), the configuration is done in /etc/default/alertmanager_matrix as follows:

ARGS=""
HOMESERVER=http://localhost:8008
USER_ID=@bot:example.com
TOKEN=<token>

See alertmanager_matrix -help for all possible arguments.

Configure Alertmanager with a webhook to this service:

receivers:
- name: matrix
  webhook_configs:
  - url: "http://localhost:4051/<room_id>"

When the -rooms option is provided the bot will join the listed rooms and only allow commands from these rooms. The service will not automatically join the room given in a webhook.

The icons and colors can be configured by providing a JSON file. The defaults are:

{
	"alert":       "🔔️",
	"information": "ℹ️",
	"warning":     "⚠️",
	"critical":    "🚨",
	"ok":          "✅",
	"silenced":    "🔕"
}
{
	"alert":       "black",
	"information": "blue",
	"warning":     "orange",
	"critical":    "red",
	"ok":          "green",
	"silenced":    "gray"
}