Skip to content

docs: clarify that --es.aliases requires --es.indices or --es.shards - #1236

Open
locker95 wants to merge 1 commit into
prometheus-community:masterfrom
locker95:docs-aliases-requires-indices
Open

docs: clarify that --es.aliases requires --es.indices or --es.shards#1236
locker95 wants to merge 1 commit into
prometheus-community:masterfrom
locker95:docs-aliases-requires-indices

Conversation

@locker95

@locker95 locker95 commented Sep 1, 2026

Copy link
Copy Markdown

The --es.aliases flag looks like an independent toggle, but the alias metrics are emitted by the Indices collector, which is only registered when --es.indices or --es.shards is set (if *esExportIndices || *esExportShards in main.go). Enabling --es.aliases on its own silently does nothing, and neither --help nor the README mentions the dependency.

This updates the flag help text and the README flags table to state the requirement. No behavior change.

Fixes #1047

The aliases metrics are collected by the Indices collector, which is
only registered when --es.indices or --es.shards is enabled. Enabling
--es.aliases alone has no effect. Document this in the flag help text
and the README flags table.

Fixes prometheus-community#1047

Signed-off-by: Dean Chen <862469039@qq.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

documentation: --es.aliases depends on --es.indices

1 participant