amtool¶
Die Kommandozeile für den Alertmanager von Prometheus: seine Konfiguration prüfen, aktive Alarme zeigen und sie während Wartungen stummschalten.

Syntax¶
amtool [--alertmanager.url=URL] check-config | alert query | silence add | silence query | silence expire
Optionen¶
| Befehl | Beschreibung |
|---|---|
check-config DATEI |
alertmanager.yml prüfen |
alert query [MATCHER] |
Aktive Alarme zeigen, z. B. alertname=InstanceDown |
silence add MATCHER --duration=2h --comment=… |
Passende Alarme für eine Weile stummschalten |
silence query |
Aktive Stummschaltungen auflisten (-q: nur IDs) |
silence expire ID |
Eine Stummschaltung vorzeitig beenden |
config routes |
Den Routing-Baum zeigen: wer welchen Alarm bekommt |
--alertmanager.url= |
Adresse des Alertmanagers, z. B. http://localhost:9093 |
Trag die Adresse in ~/.config/amtool/config.yml ein (alertmanager.url: http://localhost:9093), dann kannst du --alertmanager.url weglassen.
Beispiele¶
Die Konfiguration prüfen:
amtool check-config /etc/prometheus/alertmanager.yml
Checking '/etc/prometheus/alertmanager.yml' SUCCESS
Found:
- global config
- route
- 0 inhibit rules
- 1 receivers
- 0 templates
Aktive Alarme:
amtool --alertmanager.url=http://localhost:9093 alert query
Alertname Starts At Summary State
InstanceDown 2026-10-26 09:38:05 UTC 192.0.2.21:9100 is down active
Einen Server für zwei Stunden Wartung stummschalten:
amtool --alertmanager.url=http://localhost:9093 silence add instance=192.0.2.21:9100 \
--duration=2h --comment="Kernel update" --author=nox
10e4013c-0d68-430c-b174-6ffc507daab7
Die Ausgabe ist die ID der Stummschaltung. Solange sie läuft, haben Alarme für 192.0.2.21:9100 den Zustand suppressed und verschicken keine Mails.
Die aktiven Stummschaltungen auflisten:
amtool --alertmanager.url=http://localhost:9093 silence query
ID Matchers Ends At Created By Comment
10e4013c-0d68-430c-b174-6ffc507daab7 instance="192.0.2.21:9100" 2026-10-26 11:42:17 UTC nox Kernel update
Nach der Wartung alle Stummschaltungen beenden:
amtool --alertmanager.url=http://localhost:9093 silence expire $(amtool --alertmanager.url=http://localhost:9093 silence query -q)
echo $?
0
Wer die Alarme bekommt:
amtool --alertmanager.url=http://localhost:9093 config routes
Routing tree:
.
└── default-route receiver: admin
Wann brauche ich das?¶
- Vor einer geplanten Wartung, damit ein Neustart niemanden weckt
- Um nach einer Änderung an
alertmanager.ymlzu prüfen, ob die Datei gültig ist - Um ohne Weboberfläche zu sehen, welche Alarme aktiv sind
Vorher stummschalten, nicht hinterher
Setz die Stummschaltung, bevor die Wartung beginnt: amtool silence add instance=~"web01.*"
--duration=1h --comment="Kernel-Update". Danach beendet silence expire sie, damit spätere
Probleme wieder gemeldet werden.
Stummschaltungen verdecken echte Probleme
Eine Stummschaltung mit breitem Matcher (severity=critical) oder langer Dauer verschluckt
auch Alarme, die mit der Wartung nichts zu tun haben. Halte den Matcher eng und die Dauer
kurz.
Unterschiede zwischen Distributionen¶
| Debian | Ubuntu | RHEL | Arch | |
|---|---|---|---|---|
| Paket | prometheus-alertmanager |
prometheus-alertmanager |
nicht in den Paketquellen: Release-Archiv oder Container prom/alertmanager |
alertmanager |
| Alertmanager-Dienst | prometheus-alertmanager |
prometheus-alertmanager |
eigene systemd-Unit | alertmanager |
| Konfiguration | /etc/prometheus/alertmanager.yml |
/etc/prometheus/alertmanager.yml |
je nach Einrichtung | /etc/alertmanager/alertmanager.yml |
Verwandte Befehle¶
promtool · prometheus · node_exporter · curl