OS Manuals

/usr/bin/alertmanager

Prometheus Alertmanager

From prometheus-alertmanager 0.32.1-r3 (os), captured 2026-11-05 by running alertmanager --help (exit 0). permalink

Also provided by 2 other package versions
usage: alertmanager [<flags>]


Flags:
  -h, --[no-]help                Show context-sensitive help (also try --help-long and --help-man).
      --config.file="alertmanager.yml"
                                 Alertmanager configuration file name.
      --storage.path="data/"     Base path for data storage.
      --data.retention=120h      How long to keep data for.
      --data.maintenance-interval=15m
                                 Interval between garbage collection and snapshotting to disk of the
                                 silences and the notification logs.
      --silences.max-silences=0  Maximum number of silences, including expired silences. If negative
                                 or zero, no limit is set.
      --silences.max-silence-size-bytes=0
                                 Maximum silence size in bytes. If negative or zero, no limit is
                                 set.
      --[no-]log.silences        Enable logging silences. If it is enabled, the status change of
                                 silence will be logged
      --alerts.gc-interval=30m   Interval between alert GC.
      --alerts.per-alertname-limit=0
                                 Maximum number of alerts per alertname. If negative or zero,
                                 no limit is set.
      --dispatch.maintenance-interval=30s
                                 Interval between maintenance of aggregation groups in the
                                 dispatcher.
      --dispatch.start-delay=0s  Minimum amount of time to wait before dispatching alerts. This
                                 option should be synced with value of --rules.alert.resend-delay on
                                 Prometheus.
      --[no-]web.systemd-socket  Use systemd socket activation listeners instead of port listeners
                                 (Linux only).
      --web.listen-address=:9093 ...
                                 Addresses on which to expose metrics and web interface. Repeatable
                                 for multiple addresses. Examples: `:9100` or `[::1]:9100` for http,
                                 `vsock://:9100` for vsock
      --web.config.file=""       Path to configuration file that can
                                 enable TLS or authentication. See:
                                 https://github.com/prometheus/exporter-toolkit/blob/master/docs/web-configuration.md
      --web.external-url=WEB.EXTERNAL-URL
                                 The URL under which Alertmanager is externally reachable (for
                                 example, if Alertmanager is served via a reverse proxy). Used for
                                 generating relative and absolute links back to Alertmanager itself.
                                 If the URL has a path portion, it will be used to prefix all
                                 HTTP endpoints served by Alertmanager. If omitted, relevant URL
                                 components will be derived automatically.
      --web.route-prefix=WEB.ROUTE-PREFIX
                                 Prefix for the internal routes of web endpoints. Defaults to path
                                 of --web.external-url.
      --web.get-concurrency=0    Maximum number of GET requests processed concurrently. If negative
                                 or zero, the limit is GOMAXPROC or 8, whichever is larger.
      --web.timeout=0            Timeout for HTTP requests. If negative or zero, no timeout is set.
      --auto-gomemlimit.ratio=0.9
                                 The ratio of reserved GOMEMLIMIT memory to the detected maximum
                                 container or system memory. The value must be greater than 0 and
                                 less than or equal to 1.
      --cluster.listen-address="0.0.0.0:9094"
                                 Listen address for cluster. Set to empty string to disable HA mode.
      --cluster.advertise-address=CLUSTER.ADVERTISE-ADDRESS
                                 Explicit address to advertise in cluster.
      --cluster.peer-name=""     Explicit name of the peer, rather than generating a random one
      --cluster.peer=CLUSTER.PEER ...
                                 Initial peers (may be repeated).
      --cluster.peer-timeout=15s
                                 Time to wait between peers to send notifications.
      --cluster.peers-resolve-timeout=15s
                                 Time to resolve peers.
      --cluster.gossip-interval=200ms
                                 Interval between sending gossip messages. By lowering this value
                                 (more frequent) gossip messages are propagated across the cluster
                                 more quickly at the expense of increased bandwidth.
      --cluster.pushpull-interval=1m0s
                                 Interval for gossip state syncs. Setting this interval lower (more
                                 frequent) will increase convergence speeds across larger clusters
                                 at the expense of increased bandwidth usage.
      --cluster.tcp-timeout=10s  Timeout for establishing a stream connection with a remote node for
                                 a full state sync, and for stream read and write operations.
      --cluster.probe-timeout=500ms
                                 Timeout to wait for an ack from a probed node before assuming it is
                                 unhealthy. This should be set to 99-percentile of RTT (round-trip
                                 time) on your network.
      --cluster.probe-interval=1s
                                 Interval between random node probes. Setting this lower (more
                                 frequent) will cause the cluster to detect failed nodes more
                                 quickly at the expense of increased bandwidth usage.
      --cluster.settle-timeout=1m0s
                                 Maximum time to wait for cluster connections to settle before
                                 evaluating notifications.
      --cluster.reconnect-interval=10s
                                 Interval between attempting to reconnect to lost peers.
      --cluster.reconnect-timeout=6h0m0s
                                 Length of time to attempt to reconnect to a lost peer.
      --cluster.tls-config=""    [EXPERIMENTAL] Path to config yaml file that can enable mutual TLS
                                 within the gossip protocol.
      --[no-]cluster.allow-insecure-public-advertise-address-discovery
                                 [EXPERIMENTAL] Allow alertmanager to discover and listen on a
                                 public IP address.
      --cluster.label=""         The cluster label is an optional string to include on each packet
                                 and stream. It uniquely identifies the cluster and prevents
                                 cross-communication issues when sending gossip messages.
      --enable-feature=""        Comma-separated experimental features to enable. Valid options:
                                 alert-names-in-metrics, receiver-name-in-metrics, classic-mode,
                                 utf8-strict-mode, auto-gomemlimit, auto-gomaxprocs
      --log.level=info           Only log messages with the given severity or above. One of: [debug,
                                 info, warn, error]
      --log.format=logfmt        Output format of log messages. One of: [logfmt, json]
      --[no-]version             Show application version.
