Skip to content

docs(alertmanager): add cluster HA flags to arguments guide#7723

Open
Goutham-Annem wants to merge 1 commit into
cortexproject:masterfrom
Goutham-Annem:docs/4108-alertmanager-cluster-flags
Open

docs(alertmanager): add cluster HA flags to arguments guide#7723
Goutham-Annem wants to merge 1 commit into
cortexproject:masterfrom
Goutham-Annem:docs/4108-alertmanager-cluster-flags

Conversation

@Goutham-Annem

Copy link
Copy Markdown

What this PR does:

Adds a new AlertmanagerAlertmanager cluster (High Availability) section to the Arguments Explained guide.

The new section documents all six -alertmanager.cluster.* flags with their default values and practical guidance:

Flag Default Purpose
-alertmanager.cluster.listen-address 0.0.0.0:9094 Gossip listen address; empty string disables clustering
-alertmanager.cluster.advertise-address (listen addr) Externally reachable address for NAT/Kubernetes
-alertmanager.cluster.peers (none) Comma-separated initial peer list
-alertmanager.cluster.peer-timeout 15s Per-peer notification timeout
-alertmanager.cluster.gossip-interval 200ms Frequency of gossip messages
-alertmanager.cluster.push-pull-interval 60s Full state sync interval

A Kubernetes StatefulSet peer list example is included to help operators get started quickly.

Which issue(s) this PR fixes:
Fixes #4108

Checklist

  • Tests updated (N/A — docs only)
  • Documentation added
  • CHANGELOG.md updated - the order of entries should be [CHANGE], [FEATURE], [ENHANCEMENT], [BUGFIX]
  • docs/configuration/v1-guarantees.md updated if this PR introduces experimental flags (N/A — no new flags)

Note: This PR was developed with AI assistance (Claude Code).

Document the alertmanager.cluster.* flags in the arguments guide:
- listen-address (enables/disables HA mode)
- advertise-address (for NAT/Kubernetes environments)
- peers (comma-separated initial peer list with Kubernetes example)
- peer-timeout (default 15s)
- gossip-interval (default 200ms)
- push-pull-interval (default 60s)

Fixes cortexproject#4108

Signed-off-by: Goutham Annem <gouthemannem@gmail.com>
@dosubot dosubot Bot added component/alertmanager component/documentation type/chore Something that needs to be done; not a bug or a feature labels Jul 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

component/alertmanager component/documentation size/M type/chore Something that needs to be done; not a bug or a feature

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add alertmanager cluster flags to documentation

1 participant