Skip to content

feat(mongoose): Instrument mongoose >= 9.7 via native tracing channels#21803

Open
logaretm wants to merge 5 commits into
developfrom
awad/mongoose-tracing-channels
Open

feat(mongoose): Instrument mongoose >= 9.7 via native tracing channels#21803
logaretm wants to merge 5 commits into
developfrom
awad/mongoose-tracing-channels

Conversation

@logaretm

@logaretm logaretm commented Jun 25, 2026

Copy link
Copy Markdown
Member

Instruments mongoose >= 9.7 through its native diagnostics_channel tracing channels instead of monkey-patching, the same way we did for redis/ioredis. The subscription lives in server-utils as mongooseChannelIntegration, and the node mongooseIntegration extends it (via extendIntegration) to keep running the IITM patcher for mongoose < 9.7.

The channel path emits the latest stable DB semconv, so there is an attribute drift. We did that for redis so I thought to do the same here, but we could match the legacy attributes and drop them later for v11 if that's what we want.

@logaretm logaretm force-pushed the awad/mongoose-tracing-channels branch from 668581c to 0e1e4c1 Compare June 25, 2026 17:26
@github-actions

github-actions Bot commented Jun 25, 2026

Copy link
Copy Markdown
Contributor

size-limit report 📦

Path Size % Change Change
@sentry/browser 27.48 kB +0.01% +1 B 🔺
@sentry/browser - with treeshaking flags 25.91 kB - -
@sentry/browser (incl. Tracing) 45.97 kB +0.01% +1 B 🔺
@sentry/browser (incl. Tracing + Span Streaming) 47.72 kB +0.01% +1 B 🔺
@sentry/browser (incl. Tracing, Profiling) 50.76 kB - -
@sentry/browser (incl. Tracing, Replay) 85.22 kB - -
@sentry/browser (incl. Tracing, Replay) - with treeshaking flags 74.81 kB - -
@sentry/browser (incl. Tracing, Replay with Canvas) 89.91 kB - -
@sentry/browser (incl. Tracing, Replay, Feedback) 102.57 kB - -
@sentry/browser (incl. Feedback) 44.66 kB - -
@sentry/browser (incl. sendFeedback) 32.26 kB +0.01% +1 B 🔺
@sentry/browser (incl. FeedbackAsync) 37.4 kB - -
@sentry/browser (incl. Metrics) 28.54 kB - -
@sentry/browser (incl. Logs) 28.78 kB - -
@sentry/browser (incl. Metrics & Logs) 29.47 kB - -
@sentry/react 29.27 kB - -
@sentry/react (incl. Tracing) 48.28 kB +0.01% +1 B 🔺
@sentry/vue 32.63 kB - -
@sentry/vue (incl. Tracing) 47.84 kB - -
@sentry/svelte 27.5 kB - -
CDN Bundle 29.89 kB - -
CDN Bundle (incl. Tracing) 47.89 kB - -
CDN Bundle (incl. Logs, Metrics) 31.44 kB - -
CDN Bundle (incl. Tracing, Logs, Metrics) 49.24 kB +0.01% +1 B 🔺
CDN Bundle (incl. Replay, Logs, Metrics) 70.78 kB - -
CDN Bundle (incl. Tracing, Replay) 85.4 kB - -
CDN Bundle (incl. Tracing, Replay, Logs, Metrics) 86.68 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback) 91.19 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics) 92.45 kB - -
CDN Bundle - uncompressed 88.94 kB - -
CDN Bundle (incl. Tracing) - uncompressed 145.03 kB - -
CDN Bundle (incl. Logs, Metrics) - uncompressed 93.65 kB - -
CDN Bundle (incl. Tracing, Logs, Metrics) - uncompressed 149 kB - -
CDN Bundle (incl. Replay, Logs, Metrics) - uncompressed 218.62 kB - -
CDN Bundle (incl. Tracing, Replay) - uncompressed 264.05 kB - -
CDN Bundle (incl. Tracing, Replay, Logs, Metrics) - uncompressed 268 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback) - uncompressed 277.75 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics) - uncompressed 281.69 kB - -
@sentry/nextjs (client) 50.67 kB - -
@sentry/sveltekit (client) 46.37 kB - -
@sentry/core/server 77.54 kB - -
@sentry/core/browser 63.88 kB - -
@sentry/node-core 61.51 kB - -
@sentry/node 123.98 kB +0.41% +498 B 🔺
@sentry/node/import (ESM hook with diagnostics-channel injection) 69.95 kB - -
@sentry/node/light 50.4 kB - -
@sentry/node - without tracing 73.61 kB - -
@sentry/aws-serverless 84.4 kB +0.01% +2 B 🔺
@sentry/cloudflare (withSentry) - minified 180.31 kB - -
@sentry/cloudflare (withSentry) 446.24 kB - -

View base workflow run

@mydea

mydea commented Jun 26, 2026

Copy link
Copy Markdown
Member

mongooseChannelIntegration

more a general thing, but I think I'd just call this mongooseIntegration? When using this from server-utils this is kind of an implementation detail that is not that relevant, you can just use the integration from there? It's a bit different for the orchestrion ones because they should not be "accidentally" used, but for these with native support I think just calling them "normally" is fine?

@mydea mydea force-pushed the fn/better-integration-extend branch 2 times, most recently from 2407b9e to 31520be Compare June 26, 2026 08:48
Base automatically changed from fn/better-integration-extend to develop June 26, 2026 09:38
@logaretm

Copy link
Copy Markdown
Member Author

Yea I was thinking about this yesterday, we ideally would export those as-is for the environments that do not support module hooks. Will make that change

@logaretm logaretm force-pushed the awad/mongoose-tracing-channels branch from 5a990f3 to 3e8b992 Compare June 26, 2026 11:49
@logaretm logaretm marked this pull request as ready for review June 26, 2026 12:55
@logaretm logaretm requested a review from a team as a code owner June 26, 2026 12:55
@logaretm logaretm requested review from JPeer264, andreiborza, isaacs, mydea and nicohrubec and removed request for a team June 26, 2026 12:55
logaretm added 5 commits June 26, 2026 09:01
Subscribe to mongoose 9.7's native diagnostics_channel tracing channels via
bindTracingChannelToSpan, emitting stable OTel DB semconv. Narrow the vendored
OTel patcher to < 9.7.0 to avoid double instrumentation.
…gration

Runtimes that use the server-utils integration directly expose it to users,
so 'channel' in the name leaks an implementation detail. Node imports it under
an internal alias since it keeps its own composed mongooseIntegration.
@logaretm logaretm force-pushed the awad/mongoose-tracing-channels branch from ccbdd92 to 9cbf9df Compare June 26, 2026 13:01

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 9cbf9df. Configure here.

instrumentMongoose();
},
};
});

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Preload skips mongoose channel subscribe

Medium Severity

For mongoose >=9.7, diagnostics-channel subscription runs only in the server-utils integration setupOnce, while preloadOpenTelemetry invokes instrumentMongoose alone. The IITM patcher no longer covers 9.7+, so mongoose work between preload and Sentry.init() (or any preload-only usage) is not traced.

Additional Locations (1)
Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit 9cbf9df. Configure here.

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