Options (37)
OptionDescriptionSource
-hShow context-sensitive help (also try --help-long and --help-man).help
--config.file "alertmanager.yml"Alertmanager configuration file name.help
--storage.path "data/"Base path for data storage.help
--data.retention 120hHow long to keep data for.help
--data.maintenance-interval 15mInterval between garbage collection and snapshotting to disk of the silences and the notification logs.help
--silences.max-silences 0Maximum number of silences, including expired silences.help
--silences.max-silence-size-bytes 0Maximum silence size in bytes.help
--alerts.gc-interval 30mInterval between alert GC.help
--alerts.per-alertname-limit 0Maximum number of alerts per alertname.help
--dispatch.maintenance-interval 30sInterval between maintenance of aggregation groups in the dispatcher.help
--dispatch.start-delay 0sMinimum amount of time to wait before dispatching alerts.help
--web.listen-address :9093Addresses on which to expose metrics and web interface.help
--web.config.file ""Path to configuration file that can enable TLS or authentication.help
--web.external-url WEB.EXTERNAL-URLThe URL under which Alertmanager is externally reachable (for example, if Alertmanager is served via a reverse proxy).help
--web.route-prefix WEB.ROUTE-PREFIXPrefix for the internal routes of web endpoints.help
--web.get-concurrency 0Maximum number of GET requests processed concurrently.help
--web.timeout 0Timeout for HTTP requests.help
--auto-gomemlimit.ratio 0.9The ratio of reserved GOMEMLIMIT memory to the detected maximum container or system memory.help
--cluster.listen-address "0.0.0.0:9094"Listen address for cluster.help
--cluster.advertise-address CLUSTER.ADVERTISE-ADDRESSExplicit address to advertise in cluster.help
--cluster.peer-name ""Explicit name of the peer, rather than generating a random onehelp
--cluster.peer CLUSTER.PEERInitial peers (may be repeated).help
--cluster.peer-timeout 15sTime to wait between peers to send notifications.help
--cluster.peers-resolve-timeout 15sTime to resolve peers.help
--cluster.gossip-interval 200msInterval between sending gossip messages.help
--cluster.pushpull-interval 1m0sInterval for gossip state syncs.help
--cluster.tcp-timeout 10sTimeout for establishing a stream connection with a remote node for a full state sync, and for stream read and write operations.help
--cluster.probe-timeout 500msTimeout to wait for an ack from a probed node before assuming it is unhealthy.help
--cluster.probe-interval 1sInterval between random node probes.help
--cluster.settle-timeout 1m0sMaximum time to wait for cluster connections to settle before evaluating notifications.help
--cluster.reconnect-interval 10sInterval between attempting to reconnect to lost peers.help
--cluster.reconnect-timeout 6h0m0sLength of time to attempt to reconnect to a lost peer.help
--cluster.tls-config ""[EXPERIMENTAL] Path to config yaml file that can enable mutual TLS within the gossip protocol.help
--cluster.label ""The cluster label is an optional string to include on each packet and stream.help
--enable-feature ""Comma-separated experimental features to enable.help
--log.level infoOnly log messages with the given severity or above.help
--log.format logfmtOutput format of log messages.help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.