OS Manuals

/usr/bin/alertmanager

Prometheus Alertmanager

From prometheus-alertmanager 0.34.2-r1 (enterprise-packages), captured 2026-11-08 by running alertmanager --help (exit 0). permalink

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.cors.origin=WEB.CORS.ORIGIN
                                 Regex for CORS origin. It is fully anchored, so it must match the
                                 whole origin including scheme and port, and dots must be escaped.
                                 Browser pages from matching origins may call the API. Example:
                                 'https?://(domain1|domain2)\.com'. If empty, no CORS headers are
                                 sent.
      --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,
                                 group-key-in-metrics, classic-mode, utf8-strict-mode,
                                 auto-gomemlimit, event-recorder
      --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 (38)
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.cors.origin WEB.CORS.ORIGINRegex for CORS origin.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.