Skip to content

docs: clarify downstream adapter validation requirements#2101

Merged
zeitlinger merged 2 commits intoprometheus:mainfrom
zeitlinger:docs/downstream-adapter-validation-note
May 6, 2026
Merged

docs: clarify downstream adapter validation requirements#2101
zeitlinger merged 2 commits intoprometheus:mainfrom
zeitlinger:docs/downstream-adapter-validation-note

Conversation

@zeitlinger
Copy link
Copy Markdown
Member

Summary

  • document that downstream MultiCollector adapters must expose registration metadata that matches the metric families they emit at scrape time
  • make the newer suffix/collision validation model more explicit for adapter maintainers

Why

  • the existing release notes already describe the suffix-handling and collision-model change
  • what was missing was explicit guidance that downstream adapters also need their registration-time metadata to stay aligned with emitted MetricSnapshot families

Testing

  • mise run lint

Signed-off-by: Gregor Zeitlinger <gregor.zeitlinger@grafana.com>
Signed-off-by: Gregor Zeitlinger <gregor.zeitlinger@grafana.com>
@zeitlinger zeitlinger merged commit ef8c75c into prometheus:main May 6, 2026
9 checks passed
@zeitlinger zeitlinger deleted the docs/downstream-adapter-validation-note branch May 6, 2026 06:54
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.

2 participants