alertmanager(1)
Alertmanager handles alerts sent by client applications and manages their deduplication, grouping, and routing to receivers like email, PagerDuty, and Slack.
Synopsis
alertmanager [OPTION]...Description
Alertmanager is a tool that receives alerts from Prometheus and other monitoring systems, then processes them through a pipeline of deduplication, grouping, and routing rules. It groups related alerts together, suppresses duplicates, and sends notifications to configured receivers (email, Slack, PagerDuty, webhook, etc.) based on custom routing trees.
The tool maintains alert state in memory and persists it to disk for recovery across restarts. It supports silencing and inhibition rules to prevent alert fatigue, and provides a web interface for managing active alerts and configuring silences.
Common options
| Flag | What it does |
|---|---|
--config.file=PATH | Path to the configuration file (YAML format) |
--storage.path=PATH | Directory to store alert state and temporary data |
--web.listen-address=ADDR | Address to bind web server to (default: 0.0.0.0:9093) |
--web.external-url=URL | External URL to use when generating links in web UI and notifications |
--log.level=LEVEL | Log level (debug, info, warn, error) |
--cluster.advertise-address=ADDR | Address to advertise for cluster communication |
--cluster.peer=PEER | Initial cluster peer to connect to (repeatable) |
--cluster.listen-address=ADDR | Address to listen for cluster traffic (default: 0.0.0.0:9094) |
--version | Print version and exit |
Examples
Start Alertmanager with specified config file and persistent storage directory
alertmanager --config.file=/etc/alertmanager/alertmanager.yml --storage.path=/var/lib/alertmanagerRun Alertmanager listening only on localhost for local testing
alertmanager --config.file=alertmanager.yml --web.listen-address=127.0.0.1:9093Start with external URL for notifications and debug logging enabled
alertmanager --config.file=alertmanager.yml --web.external-url=https://alerts.example.com --log.level=debugRun Alertmanager in cluster mode, advertising its address and connecting to peer
alertmanager --config.file=alertmanager.yml --cluster.advertise-address=10.0.1.5:9094 --cluster.peer=10.0.1.1:9094Display the installed Alertmanager version
alertmanager --version