Skip to content

Document label-based routing for Prometheus remote write endpoint#6583

Open
felixbarny wants to merge 2 commits into
mainfrom
remote-write-label-routing
Open

Document label-based routing for Prometheus remote write endpoint#6583
felixbarny wants to merge 2 commits into
mainfrom
remote-write-label-routing

Conversation

@felixbarny
Copy link
Copy Markdown
Member

Documents the new label-based routing feature for the Prometheus remote write endpoint, introduced in elastic/elasticsearch#148910.

Previously, routing metrics to different data streams required separate remote_write blocks each targeting a different URL path. This becomes unwieldy when a single Prometheus instance scrapes services that should land in different data streams.

The new data_stream_dataset and data_stream_namespace labels let you attach routing metadata at the individual time series level, so a single endpoint can fan out to multiple data streams. Labels take precedence over the URL path, with unset labels falling back to the path segment value.

The label names use underscores rather than dots to ensure compatibility with all Prometheus versions out of the box — dot-containing label names require Prometheus 2.47+ with --enable-feature=utf8-names.

@felixbarny felixbarny requested review from a team as code owners May 20, 2026 10:38
@github-actions
Copy link
Copy Markdown
Contributor

Elastic Docs AI PR menu

Check the box to run an AI review for this pull request.

  • Review docs changes (docs-review). Status: not started.

Powered by GitHub Agentic Workflows and docs-actions. For more information, reach out to the docs team.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 20, 2026

🔍 Preview links for changed docs

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 20, 2026

✅ Vale Linting Results

No issues found on modified lines!


The Vale linter checks documentation changes against the Elastic Docs style guide.

To use Vale locally or report issues, refer to Elastic style guide for Vale.

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.

1 participant