Skip to content

docs: update metrics performance note to reflect v2.11 improvement - #558

Open
gbenhaim wants to merge 1 commit into
caddyserver:masterfrom
gbenhaim:docs/update-metrics-performance-note
Open

docs: update metrics performance note to reflect v2.11 improvement#558
gbenhaim wants to merge 1 commit into
caddyserver:masterfrom
gbenhaim:docs/update-metrics-performance-note

Conversation

@gbenhaim

@gbenhaim gbenhaim commented Aug 5, 2026

Copy link
Copy Markdown

The metrics global option documentation currently says:

Note that metrics reduce performance on really busy servers. (Our community is working on improving this. Please get involved!)

This warning was added when metrics were made opt-in in v2.6.0 (September 2022), based on #4644 which profiled the per-handler metricsInstrumentedHandler as consuming up to 73% of request handling CPU time.

Since then, #7492 moved instrumentation from per-handler to per-route collection, yielding ~5x faster metrics with ~5.6x fewer allocations. This fix shipped in v2.11.1 (February 2026).

This PR updates the note to reflect the improvement and link to the PR, replacing the now-stale call-to-action.

AI Disclosure

This PR was authored with assistance from AI tools (Cursor with Claude). All changes have been manually reviewed.

Made with Cursor

The note about metrics reducing performance on busy servers was added
when metrics were made opt-in in v2.6.0 (Sep 2022). Since then, #7492
moved instrumentation from per-handler to per-route, yielding ~5x
faster collection with ~5.6x fewer allocations, and shipped in v2.11.1.

Update the note to reflect the improvement and link to the PR, instead
of the stale call-to-action.

AI Disclosure: This commit was assisted by AI (Cursor with Claude).

Co-authored-by: Cursor <cursoragent@cursor.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.

1 participant