This is the Alertmanager bot for
Prometheus that notifies you on alerts.
Just configure the Alertmanager to send Webhooks to the bot and that's it.
Additionally you can always send commands to get up-to-date information from the alertmanager.
Alertmanager already integrates a lot of different messengers as receivers for alerts.
I want to extend this basic functionality.
Previously the Alertmanager could only talk to you via a chat, but now you can talk back via commands.
You can ask about current ongoing alerts and silences.
In the future I plan to also support silencing via the chat, so you can silences after getting an alert from within the chat.
A lot of other things can be added!
Right now it supports Telegram, but I'd like to add more in the future.
Hey, Matthias! I will now keep you up to date!
/help
Alright, Matthias! I won't talk to you again.
/help
π₯ FIRING π₯
NodeDown (Node scraper.krautreporter:8080 down)
scraper.krautreporter:8080 has been down for more than 1 minute.
Started: 1 week 2 days 3 hours 50 minutes 42 seconds agoπ₯ FIRING π₯ monitored_service_down (MONITORED SERVICE DOWN) The monitoring service 'digitalocean-exporter' is down. Started: 10 seconds ago
NodeDown π
job="ranch-eye" monitor="exporter-metrics" severity="page"
Started: 1 month 1 week 5 days 8 hours 27 minutes 57 seconds ago
Ends: -11 months 2 weeks 2 days 19 hours 15 minutes 24 secondsRancherServiceState π
job="rancher" monitor="exporter-metrics" name="scraper" rancherURL="http://rancher.example.com/v1" severity="page" state="inactive"
Started: 1 week 2 days 3 hours 46 minutes 21 seconds ago
Ends: -3 weeks 1 day 13 minutes 24 seconds
Currently these chat have subscribed: @MetalMatze
AlertManager
Version: 0.5.1
Uptime: 3 weeks 1 day 6 hours 15 minutes 2 seconds
AlertManager Bot
Version: 0.4.3
Uptime: 3 weeks 1 hour 17 minutes 19 seconds
I'm a Prometheus AlertManager Bot for Telegram. I will notify you about alerts.
You can also ask me about my /status, /alerts & /silencesAvailable commands:
/start - Subscribe for alerts.
/stop - Unsubscribe for alerts.
/status - Print the current status.
/alerts - List all alerts.
/silences - List all silences.
/chats - List all users and group chats that subscribed.
docker pull metalmatze/alertmanager-bot:0.4.3
Start as a command:
docker run -d \
-e 'ALERTMANAGER_URL=http://alertmanager:9093' \
-e 'BOLT_PATH=/data/bot.db' \
-e 'STORE=bolt' \
-e 'TELEGRAM_ADMIN=1234567' \
-e 'TELEGRAM_TOKEN=XXX' \
-v '/srv/monitoring/alertmanager-bot:/data' \
--name alertmanager-bot \
metalmatze/alertmanager-bot:0.4.3
docker run -d \
-e 'ALERTMANAGER_URL=http://alertmanager:9093' \
-e 'CONSUL_URL=localhost:8500' \
-e 'STORE=consul' \
-e 'TELEGRAM_ADMIN=1234567' \
-e 'TELEGRAM_TOKEN=XXX' \
--name alertmanager-bot \
metalmatze/alertmanager-bot:0.4.3
docker run -d \
-e 'ALERTMANAGER_URL=http://alertmanager:9093' \
-e 'ETCD_URL=localhost:2379' \
-e 'STORE=etcd' \
-e 'ETCD_TLS_INSECURE=true' \
-e 'TELEGRAM_ADMIN=1234567' \
-e 'TELEGRAM_TOKEN=XXX' \
--name alertmanager-bot \
metalmatze/alertmanager-bot:0.4.2
networks:
alertmanager-bot: {}
services:
alertmanager-bot:
command:
- --alertmanager.url=http://localhost:9093
- --log.level=info
- --store=bolt
- --bolt.path=/data/bot.db
environment:
TELEGRAM_ADMIN: "1234"
TELEGRAM_TOKEN: XXXXXXX
image: metalmatze/alertmanager-bot:0.4.3
networks:
- alertmanager-bot
ports:
- 8080:8080
restart: always
volumes:
- ./data:/data
version: "3"
apiVersion: v1
items:
- apiVersion: v1
data:
admin: MTIzNA==
token: WFhYWFhYWA==
kind: Secret
metadata:
labels:
app.kubernetes.io/name: alertmanager-bot
name: alertmanager-bot
namespace: monitoring
type: Opaque
- apiVersion: v1
kind: Service
metadata:
labels:
app.kubernetes.io/name: alertmanager-bot
name: alertmanager-bot
namespace: monitoring
spec:
ports:
- name: http
port: 8080
targetPort: 8080
selector:
app.kubernetes.io/name: alertmanager-bot
- apiVersion: apps/v1
kind: StatefulSet
metadata:
labels:
app.kubernetes.io/name: alertmanager-bot
name: alertmanager-bot
namespace: monitoring
spec:
podManagementPolicy: OrderedReady
replicas: 1
selector:
matchLabels:
app.kubernetes.io/name: alertmanager-bot
serviceName: alertmanager-bot
template:
metadata:
labels:
app.kubernetes.io/name: alertmanager-bot
name: alertmanager-bot
namespace: monitoring
spec:
containers:
- args:
- --alertmanager.url=http://localhost:9093
- --log.level=info
- --store=bolt
- --bolt.path=/data/bot.db
env:
- name: TELEGRAM_ADMIN
valueFrom:
secretKeyRef:
key: admin
name: alertmanager-bot
- name: TELEGRAM_TOKEN
valueFrom:
secretKeyRef:
key: token
name: alertmanager-bot
image: metalmatze/alertmanager-bot:0.4.3
imagePullPolicy: IfNotPresent
name: alertmanager-bot
ports:
- containerPort: 8080
name: http
resources:
limits:
cpu: 100m
memory: 128Mi
requests:
cpu: 25m
memory: 64Mi
volumeMounts:
- mountPath: /data
name: data
restartPolicy: Always
volumes:
- name: data
persistentVolumeClaim:
claimName: data
volumeClaimTemplates:
- apiVersion: v1
kind: PersistentVolumeClaim
metadata:
labels:
app.kubernetes.io/name: alertmanager-bot
name: alertmanager-bot
namespace: monitoring
spec:
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 1Gi
storageClassName: standard
kind: List
If you prefer using configuration management systems (like Ansible) you might be interested in the following role: mbaran0v.alertmanager-bot
GO111MODULE=on go get github.com/metalmatze/alertmanager-bot/cmd/alertmanager-bot
ENV Variable | CLI flag | Required | Default | Description | |||
---|---|---|---|---|---|---|---|
ALERTMANAGER_URL | alertmanager.url | http://localhost:9093 | Address of the alertmanager | ||||
BOLT_PATH | bolt.path | /tmp/bot.db | Path on disk to the file where the boltdb is stored | ||||
CONSUL_URL | consul.url | localhost:8500 | The URL to use to connect with Consul | ||||
LISTEN_ADDR | listen.addr | 0.0.0.0:8080 | Address that the bot listens for webhooks | ||||
STORE | store | β | The type of the store to use, choose from bolt (local), consul or etcd (distributed) | ||||
STORE_KEY_PREFIX | storeKeyPrefix | telegram/chats | Key prefix for the store | ||||
ETCD_URL | etcd.url | localhost:2379 | The URL that's used to connect to the ETCD store | ||||
ETCD_TLS_INSECURE | etcd.tls.insecure | false | Use TLS connection to ETCD store or not | ||||
ETCD_TLS_INSECURE_SKIP_VERIFY | etcd.tls.insecureSkipVerify | Skip server certificates verification | |||||
ETCD_TLS_CERT | etcd.tls.cert | Path to the TLS cert file | |||||
ETCD_TLS_KEY | etcd.tls.key | Path to the TLS key file | |||||
ETCD_TLS_CACERT | etcd.tls.ca | Path to the TLS trusted CA cert file | |||||
LOG_JSON | log.json | Tell the application to log json and not key value pairs | |||||
LOG_LEVEL | log.level | info | The log level to use for filtering logs. Possible values: debug, info, warn, error | ||||
TELEGRAM_ADMIN | telegram.admin | β | The Telegram user id for the admin. The bot will only reply to messages sent from an admin. All other messages are dropped and logged on the bot's console. Your user id you can get from @userinfobot. | ||||
TELEGRAM_TOKEN | telegram.token | β | Token you get from @botfather | ||||
TEMPLATE_PATHS | template.paths | /templates/default.tmpl | Path to custom message templates |
Additional users may be allowed to command the bot by giving multiple instances
of the --telegram.admin
command line option or by specifying a
newline-separated list of telegram user IDs in the TELEGRAM_ADMIN
environment
variable.
- TELEGRAM_ADMIN="**********\n************"
--telegram.admin=1 --telegram.admin=2
Now you need to connect the Alertmanager to send alerts to the bot.
A webhook is used for that, so make sure your LISTEN_ADDR
is reachable for the Alertmanager.
For example add this to your alertmanager.yml
configuration:
receivers:
- name: 'alertmananger-bot'
webhook_configs:
- send_resolved: true
url: 'http://alertmanager-bot:8080'
Build the binary using make
:
make
In case you have $GOPATH/bin
in your $PATH
you can now simply start the bot by running:
alertmanager-bot
/silence
- show a specific silence/silence_del
- delete a silence by command/silence_add
- add a silence for a alert by command
At the moment I only implemented Telegram, because it's so freakin' easy to do.
Messengers considered to add in the future:
If one is missing for you just open an issue.