Skip to content

Document Sentry fingerprinting for timeout grouping#227

Open
nertzy wants to merge 1 commit into
zombocom:mainfrom
nertzy:document-sentry-fingerprinting
Open

Document Sentry fingerprinting for timeout grouping#227
nertzy wants to merge 1 commit into
zombocom:mainfrom
nertzy:document-sentry-fingerprinting

Conversation

@nertzy

@nertzy nertzy commented Jun 3, 2026

Copy link
Copy Markdown

Because rack-timeout raises at whatever line is executing when the request clock expires, similar timeouts get distinct stack traces and Sentry groups them as many separate issues — the same problem the existing Rollbar guide addresses.

This adds doc/sentry.md (mirroring doc/rollbar.md) showing a before_send hook that:

  • groups timeouts by transaction (controller#action) via a custom fingerprint instead of by stack trace,
  • leads the issue title with the route while preserving the original wait/timeout message,
  • matches RequestTimeoutException and the Rack::Timeout::Error base (so RequestTimeoutError and RequestExpiryError are covered regardless of where Sentry's capture middleware sits in the stack),
  • leaves transaction-less timeouts (raised before controller dispatch) on Sentry's default grouping.

Also links the new page from the README's doc list, alongside the Rollbar entry.

rack-timeout raises at whatever line is executing when the request clock
expires, so similar timeouts get distinct stacktraces and Sentry fragments
one slow route into many issues. Add doc/sentry.md (mirroring doc/rollbar.md)
showing a before_send hook that groups timeouts by transaction and leads the
issue title with the route, and link it from the README.
@nertzy

nertzy commented Jun 3, 2026

Copy link
Copy Markdown
Author

(I used AI to build this but it was human-reviewed as well)

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