feat(server-utils): Migrate @opentelemetry/instrumentation-mysql2 to orchestrion - #22229

Merged
mydea merged 5 commits into
developfrom
francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion
Jul 15, 2026
Merged

feat(server-utils): Migrate @opentelemetry/instrumentation-mysql2 to orchestrion#22229
mydea merged 5 commits into
developfrom
francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion

Conversation

@mydea

@mydeamydea commented Jul 13, 2026

Copy link
Copy Markdown
Member

Rewrites the mysql2 instrumentation from an OpenTelemetry InstrumentationBase patcher to a node:diagnostics_channel listener, with orchestrion injecting the channel into the instrumented module ..(#21923) migrations.

  • The orchestrion config covers both mysql2 file layouts (Connection in lib/connection.js for < 3.11.5; BaseConnection in lib/base/connection.js for >= 3.11.5).

Fixes#20763

🤖 Generated with Claude Code

@mydea
mydea requested review from a team as code ownersJuly 13, 2026 14:42
@mydea
mydea requested review from JPeer264, andreiborza and isaacs and removed request for a teamJuly 13, 2026 14:42
@linear-code

Copy link
Copy Markdown

JS-2414

@mydea
mydea marked this pull request as draft July 13, 2026 14:45
@github-actions

github-actionsBot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

size-limit report 📦

PathSize% ChangeChange
@sentry/browser27.65 kB--
@sentry/browser - with treeshaking flags26.1 kB--
@sentry/browser (incl. Tracing)46.42 kB--
@sentry/browser (incl. Tracing + Span Streaming)48.21 kB--
@sentry/browser (incl. Tracing, Profiling)51.2 kB--
@sentry/browser (incl. Tracing, Replay)85.67 kB--
@sentry/browser (incl. Tracing, Replay) - with treeshaking flags75.31 kB--
@sentry/browser (incl. Tracing, Replay with Canvas)90.38 kB--
@sentry/browser (incl. Tracing, Replay, Feedback)103.04 kB--
@sentry/browser (incl. Feedback)44.83 kB--
@sentry/browser (incl. sendFeedback)32.45 kB--
@sentry/browser (incl. FeedbackAsync)37.58 kB--
@sentry/browser (incl. Metrics)28.74 kB--
@sentry/browser (incl. Logs)28.98 kB--
@sentry/browser (incl. Metrics & Logs)29.67 kB--
@sentry/react29.45 kB--
@sentry/react (incl. Tracing)48.68 kB--
@sentry/vue33.08 kB--
@sentry/vue (incl. Tracing)48.4 kB--
@sentry/svelte27.67 kB--
CDN Bundle30.05 kB--
CDN Bundle (incl. Tracing)48.41 kB--
CDN Bundle (incl. Logs, Metrics)31.64 kB--
CDN Bundle (incl. Tracing, Logs, Metrics)49.71 kB--
CDN Bundle (incl. Replay, Logs, Metrics)70.87 kB--
CDN Bundle (incl. Tracing, Replay)85.9 kB--
CDN Bundle (incl. Tracing, Replay, Logs, Metrics)87.21 kB--
CDN Bundle (incl. Tracing, Replay, Feedback)91.7 kB--
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics)92.97 kB--
CDN Bundle - uncompressed89.58 kB--
CDN Bundle (incl. Tracing) - uncompressed146.33 kB--
CDN Bundle (incl. Logs, Metrics) - uncompressed94.29 kB--
CDN Bundle (incl. Tracing, Logs, Metrics) - uncompressed150.31 kB--
CDN Bundle (incl. Replay, Logs, Metrics) - uncompressed219.02 kB--
CDN Bundle (incl. Tracing, Replay) - uncompressed265.54 kB--
CDN Bundle (incl. Tracing, Replay, Logs, Metrics) - uncompressed269.5 kB--
CDN Bundle (incl. Tracing, Replay, Feedback) - uncompressed279.24 kB--
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics) - uncompressed283.19 kB--
@sentry/nextjs (client)51.22 kB--
@sentry/sveltekit (client)46.86 kB--
@sentry/core/server78.51 kB--
@sentry/core/browser64.86 kB--
@sentry/node-core62.79 kB-0.01%-1 B 🔽
@sentry/node125.19 kB-0.01%-1 B 🔽
@sentry/node (incl. diagnostics channel injection)140.22 kB+0.18%+247 B 🔺
@sentry/node/import (ESM hook with diagnostics-channel injection)69.96 kB--
@sentry/node/light50.8 kB-0.01%-1 B 🔽
@sentry/node - without tracing74.17 kB--
@sentry/aws-serverless83.38 kB-0.01%-4 B 🔽
@sentry/cloudflare (withSentry) - minified181.79 kB--
@sentry/cloudflare (withSentry)449.98 kB--

View base workflow run


const INTEGRATION_NAME = 'Mysql2' as const;
const ORIGIN = 'auto.db.orchestrion.mysql2';
const DB_SYSTEM_VALUE_MYSQL = 'mysql';

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

Note: I decided to drop db.connection_string as we just build this from other attributes, so it is redundant information. we have this in some other places, e.g. mongo, postgres, ioredis, we can either drop those while migrating or also drop it in v11, both are fine IMHO.

...(host ? { [NET_PEER_NAME]: host } : {}),
// oxlint-disable-next-line typescript/no-deprecated
...(portIsNumber ? { [NET_PEER_PORT]: portNumber } : {}),
};

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Missing JDBC connection string attribute

Medium Severity

The orchestrion mysql2 span attributes omit db.connection_string, while the vendored @opentelemetry/instrumentation-mysql2 patcher and the orchestrion mysql integration always emit a JDBC-style connection string. Opt-in orchestrion users lose that attribute on query and execute spans for mysql2 versions below 3.20.0.

Fix in CursorFix in Web

Reviewed by Cursor Bugbot for commit be9e15d. Configure here.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

on purpose

Comment threadpackages/server-utils/src/integrations/tracing-channel/mysql2.ts Outdated
@mydea
mydea marked this pull request as ready for review July 14, 2026 07:52

@cursorcursorBot 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.

There are 2 total unresolved issues (including 1 from previous review).

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 2eb8253. Configure here.

origin: ORIGIN,
data: expect.objectContaining({
'db.system': 'mysql',
'db.statement': 'SELECT 42 AS scalar_value',

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Just a general question (out of scope for this PR): But db.statement/db.query.text should ideally be sanitized. However, this statement includes the actual value 42. Is it possible to sanitize/parametrize this?

Same for description

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

this is actually parametrized when it is parametrized in the code - here the test was wrong/failing, I just fixed this ^^

};
}

const _mysql2ChannelIntegration = (() => {

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This integration probably also needs to be added to Deno: https://github.com/getsentry/sentry-javascript/tree/develop/packages/deno/src/integrations

(if mysql2 is expected to work on Deno)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

And if this needs a Deno wrapper: this should have a guard (usually done with a closure like in redis) so it's not running twice.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

I would keep this in a separate/follow up PR IMHO, we do not need to do this at the same time :)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I wonder if rather than one-off each Deno integration, there's a way to have the Deno SDK automatically slurp these all up. They're all pretty much identical, after all, and exported by server-utils. 🤔

@mydea
mydeaforce-pushed the francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion branch from 2eb8253 to bf47d65CompareJuly 14, 2026 11:27

@JPeer264JPeer264 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM


return {
// oxlint-disable-next-line typescript/no-deprecated
...(database ? { [DB_NAME]: database } : {}),

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

super-l: Following is better to read (same for the ones below:

Suggested change
...(database ? {[DB_NAME]: database} : {}),
[DB_NAME]: database||undefined,

or the following if we don't care about falsy values:

Suggested change
...(database ? {[DB_NAME]: database} : {}),
[DB_NAME]: database,

@isaacsisaacs left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM

// bind values are left as `?` placeholders in `db.statement` (not inlined)
expect.objectContaining({
description: 'SELECT NOW()',
description: 'SELECT ? as a, ? as b, NOW() as c',

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Much more useful test 👍

};
}

const _mysql2ChannelIntegration = (() => {

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I wonder if rather than one-off each Deno integration, there's a way to have the Deno SDK automatically slurp these all up. They're all pretty much identical, after all, and exported by server-utils. 🤔

mydeaand others added 5 commits July 15, 2026 09:08
…o orchestrion
Rewrites the mysql2 instrumentation from an OTel `InstrumentationBase` patcher
to a diagnostics-channel listener with orchestrion injecting the channel into
the instrumented module, mirroring the mysql/kafkajs migrations.
Adds an opt-in `mysql2ChannelIntegration` (registered in `channelIntegrations`,
so `@sentry/node`/`@sentry/bun` swap it in for the OTel `Mysql2` integration
when diagnostics-channel injection is enabled). It subscribes to the injected
`orchestrion:mysql2:query`/`:execute` channels for mysql2 < 3.20.0 and to
mysql2's native tracing channels for >= 3.20.0, so the two ranges never overlap.
The orchestrion config uses `kind: 'Callback'` rather than `'Auto'`: `Auto`'s
no-callback branch probes the return value for `.then`, but mysql2's
callback-less `query(sql)` returns a `Query` whose `.then()` throws, which would
crash streamed queries. `Callback` traces the callback and promise forms (the
common case) and leaves the rarely-used row-streaming form untouched.
Fixes#20763
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mydea
mydeaforce-pushed the francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion branch from bf47d65 to fbe6507CompareJuly 15, 2026 07:08
@mydea
mydea enabled auto-merge (squash) July 15, 2026 07:08
@mydea
mydea merged commit 331026a into developJul 15, 2026
222 checks passed
@mydea
mydea deleted the francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion branch July 15, 2026 07:25
Sign up for freeto 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.

Rewrite @opentelemetry/instrumentation-mysql2 to orchestrion

5 participants

@mydea@isaacs@JPeer264@s1gr1d@andreiborza
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

feat(server-utils): Migrate @opentelemetry/instrumentation-mysql2 to orchestrion - #22229

Merged
mydea merged 5 commits into
developfrom
francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion
Jul 15, 2026
Merged

feat(server-utils): Migrate @opentelemetry/instrumentation-mysql2 to orchestrion#22229
mydea merged 5 commits into
developfrom
francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion

Conversation

@mydea

@mydeamydea commented Jul 13, 2026

Copy link
Copy Markdown
Member

Rewrites the mysql2 instrumentation from an OpenTelemetry InstrumentationBase patcher to a node:diagnostics_channel listener, with orchestrion injecting the channel into the instrumented module ..(#21923) migrations.

  • The orchestrion config covers both mysql2 file layouts (Connection in lib/connection.js for < 3.11.5; BaseConnection in lib/base/connection.js for >= 3.11.5).

Fixes#20763

🤖 Generated with Claude Code

@mydea
mydea requested review from a team as code ownersJuly 13, 2026 14:42
@mydea
mydea requested review from JPeer264, andreiborza and isaacs and removed request for a teamJuly 13, 2026 14:42
@linear-code

Copy link
Copy Markdown

JS-2414

@mydea
mydea marked this pull request as draft July 13, 2026 14:45
@github-actions

github-actionsBot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

size-limit report 📦

PathSize% ChangeChange
@sentry/browser27.65 kB--
@sentry/browser - with treeshaking flags26.1 kB--
@sentry/browser (incl. Tracing)46.42 kB--
@sentry/browser (incl. Tracing + Span Streaming)48.21 kB--
@sentry/browser (incl. Tracing, Profiling)51.2 kB--
@sentry/browser (incl. Tracing, Replay)85.67 kB--
@sentry/browser (incl. Tracing, Replay) - with treeshaking flags75.31 kB--
@sentry/browser (incl. Tracing, Replay with Canvas)90.38 kB--
@sentry/browser (incl. Tracing, Replay, Feedback)103.04 kB--
@sentry/browser (incl. Feedback)44.83 kB--
@sentry/browser (incl. sendFeedback)32.45 kB--
@sentry/browser (incl. FeedbackAsync)37.58 kB--
@sentry/browser (incl. Metrics)28.74 kB--
@sentry/browser (incl. Logs)28.98 kB--
@sentry/browser (incl. Metrics & Logs)29.67 kB--
@sentry/react29.45 kB--
@sentry/react (incl. Tracing)48.68 kB--
@sentry/vue33.08 kB--
@sentry/vue (incl. Tracing)48.4 kB--
@sentry/svelte27.67 kB--
CDN Bundle30.05 kB--
CDN Bundle (incl. Tracing)48.41 kB--
CDN Bundle (incl. Logs, Metrics)31.64 kB--
CDN Bundle (incl. Tracing, Logs, Metrics)49.71 kB--
CDN Bundle (incl. Replay, Logs, Metrics)70.87 kB--
CDN Bundle (incl. Tracing, Replay)85.9 kB--
CDN Bundle (incl. Tracing, Replay, Logs, Metrics)87.21 kB--
CDN Bundle (incl. Tracing, Replay, Feedback)91.7 kB--
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics)92.97 kB--
CDN Bundle - uncompressed89.58 kB--
CDN Bundle (incl. Tracing) - uncompressed146.33 kB--
CDN Bundle (incl. Logs, Metrics) - uncompressed94.29 kB--
CDN Bundle (incl. Tracing, Logs, Metrics) - uncompressed150.31 kB--
CDN Bundle (incl. Replay, Logs, Metrics) - uncompressed219.02 kB--
CDN Bundle (incl. Tracing, Replay) - uncompressed265.54 kB--
CDN Bundle (incl. Tracing, Replay, Logs, Metrics) - uncompressed269.5 kB--
CDN Bundle (incl. Tracing, Replay, Feedback) - uncompressed279.24 kB--
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics) - uncompressed283.19 kB--
@sentry/nextjs (client)51.22 kB--
@sentry/sveltekit (client)46.86 kB--
@sentry/core/server78.51 kB--
@sentry/core/browser64.86 kB--
@sentry/node-core62.79 kB-0.01%-1 B 🔽
@sentry/node125.19 kB-0.01%-1 B 🔽
@sentry/node (incl. diagnostics channel injection)140.22 kB+0.18%+247 B 🔺
@sentry/node/import (ESM hook with diagnostics-channel injection)69.96 kB--
@sentry/node/light50.8 kB-0.01%-1 B 🔽
@sentry/node - without tracing74.17 kB--
@sentry/aws-serverless83.38 kB-0.01%-4 B 🔽
@sentry/cloudflare (withSentry) - minified181.79 kB--
@sentry/cloudflare (withSentry)449.98 kB--

View base workflow run


const INTEGRATION_NAME = 'Mysql2' as const;
const ORIGIN = 'auto.db.orchestrion.mysql2';
const DB_SYSTEM_VALUE_MYSQL = 'mysql';

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

Note: I decided to drop db.connection_string as we just build this from other attributes, so it is redundant information. we have this in some other places, e.g. mongo, postgres, ioredis, we can either drop those while migrating or also drop it in v11, both are fine IMHO.

...(host ? { [NET_PEER_NAME]: host } : {}),
// oxlint-disable-next-line typescript/no-deprecated
...(portIsNumber ? { [NET_PEER_PORT]: portNumber } : {}),
};

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Missing JDBC connection string attribute

Medium Severity

The orchestrion mysql2 span attributes omit db.connection_string, while the vendored @opentelemetry/instrumentation-mysql2 patcher and the orchestrion mysql integration always emit a JDBC-style connection string. Opt-in orchestrion users lose that attribute on query and execute spans for mysql2 versions below 3.20.0.

Fix in CursorFix in Web

Reviewed by Cursor Bugbot for commit be9e15d. Configure here.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

on purpose

Comment threadpackages/server-utils/src/integrations/tracing-channel/mysql2.ts Outdated
@mydea
mydea marked this pull request as ready for review July 14, 2026 07:52

@cursorcursorBot 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.

There are 2 total unresolved issues (including 1 from previous review).

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 2eb8253. Configure here.

origin: ORIGIN,
data: expect.objectContaining({
'db.system': 'mysql',
'db.statement': 'SELECT 42 AS scalar_value',

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Just a general question (out of scope for this PR): But db.statement/db.query.text should ideally be sanitized. However, this statement includes the actual value 42. Is it possible to sanitize/parametrize this?

Same for description

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

this is actually parametrized when it is parametrized in the code - here the test was wrong/failing, I just fixed this ^^

};
}

const _mysql2ChannelIntegration = (() => {

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This integration probably also needs to be added to Deno: https://github.com/getsentry/sentry-javascript/tree/develop/packages/deno/src/integrations

(if mysql2 is expected to work on Deno)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

And if this needs a Deno wrapper: this should have a guard (usually done with a closure like in redis) so it's not running twice.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

I would keep this in a separate/follow up PR IMHO, we do not need to do this at the same time :)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I wonder if rather than one-off each Deno integration, there's a way to have the Deno SDK automatically slurp these all up. They're all pretty much identical, after all, and exported by server-utils. 🤔

@mydea
mydeaforce-pushed the francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion branch from 2eb8253 to bf47d65CompareJuly 14, 2026 11:27

@JPeer264JPeer264 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM


return {
// oxlint-disable-next-line typescript/no-deprecated
...(database ? { [DB_NAME]: database } : {}),

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

super-l: Following is better to read (same for the ones below:

Suggested change
...(database ? {[DB_NAME]: database} : {}),
[DB_NAME]: database||undefined,

or the following if we don't care about falsy values:

Suggested change
...(database ? {[DB_NAME]: database} : {}),
[DB_NAME]: database,

@isaacsisaacs left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM

// bind values are left as `?` placeholders in `db.statement` (not inlined)
expect.objectContaining({
description: 'SELECT NOW()',
description: 'SELECT ? as a, ? as b, NOW() as c',

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Much more useful test 👍

};
}

const _mysql2ChannelIntegration = (() => {

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I wonder if rather than one-off each Deno integration, there's a way to have the Deno SDK automatically slurp these all up. They're all pretty much identical, after all, and exported by server-utils. 🤔

mydeaand others added 5 commits July 15, 2026 09:08
…o orchestrion
Rewrites the mysql2 instrumentation from an OTel `InstrumentationBase` patcher
to a diagnostics-channel listener with orchestrion injecting the channel into
the instrumented module, mirroring the mysql/kafkajs migrations.
Adds an opt-in `mysql2ChannelIntegration` (registered in `channelIntegrations`,
so `@sentry/node`/`@sentry/bun` swap it in for the OTel `Mysql2` integration
when diagnostics-channel injection is enabled). It subscribes to the injected
`orchestrion:mysql2:query`/`:execute` channels for mysql2 < 3.20.0 and to
mysql2's native tracing channels for >= 3.20.0, so the two ranges never overlap.
The orchestrion config uses `kind: 'Callback'` rather than `'Auto'`: `Auto`'s
no-callback branch probes the return value for `.then`, but mysql2's
callback-less `query(sql)` returns a `Query` whose `.then()` throws, which would
crash streamed queries. `Callback` traces the callback and promise forms (the
common case) and leaves the rarely-used row-streaming form untouched.
Fixes#20763
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mydea
mydeaforce-pushed the francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion branch from bf47d65 to fbe6507CompareJuly 15, 2026 07:08
@mydea
mydea enabled auto-merge (squash) July 15, 2026 07:08
@mydea
mydea merged commit 331026a into developJul 15, 2026
222 checks passed
@mydea
mydea deleted the francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion branch July 15, 2026 07:25
Sign up for freeto 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.

Rewrite @opentelemetry/instrumentation-mysql2 to orchestrion

5 participants

@mydea@isaacs@JPeer264@s1gr1d@andreiborza
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

feat(server-utils): Migrate @opentelemetry/instrumentation-mysql2 to orchestrion - #22229

Merged
mydea merged 5 commits into
developfrom
francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion
Jul 15, 2026
Merged

feat(server-utils): Migrate @opentelemetry/instrumentation-mysql2 to orchestrion#22229
mydea merged 5 commits into
developfrom
francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion

Conversation

@mydea

@mydeamydea commented Jul 13, 2026

Copy link
Copy Markdown
Member

Rewrites the mysql2 instrumentation from an OpenTelemetry InstrumentationBase patcher to a node:diagnostics_channel listener, with orchestrion injecting the channel into the instrumented module ..(#21923) migrations.

  • The orchestrion config covers both mysql2 file layouts (Connection in lib/connection.js for < 3.11.5; BaseConnection in lib/base/connection.js for >= 3.11.5).

Fixes#20763

🤖 Generated with Claude Code

@mydea
mydea requested review from a team as code ownersJuly 13, 2026 14:42
@mydea
mydea requested review from JPeer264, andreiborza and isaacs and removed request for a teamJuly 13, 2026 14:42
@linear-code

Copy link
Copy Markdown

JS-2414

@mydea
mydea marked this pull request as draft July 13, 2026 14:45
@github-actions

github-actionsBot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

size-limit report 📦

PathSize% ChangeChange
@sentry/browser27.65 kB--
@sentry/browser - with treeshaking flags26.1 kB--
@sentry/browser (incl. Tracing)46.42 kB--
@sentry/browser (incl. Tracing + Span Streaming)48.21 kB--
@sentry/browser (incl. Tracing, Profiling)51.2 kB--
@sentry/browser (incl. Tracing, Replay)85.67 kB--
@sentry/browser (incl. Tracing, Replay) - with treeshaking flags75.31 kB--
@sentry/browser (incl. Tracing, Replay with Canvas)90.38 kB--
@sentry/browser (incl. Tracing, Replay, Feedback)103.04 kB--
@sentry/browser (incl. Feedback)44.83 kB--
@sentry/browser (incl. sendFeedback)32.45 kB--
@sentry/browser (incl. FeedbackAsync)37.58 kB--
@sentry/browser (incl. Metrics)28.74 kB--
@sentry/browser (incl. Logs)28.98 kB--
@sentry/browser (incl. Metrics & Logs)29.67 kB--
@sentry/react29.45 kB--
@sentry/react (incl. Tracing)48.68 kB--
@sentry/vue33.08 kB--
@sentry/vue (incl. Tracing)48.4 kB--
@sentry/svelte27.67 kB--
CDN Bundle30.05 kB--
CDN Bundle (incl. Tracing)48.41 kB--
CDN Bundle (incl. Logs, Metrics)31.64 kB--
CDN Bundle (incl. Tracing, Logs, Metrics)49.71 kB--
CDN Bundle (incl. Replay, Logs, Metrics)70.87 kB--
CDN Bundle (incl. Tracing, Replay)85.9 kB--
CDN Bundle (incl. Tracing, Replay, Logs, Metrics)87.21 kB--
CDN Bundle (incl. Tracing, Replay, Feedback)91.7 kB--
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics)92.97 kB--
CDN Bundle - uncompressed89.58 kB--
CDN Bundle (incl. Tracing) - uncompressed146.33 kB--
CDN Bundle (incl. Logs, Metrics) - uncompressed94.29 kB--
CDN Bundle (incl. Tracing, Logs, Metrics) - uncompressed150.31 kB--
CDN Bundle (incl. Replay, Logs, Metrics) - uncompressed219.02 kB--
CDN Bundle (incl. Tracing, Replay) - uncompressed265.54 kB--
CDN Bundle (incl. Tracing, Replay, Logs, Metrics) - uncompressed269.5 kB--
CDN Bundle (incl. Tracing, Replay, Feedback) - uncompressed279.24 kB--
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics) - uncompressed283.19 kB--
@sentry/nextjs (client)51.22 kB--
@sentry/sveltekit (client)46.86 kB--
@sentry/core/server78.51 kB--
@sentry/core/browser64.86 kB--
@sentry/node-core62.79 kB-0.01%-1 B 🔽
@sentry/node125.19 kB-0.01%-1 B 🔽
@sentry/node (incl. diagnostics channel injection)140.22 kB+0.18%+247 B 🔺
@sentry/node/import (ESM hook with diagnostics-channel injection)69.96 kB--
@sentry/node/light50.8 kB-0.01%-1 B 🔽
@sentry/node - without tracing74.17 kB--
@sentry/aws-serverless83.38 kB-0.01%-4 B 🔽
@sentry/cloudflare (withSentry) - minified181.79 kB--
@sentry/cloudflare (withSentry)449.98 kB--

View base workflow run


const INTEGRATION_NAME = 'Mysql2' as const;
const ORIGIN = 'auto.db.orchestrion.mysql2';
const DB_SYSTEM_VALUE_MYSQL = 'mysql';

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

Note: I decided to drop db.connection_string as we just build this from other attributes, so it is redundant information. we have this in some other places, e.g. mongo, postgres, ioredis, we can either drop those while migrating or also drop it in v11, both are fine IMHO.

...(host ? { [NET_PEER_NAME]: host } : {}),
// oxlint-disable-next-line typescript/no-deprecated
...(portIsNumber ? { [NET_PEER_PORT]: portNumber } : {}),
};

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Missing JDBC connection string attribute

Medium Severity

The orchestrion mysql2 span attributes omit db.connection_string, while the vendored @opentelemetry/instrumentation-mysql2 patcher and the orchestrion mysql integration always emit a JDBC-style connection string. Opt-in orchestrion users lose that attribute on query and execute spans for mysql2 versions below 3.20.0.

Fix in CursorFix in Web

Reviewed by Cursor Bugbot for commit be9e15d. Configure here.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

on purpose

Comment threadpackages/server-utils/src/integrations/tracing-channel/mysql2.ts Outdated
@mydea
mydea marked this pull request as ready for review July 14, 2026 07:52

@cursorcursorBot 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.

There are 2 total unresolved issues (including 1 from previous review).

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 2eb8253. Configure here.

origin: ORIGIN,
data: expect.objectContaining({
'db.system': 'mysql',
'db.statement': 'SELECT 42 AS scalar_value',

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Just a general question (out of scope for this PR): But db.statement/db.query.text should ideally be sanitized. However, this statement includes the actual value 42. Is it possible to sanitize/parametrize this?

Same for description

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

this is actually parametrized when it is parametrized in the code - here the test was wrong/failing, I just fixed this ^^

};
}

const _mysql2ChannelIntegration = (() => {

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This integration probably also needs to be added to Deno: https://github.com/getsentry/sentry-javascript/tree/develop/packages/deno/src/integrations

(if mysql2 is expected to work on Deno)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

And if this needs a Deno wrapper: this should have a guard (usually done with a closure like in redis) so it's not running twice.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

I would keep this in a separate/follow up PR IMHO, we do not need to do this at the same time :)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I wonder if rather than one-off each Deno integration, there's a way to have the Deno SDK automatically slurp these all up. They're all pretty much identical, after all, and exported by server-utils. 🤔

@mydea
mydeaforce-pushed the francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion branch from 2eb8253 to bf47d65CompareJuly 14, 2026 11:27

@JPeer264JPeer264 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM


return {
// oxlint-disable-next-line typescript/no-deprecated
...(database ? { [DB_NAME]: database } : {}),

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

super-l: Following is better to read (same for the ones below:

Suggested change
...(database ? {[DB_NAME]: database} : {}),
[DB_NAME]: database||undefined,

or the following if we don't care about falsy values:

Suggested change
...(database ? {[DB_NAME]: database} : {}),
[DB_NAME]: database,

@isaacsisaacs left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM

// bind values are left as `?` placeholders in `db.statement` (not inlined)
expect.objectContaining({
description: 'SELECT NOW()',
description: 'SELECT ? as a, ? as b, NOW() as c',

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Much more useful test 👍

};
}

const _mysql2ChannelIntegration = (() => {

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I wonder if rather than one-off each Deno integration, there's a way to have the Deno SDK automatically slurp these all up. They're all pretty much identical, after all, and exported by server-utils. 🤔

mydeaand others added 5 commits July 15, 2026 09:08
…o orchestrion
Rewrites the mysql2 instrumentation from an OTel `InstrumentationBase` patcher
to a diagnostics-channel listener with orchestrion injecting the channel into
the instrumented module, mirroring the mysql/kafkajs migrations.
Adds an opt-in `mysql2ChannelIntegration` (registered in `channelIntegrations`,
so `@sentry/node`/`@sentry/bun` swap it in for the OTel `Mysql2` integration
when diagnostics-channel injection is enabled). It subscribes to the injected
`orchestrion:mysql2:query`/`:execute` channels for mysql2 < 3.20.0 and to
mysql2's native tracing channels for >= 3.20.0, so the two ranges never overlap.
The orchestrion config uses `kind: 'Callback'` rather than `'Auto'`: `Auto`'s
no-callback branch probes the return value for `.then`, but mysql2's
callback-less `query(sql)` returns a `Query` whose `.then()` throws, which would
crash streamed queries. `Callback` traces the callback and promise forms (the
common case) and leaves the rarely-used row-streaming form untouched.
Fixes#20763
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mydea
mydeaforce-pushed the francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion branch from bf47d65 to fbe6507CompareJuly 15, 2026 07:08
@mydea
mydea enabled auto-merge (squash) July 15, 2026 07:08
@mydea
mydea merged commit 331026a into developJul 15, 2026
222 checks passed
@mydea
mydea deleted the francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion branch July 15, 2026 07:25
Sign up for freeto 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.

Rewrite @opentelemetry/instrumentation-mysql2 to orchestrion

5 participants

@mydea@isaacs@JPeer264@s1gr1d@andreiborza
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

feat(server-utils): Migrate @opentelemetry/instrumentation-mysql2 to orchestrion - #22229

Merged
mydea merged 5 commits into
developfrom
francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion
Jul 15, 2026
Merged

feat(server-utils): Migrate @opentelemetry/instrumentation-mysql2 to orchestrion#22229
mydea merged 5 commits into
developfrom
francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion

Conversation

@mydea

@mydeamydea commented Jul 13, 2026

Copy link
Copy Markdown
Member

Rewrites the mysql2 instrumentation from an OpenTelemetry InstrumentationBase patcher to a node:diagnostics_channel listener, with orchestrion injecting the channel into the instrumented module ..(#21923) migrations.

  • The orchestrion config covers both mysql2 file layouts (Connection in lib/connection.js for < 3.11.5; BaseConnection in lib/base/connection.js for >= 3.11.5).

Fixes#20763

🤖 Generated with Claude Code

@mydea
mydea requested review from a team as code ownersJuly 13, 2026 14:42
@mydea
mydea requested review from JPeer264, andreiborza and isaacs and removed request for a teamJuly 13, 2026 14:42
@linear-code

Copy link
Copy Markdown

JS-2414

@mydea
mydea marked this pull request as draft July 13, 2026 14:45
@github-actions

github-actionsBot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

size-limit report 📦

PathSize% ChangeChange
@sentry/browser27.65 kB--
@sentry/browser - with treeshaking flags26.1 kB--
@sentry/browser (incl. Tracing)46.42 kB--
@sentry/browser (incl. Tracing + Span Streaming)48.21 kB--
@sentry/browser (incl. Tracing, Profiling)51.2 kB--
@sentry/browser (incl. Tracing, Replay)85.67 kB--
@sentry/browser (incl. Tracing, Replay) - with treeshaking flags75.31 kB--
@sentry/browser (incl. Tracing, Replay with Canvas)90.38 kB--
@sentry/browser (incl. Tracing, Replay, Feedback)103.04 kB--
@sentry/browser (incl. Feedback)44.83 kB--
@sentry/browser (incl. sendFeedback)32.45 kB--
@sentry/browser (incl. FeedbackAsync)37.58 kB--
@sentry/browser (incl. Metrics)28.74 kB--
@sentry/browser (incl. Logs)28.98 kB--
@sentry/browser (incl. Metrics & Logs)29.67 kB--
@sentry/react29.45 kB--
@sentry/react (incl. Tracing)48.68 kB--
@sentry/vue33.08 kB--
@sentry/vue (incl. Tracing)48.4 kB--
@sentry/svelte27.67 kB--
CDN Bundle30.05 kB--
CDN Bundle (incl. Tracing)48.41 kB--
CDN Bundle (incl. Logs, Metrics)31.64 kB--
CDN Bundle (incl. Tracing, Logs, Metrics)49.71 kB--
CDN Bundle (incl. Replay, Logs, Metrics)70.87 kB--
CDN Bundle (incl. Tracing, Replay)85.9 kB--
CDN Bundle (incl. Tracing, Replay, Logs, Metrics)87.21 kB--
CDN Bundle (incl. Tracing, Replay, Feedback)91.7 kB--
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics)92.97 kB--
CDN Bundle - uncompressed89.58 kB--
CDN Bundle (incl. Tracing) - uncompressed146.33 kB--
CDN Bundle (incl. Logs, Metrics) - uncompressed94.29 kB--
CDN Bundle (incl. Tracing, Logs, Metrics) - uncompressed150.31 kB--
CDN Bundle (incl. Replay, Logs, Metrics) - uncompressed219.02 kB--
CDN Bundle (incl. Tracing, Replay) - uncompressed265.54 kB--
CDN Bundle (incl. Tracing, Replay, Logs, Metrics) - uncompressed269.5 kB--
CDN Bundle (incl. Tracing, Replay, Feedback) - uncompressed279.24 kB--
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics) - uncompressed283.19 kB--
@sentry/nextjs (client)51.22 kB--
@sentry/sveltekit (client)46.86 kB--
@sentry/core/server78.51 kB--
@sentry/core/browser64.86 kB--
@sentry/node-core62.79 kB-0.01%-1 B 🔽
@sentry/node125.19 kB-0.01%-1 B 🔽
@sentry/node (incl. diagnostics channel injection)140.22 kB+0.18%+247 B 🔺
@sentry/node/import (ESM hook with diagnostics-channel injection)69.96 kB--
@sentry/node/light50.8 kB-0.01%-1 B 🔽
@sentry/node - without tracing74.17 kB--
@sentry/aws-serverless83.38 kB-0.01%-4 B 🔽
@sentry/cloudflare (withSentry) - minified181.79 kB--
@sentry/cloudflare (withSentry)449.98 kB--

View base workflow run


const INTEGRATION_NAME = 'Mysql2' as const;
const ORIGIN = 'auto.db.orchestrion.mysql2';
const DB_SYSTEM_VALUE_MYSQL = 'mysql';

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

Note: I decided to drop db.connection_string as we just build this from other attributes, so it is redundant information. we have this in some other places, e.g. mongo, postgres, ioredis, we can either drop those while migrating or also drop it in v11, both are fine IMHO.

...(host ? { [NET_PEER_NAME]: host } : {}),
// oxlint-disable-next-line typescript/no-deprecated
...(portIsNumber ? { [NET_PEER_PORT]: portNumber } : {}),
};

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Missing JDBC connection string attribute

Medium Severity

The orchestrion mysql2 span attributes omit db.connection_string, while the vendored @opentelemetry/instrumentation-mysql2 patcher and the orchestrion mysql integration always emit a JDBC-style connection string. Opt-in orchestrion users lose that attribute on query and execute spans for mysql2 versions below 3.20.0.

Fix in CursorFix in Web

Reviewed by Cursor Bugbot for commit be9e15d. Configure here.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

on purpose

Comment threadpackages/server-utils/src/integrations/tracing-channel/mysql2.ts Outdated
@mydea
mydea marked this pull request as ready for review July 14, 2026 07:52

@cursorcursorBot 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.

There are 2 total unresolved issues (including 1 from previous review).

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 2eb8253. Configure here.

origin: ORIGIN,
data: expect.objectContaining({
'db.system': 'mysql',
'db.statement': 'SELECT 42 AS scalar_value',

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Just a general question (out of scope for this PR): But db.statement/db.query.text should ideally be sanitized. However, this statement includes the actual value 42. Is it possible to sanitize/parametrize this?

Same for description

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

this is actually parametrized when it is parametrized in the code - here the test was wrong/failing, I just fixed this ^^

};
}

const _mysql2ChannelIntegration = (() => {

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This integration probably also needs to be added to Deno: https://github.com/getsentry/sentry-javascript/tree/develop/packages/deno/src/integrations

(if mysql2 is expected to work on Deno)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

And if this needs a Deno wrapper: this should have a guard (usually done with a closure like in redis) so it's not running twice.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

I would keep this in a separate/follow up PR IMHO, we do not need to do this at the same time :)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I wonder if rather than one-off each Deno integration, there's a way to have the Deno SDK automatically slurp these all up. They're all pretty much identical, after all, and exported by server-utils. 🤔

@mydea
mydeaforce-pushed the francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion branch from 2eb8253 to bf47d65CompareJuly 14, 2026 11:27

@JPeer264JPeer264 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM


return {
// oxlint-disable-next-line typescript/no-deprecated
...(database ? { [DB_NAME]: database } : {}),

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

super-l: Following is better to read (same for the ones below:

Suggested change
...(database ? {[DB_NAME]: database} : {}),
[DB_NAME]: database||undefined,

or the following if we don't care about falsy values:

Suggested change
...(database ? {[DB_NAME]: database} : {}),
[DB_NAME]: database,

@isaacsisaacs left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM

// bind values are left as `?` placeholders in `db.statement` (not inlined)
expect.objectContaining({
description: 'SELECT NOW()',
description: 'SELECT ? as a, ? as b, NOW() as c',

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Much more useful test 👍

};
}

const _mysql2ChannelIntegration = (() => {

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I wonder if rather than one-off each Deno integration, there's a way to have the Deno SDK automatically slurp these all up. They're all pretty much identical, after all, and exported by server-utils. 🤔

mydeaand others added 5 commits July 15, 2026 09:08
…o orchestrion
Rewrites the mysql2 instrumentation from an OTel `InstrumentationBase` patcher
to a diagnostics-channel listener with orchestrion injecting the channel into
the instrumented module, mirroring the mysql/kafkajs migrations.
Adds an opt-in `mysql2ChannelIntegration` (registered in `channelIntegrations`,
so `@sentry/node`/`@sentry/bun` swap it in for the OTel `Mysql2` integration
when diagnostics-channel injection is enabled). It subscribes to the injected
`orchestrion:mysql2:query`/`:execute` channels for mysql2 < 3.20.0 and to
mysql2's native tracing channels for >= 3.20.0, so the two ranges never overlap.
The orchestrion config uses `kind: 'Callback'` rather than `'Auto'`: `Auto`'s
no-callback branch probes the return value for `.then`, but mysql2's
callback-less `query(sql)` returns a `Query` whose `.then()` throws, which would
crash streamed queries. `Callback` traces the callback and promise forms (the
common case) and leaves the rarely-used row-streaming form untouched.
Fixes#20763
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mydea
mydeaforce-pushed the francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion branch from bf47d65 to fbe6507CompareJuly 15, 2026 07:08
@mydea
mydea enabled auto-merge (squash) July 15, 2026 07:08
@mydea
mydea merged commit 331026a into developJul 15, 2026
222 checks passed
@mydea
mydea deleted the francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion branch July 15, 2026 07:25
Sign up for freeto 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.

Rewrite @opentelemetry/instrumentation-mysql2 to orchestrion

5 participants

@mydea@isaacs@JPeer264@s1gr1d@andreiborza
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

feat(server-utils): Migrate @opentelemetry/instrumentation-mysql2 to orchestrion - #22229

Merged
mydea merged 5 commits into
developfrom
francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion
Jul 15, 2026
Merged

feat(server-utils): Migrate @opentelemetry/instrumentation-mysql2 to orchestrion#22229
mydea merged 5 commits into
developfrom
francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion

Conversation

@mydea

@mydeamydea commented Jul 13, 2026

Copy link
Copy Markdown
Member

Rewrites the mysql2 instrumentation from an OpenTelemetry InstrumentationBase patcher to a node:diagnostics_channel listener, with orchestrion injecting the channel into the instrumented module ..(#21923) migrations.

  • The orchestrion config covers both mysql2 file layouts (Connection in lib/connection.js for < 3.11.5; BaseConnection in lib/base/connection.js for >= 3.11.5).

Fixes#20763

🤖 Generated with Claude Code

@mydea
mydea requested review from a team as code ownersJuly 13, 2026 14:42
@mydea
mydea requested review from JPeer264, andreiborza and isaacs and removed request for a teamJuly 13, 2026 14:42
@linear-code

Copy link
Copy Markdown

JS-2414

@mydea
mydea marked this pull request as draft July 13, 2026 14:45
@github-actions

github-actionsBot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

size-limit report 📦

PathSize% ChangeChange
@sentry/browser27.65 kB--
@sentry/browser - with treeshaking flags26.1 kB--
@sentry/browser (incl. Tracing)46.42 kB--
@sentry/browser (incl. Tracing + Span Streaming)48.21 kB--
@sentry/browser (incl. Tracing, Profiling)51.2 kB--
@sentry/browser (incl. Tracing, Replay)85.67 kB--
@sentry/browser (incl. Tracing, Replay) - with treeshaking flags75.31 kB--
@sentry/browser (incl. Tracing, Replay with Canvas)90.38 kB--
@sentry/browser (incl. Tracing, Replay, Feedback)103.04 kB--
@sentry/browser (incl. Feedback)44.83 kB--
@sentry/browser (incl. sendFeedback)32.45 kB--
@sentry/browser (incl. FeedbackAsync)37.58 kB--
@sentry/browser (incl. Metrics)28.74 kB--
@sentry/browser (incl. Logs)28.98 kB--
@sentry/browser (incl. Metrics & Logs)29.67 kB--
@sentry/react29.45 kB--
@sentry/react (incl. Tracing)48.68 kB--
@sentry/vue33.08 kB--
@sentry/vue (incl. Tracing)48.4 kB--
@sentry/svelte27.67 kB--
CDN Bundle30.05 kB--
CDN Bundle (incl. Tracing)48.41 kB--
CDN Bundle (incl. Logs, Metrics)31.64 kB--
CDN Bundle (incl. Tracing, Logs, Metrics)49.71 kB--
CDN Bundle (incl. Replay, Logs, Metrics)70.87 kB--
CDN Bundle (incl. Tracing, Replay)85.9 kB--
CDN Bundle (incl. Tracing, Replay, Logs, Metrics)87.21 kB--
CDN Bundle (incl. Tracing, Replay, Feedback)91.7 kB--
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics)92.97 kB--
CDN Bundle - uncompressed89.58 kB--
CDN Bundle (incl. Tracing) - uncompressed146.33 kB--
CDN Bundle (incl. Logs, Metrics) - uncompressed94.29 kB--
CDN Bundle (incl. Tracing, Logs, Metrics) - uncompressed150.31 kB--
CDN Bundle (incl. Replay, Logs, Metrics) - uncompressed219.02 kB--
CDN Bundle (incl. Tracing, Replay) - uncompressed265.54 kB--
CDN Bundle (incl. Tracing, Replay, Logs, Metrics) - uncompressed269.5 kB--
CDN Bundle (incl. Tracing, Replay, Feedback) - uncompressed279.24 kB--
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics) - uncompressed283.19 kB--
@sentry/nextjs (client)51.22 kB--
@sentry/sveltekit (client)46.86 kB--
@sentry/core/server78.51 kB--
@sentry/core/browser64.86 kB--
@sentry/node-core62.79 kB-0.01%-1 B 🔽
@sentry/node125.19 kB-0.01%-1 B 🔽
@sentry/node (incl. diagnostics channel injection)140.22 kB+0.18%+247 B 🔺
@sentry/node/import (ESM hook with diagnostics-channel injection)69.96 kB--
@sentry/node/light50.8 kB-0.01%-1 B 🔽
@sentry/node - without tracing74.17 kB--
@sentry/aws-serverless83.38 kB-0.01%-4 B 🔽
@sentry/cloudflare (withSentry) - minified181.79 kB--
@sentry/cloudflare (withSentry)449.98 kB--

View base workflow run


const INTEGRATION_NAME = 'Mysql2' as const;
const ORIGIN = 'auto.db.orchestrion.mysql2';
const DB_SYSTEM_VALUE_MYSQL = 'mysql';

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

Note: I decided to drop db.connection_string as we just build this from other attributes, so it is redundant information. we have this in some other places, e.g. mongo, postgres, ioredis, we can either drop those while migrating or also drop it in v11, both are fine IMHO.

...(host ? { [NET_PEER_NAME]: host } : {}),
// oxlint-disable-next-line typescript/no-deprecated
...(portIsNumber ? { [NET_PEER_PORT]: portNumber } : {}),
};

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Missing JDBC connection string attribute

Medium Severity

The orchestrion mysql2 span attributes omit db.connection_string, while the vendored @opentelemetry/instrumentation-mysql2 patcher and the orchestrion mysql integration always emit a JDBC-style connection string. Opt-in orchestrion users lose that attribute on query and execute spans for mysql2 versions below 3.20.0.

Fix in CursorFix in Web

Reviewed by Cursor Bugbot for commit be9e15d. Configure here.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

on purpose

Comment threadpackages/server-utils/src/integrations/tracing-channel/mysql2.ts Outdated
@mydea
mydea marked this pull request as ready for review July 14, 2026 07:52

@cursorcursorBot 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.

There are 2 total unresolved issues (including 1 from previous review).

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 2eb8253. Configure here.

origin: ORIGIN,
data: expect.objectContaining({
'db.system': 'mysql',
'db.statement': 'SELECT 42 AS scalar_value',

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Just a general question (out of scope for this PR): But db.statement/db.query.text should ideally be sanitized. However, this statement includes the actual value 42. Is it possible to sanitize/parametrize this?

Same for description

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

this is actually parametrized when it is parametrized in the code - here the test was wrong/failing, I just fixed this ^^

};
}

const _mysql2ChannelIntegration = (() => {

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This integration probably also needs to be added to Deno: https://github.com/getsentry/sentry-javascript/tree/develop/packages/deno/src/integrations

(if mysql2 is expected to work on Deno)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

And if this needs a Deno wrapper: this should have a guard (usually done with a closure like in redis) so it's not running twice.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

I would keep this in a separate/follow up PR IMHO, we do not need to do this at the same time :)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I wonder if rather than one-off each Deno integration, there's a way to have the Deno SDK automatically slurp these all up. They're all pretty much identical, after all, and exported by server-utils. 🤔

@mydea
mydeaforce-pushed the francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion branch from 2eb8253 to bf47d65CompareJuly 14, 2026 11:27

@JPeer264JPeer264 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM


return {
// oxlint-disable-next-line typescript/no-deprecated
...(database ? { [DB_NAME]: database } : {}),

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

super-l: Following is better to read (same for the ones below:

Suggested change
...(database ? {[DB_NAME]: database} : {}),
[DB_NAME]: database||undefined,

or the following if we don't care about falsy values:

Suggested change
...(database ? {[DB_NAME]: database} : {}),
[DB_NAME]: database,

@isaacsisaacs left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM

// bind values are left as `?` placeholders in `db.statement` (not inlined)
expect.objectContaining({
description: 'SELECT NOW()',
description: 'SELECT ? as a, ? as b, NOW() as c',

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Much more useful test 👍

};
}

const _mysql2ChannelIntegration = (() => {

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I wonder if rather than one-off each Deno integration, there's a way to have the Deno SDK automatically slurp these all up. They're all pretty much identical, after all, and exported by server-utils. 🤔

mydeaand others added 5 commits July 15, 2026 09:08
…o orchestrion
Rewrites the mysql2 instrumentation from an OTel `InstrumentationBase` patcher
to a diagnostics-channel listener with orchestrion injecting the channel into
the instrumented module, mirroring the mysql/kafkajs migrations.
Adds an opt-in `mysql2ChannelIntegration` (registered in `channelIntegrations`,
so `@sentry/node`/`@sentry/bun` swap it in for the OTel `Mysql2` integration
when diagnostics-channel injection is enabled). It subscribes to the injected
`orchestrion:mysql2:query`/`:execute` channels for mysql2 < 3.20.0 and to
mysql2's native tracing channels for >= 3.20.0, so the two ranges never overlap.
The orchestrion config uses `kind: 'Callback'` rather than `'Auto'`: `Auto`'s
no-callback branch probes the return value for `.then`, but mysql2's
callback-less `query(sql)` returns a `Query` whose `.then()` throws, which would
crash streamed queries. `Callback` traces the callback and promise forms (the
common case) and leaves the rarely-used row-streaming form untouched.
Fixes#20763
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mydea
mydeaforce-pushed the francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion branch from bf47d65 to fbe6507CompareJuly 15, 2026 07:08
@mydea
mydea enabled auto-merge (squash) July 15, 2026 07:08
@mydea
mydea merged commit 331026a into developJul 15, 2026
222 checks passed
@mydea
mydea deleted the francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion branch July 15, 2026 07:25
Sign up for freeto 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.

Rewrite @opentelemetry/instrumentation-mysql2 to orchestrion

5 participants

@mydea@isaacs@JPeer264@s1gr1d@andreiborza
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

feat(server-utils): Migrate @opentelemetry/instrumentation-mysql2 to orchestrion - #22229

Merged
mydea merged 5 commits into
developfrom
francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion
Jul 15, 2026
Merged

feat(server-utils): Migrate @opentelemetry/instrumentation-mysql2 to orchestrion#22229
mydea merged 5 commits into
developfrom
francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion

Conversation

@mydea

@mydeamydea commented Jul 13, 2026

Copy link
Copy Markdown
Member

Rewrites the mysql2 instrumentation from an OpenTelemetry InstrumentationBase patcher to a node:diagnostics_channel listener, with orchestrion injecting the channel into the instrumented module ..(#21923) migrations.

  • The orchestrion config covers both mysql2 file layouts (Connection in lib/connection.js for < 3.11.5; BaseConnection in lib/base/connection.js for >= 3.11.5).

Fixes#20763

🤖 Generated with Claude Code

@mydea
mydea requested review from a team as code ownersJuly 13, 2026 14:42
@mydea
mydea requested review from JPeer264, andreiborza and isaacs and removed request for a teamJuly 13, 2026 14:42
@linear-code

Copy link
Copy Markdown

JS-2414

@mydea
mydea marked this pull request as draft July 13, 2026 14:45
@github-actions

github-actionsBot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

size-limit report 📦

PathSize% ChangeChange
@sentry/browser27.65 kB--
@sentry/browser - with treeshaking flags26.1 kB--
@sentry/browser (incl. Tracing)46.42 kB--
@sentry/browser (incl. Tracing + Span Streaming)48.21 kB--
@sentry/browser (incl. Tracing, Profiling)51.2 kB--
@sentry/browser (incl. Tracing, Replay)85.67 kB--
@sentry/browser (incl. Tracing, Replay) - with treeshaking flags75.31 kB--
@sentry/browser (incl. Tracing, Replay with Canvas)90.38 kB--
@sentry/browser (incl. Tracing, Replay, Feedback)103.04 kB--
@sentry/browser (incl. Feedback)44.83 kB--
@sentry/browser (incl. sendFeedback)32.45 kB--
@sentry/browser (incl. FeedbackAsync)37.58 kB--
@sentry/browser (incl. Metrics)28.74 kB--
@sentry/browser (incl. Logs)28.98 kB--
@sentry/browser (incl. Metrics & Logs)29.67 kB--
@sentry/react29.45 kB--
@sentry/react (incl. Tracing)48.68 kB--
@sentry/vue33.08 kB--
@sentry/vue (incl. Tracing)48.4 kB--
@sentry/svelte27.67 kB--
CDN Bundle30.05 kB--
CDN Bundle (incl. Tracing)48.41 kB--
CDN Bundle (incl. Logs, Metrics)31.64 kB--
CDN Bundle (incl. Tracing, Logs, Metrics)49.71 kB--
CDN Bundle (incl. Replay, Logs, Metrics)70.87 kB--
CDN Bundle (incl. Tracing, Replay)85.9 kB--
CDN Bundle (incl. Tracing, Replay, Logs, Metrics)87.21 kB--
CDN Bundle (incl. Tracing, Replay, Feedback)91.7 kB--
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics)92.97 kB--
CDN Bundle - uncompressed89.58 kB--
CDN Bundle (incl. Tracing) - uncompressed146.33 kB--
CDN Bundle (incl. Logs, Metrics) - uncompressed94.29 kB--
CDN Bundle (incl. Tracing, Logs, Metrics) - uncompressed150.31 kB--
CDN Bundle (incl. Replay, Logs, Metrics) - uncompressed219.02 kB--
CDN Bundle (incl. Tracing, Replay) - uncompressed265.54 kB--
CDN Bundle (incl. Tracing, Replay, Logs, Metrics) - uncompressed269.5 kB--
CDN Bundle (incl. Tracing, Replay, Feedback) - uncompressed279.24 kB--
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics) - uncompressed283.19 kB--
@sentry/nextjs (client)51.22 kB--
@sentry/sveltekit (client)46.86 kB--
@sentry/core/server78.51 kB--
@sentry/core/browser64.86 kB--
@sentry/node-core62.79 kB-0.01%-1 B 🔽
@sentry/node125.19 kB-0.01%-1 B 🔽
@sentry/node (incl. diagnostics channel injection)140.22 kB+0.18%+247 B 🔺
@sentry/node/import (ESM hook with diagnostics-channel injection)69.96 kB--
@sentry/node/light50.8 kB-0.01%-1 B 🔽
@sentry/node - without tracing74.17 kB--
@sentry/aws-serverless83.38 kB-0.01%-4 B 🔽
@sentry/cloudflare (withSentry) - minified181.79 kB--
@sentry/cloudflare (withSentry)449.98 kB--

View base workflow run


const INTEGRATION_NAME = 'Mysql2' as const;
const ORIGIN = 'auto.db.orchestrion.mysql2';
const DB_SYSTEM_VALUE_MYSQL = 'mysql';

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

Note: I decided to drop db.connection_string as we just build this from other attributes, so it is redundant information. we have this in some other places, e.g. mongo, postgres, ioredis, we can either drop those while migrating or also drop it in v11, both are fine IMHO.

...(host ? { [NET_PEER_NAME]: host } : {}),
// oxlint-disable-next-line typescript/no-deprecated
...(portIsNumber ? { [NET_PEER_PORT]: portNumber } : {}),
};

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Missing JDBC connection string attribute

Medium Severity

The orchestrion mysql2 span attributes omit db.connection_string, while the vendored @opentelemetry/instrumentation-mysql2 patcher and the orchestrion mysql integration always emit a JDBC-style connection string. Opt-in orchestrion users lose that attribute on query and execute spans for mysql2 versions below 3.20.0.

Fix in CursorFix in Web

Reviewed by Cursor Bugbot for commit be9e15d. Configure here.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

on purpose

Comment threadpackages/server-utils/src/integrations/tracing-channel/mysql2.ts Outdated
@mydea
mydea marked this pull request as ready for review July 14, 2026 07:52

@cursorcursorBot 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.

There are 2 total unresolved issues (including 1 from previous review).

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 2eb8253. Configure here.

origin: ORIGIN,
data: expect.objectContaining({
'db.system': 'mysql',
'db.statement': 'SELECT 42 AS scalar_value',

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Just a general question (out of scope for this PR): But db.statement/db.query.text should ideally be sanitized. However, this statement includes the actual value 42. Is it possible to sanitize/parametrize this?

Same for description

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

this is actually parametrized when it is parametrized in the code - here the test was wrong/failing, I just fixed this ^^

};
}

const _mysql2ChannelIntegration = (() => {

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This integration probably also needs to be added to Deno: https://github.com/getsentry/sentry-javascript/tree/develop/packages/deno/src/integrations

(if mysql2 is expected to work on Deno)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

And if this needs a Deno wrapper: this should have a guard (usually done with a closure like in redis) so it's not running twice.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

I would keep this in a separate/follow up PR IMHO, we do not need to do this at the same time :)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I wonder if rather than one-off each Deno integration, there's a way to have the Deno SDK automatically slurp these all up. They're all pretty much identical, after all, and exported by server-utils. 🤔

@mydea
mydeaforce-pushed the francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion branch from 2eb8253 to bf47d65CompareJuly 14, 2026 11:27

@JPeer264JPeer264 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM


return {
// oxlint-disable-next-line typescript/no-deprecated
...(database ? { [DB_NAME]: database } : {}),

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

super-l: Following is better to read (same for the ones below:

Suggested change
...(database ? {[DB_NAME]: database} : {}),
[DB_NAME]: database||undefined,

or the following if we don't care about falsy values:

Suggested change
...(database ? {[DB_NAME]: database} : {}),
[DB_NAME]: database,

@isaacsisaacs left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM

// bind values are left as `?` placeholders in `db.statement` (not inlined)
expect.objectContaining({
description: 'SELECT NOW()',
description: 'SELECT ? as a, ? as b, NOW() as c',

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Much more useful test 👍

};
}

const _mysql2ChannelIntegration = (() => {

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I wonder if rather than one-off each Deno integration, there's a way to have the Deno SDK automatically slurp these all up. They're all pretty much identical, after all, and exported by server-utils. 🤔

mydeaand others added 5 commits July 15, 2026 09:08
…o orchestrion
Rewrites the mysql2 instrumentation from an OTel `InstrumentationBase` patcher
to a diagnostics-channel listener with orchestrion injecting the channel into
the instrumented module, mirroring the mysql/kafkajs migrations.
Adds an opt-in `mysql2ChannelIntegration` (registered in `channelIntegrations`,
so `@sentry/node`/`@sentry/bun` swap it in for the OTel `Mysql2` integration
when diagnostics-channel injection is enabled). It subscribes to the injected
`orchestrion:mysql2:query`/`:execute` channels for mysql2 < 3.20.0 and to
mysql2's native tracing channels for >= 3.20.0, so the two ranges never overlap.
The orchestrion config uses `kind: 'Callback'` rather than `'Auto'`: `Auto`'s
no-callback branch probes the return value for `.then`, but mysql2's
callback-less `query(sql)` returns a `Query` whose `.then()` throws, which would
crash streamed queries. `Callback` traces the callback and promise forms (the
common case) and leaves the rarely-used row-streaming form untouched.
Fixes#20763
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mydea
mydeaforce-pushed the francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion branch from bf47d65 to fbe6507CompareJuly 15, 2026 07:08
@mydea
mydea enabled auto-merge (squash) July 15, 2026 07:08
@mydea
mydea merged commit 331026a into developJul 15, 2026
222 checks passed
@mydea
mydea deleted the francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion branch July 15, 2026 07:25
Sign up for freeto 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.

Rewrite @opentelemetry/instrumentation-mysql2 to orchestrion

5 participants

@mydea@isaacs@JPeer264@s1gr1d@andreiborza
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

feat(server-utils): Migrate @opentelemetry/instrumentation-mysql2 to orchestrion - #22229

Merged
mydea merged 5 commits into
developfrom
francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion
Jul 15, 2026
Merged

feat(server-utils): Migrate @opentelemetry/instrumentation-mysql2 to orchestrion#22229
mydea merged 5 commits into
developfrom
francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion

Conversation

@mydea

@mydeamydea commented Jul 13, 2026

Copy link
Copy Markdown
Member

Rewrites the mysql2 instrumentation from an OpenTelemetry InstrumentationBase patcher to a node:diagnostics_channel listener, with orchestrion injecting the channel into the instrumented module ..(#21923) migrations.

  • The orchestrion config covers both mysql2 file layouts (Connection in lib/connection.js for < 3.11.5; BaseConnection in lib/base/connection.js for >= 3.11.5).

Fixes#20763

🤖 Generated with Claude Code

@mydea
mydea requested review from a team as code ownersJuly 13, 2026 14:42
@mydea
mydea requested review from JPeer264, andreiborza and isaacs and removed request for a teamJuly 13, 2026 14:42
@linear-code

Copy link
Copy Markdown

JS-2414

@mydea
mydea marked this pull request as draft July 13, 2026 14:45
@github-actions

github-actionsBot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

size-limit report 📦

PathSize% ChangeChange
@sentry/browser27.65 kB--
@sentry/browser - with treeshaking flags26.1 kB--
@sentry/browser (incl. Tracing)46.42 kB--
@sentry/browser (incl. Tracing + Span Streaming)48.21 kB--
@sentry/browser (incl. Tracing, Profiling)51.2 kB--
@sentry/browser (incl. Tracing, Replay)85.67 kB--
@sentry/browser (incl. Tracing, Replay) - with treeshaking flags75.31 kB--
@sentry/browser (incl. Tracing, Replay with Canvas)90.38 kB--
@sentry/browser (incl. Tracing, Replay, Feedback)103.04 kB--
@sentry/browser (incl. Feedback)44.83 kB--
@sentry/browser (incl. sendFeedback)32.45 kB--
@sentry/browser (incl. FeedbackAsync)37.58 kB--
@sentry/browser (incl. Metrics)28.74 kB--
@sentry/browser (incl. Logs)28.98 kB--
@sentry/browser (incl. Metrics & Logs)29.67 kB--
@sentry/react29.45 kB--
@sentry/react (incl. Tracing)48.68 kB--
@sentry/vue33.08 kB--
@sentry/vue (incl. Tracing)48.4 kB--
@sentry/svelte27.67 kB--
CDN Bundle30.05 kB--
CDN Bundle (incl. Tracing)48.41 kB--
CDN Bundle (incl. Logs, Metrics)31.64 kB--
CDN Bundle (incl. Tracing, Logs, Metrics)49.71 kB--
CDN Bundle (incl. Replay, Logs, Metrics)70.87 kB--
CDN Bundle (incl. Tracing, Replay)85.9 kB--
CDN Bundle (incl. Tracing, Replay, Logs, Metrics)87.21 kB--
CDN Bundle (incl. Tracing, Replay, Feedback)91.7 kB--
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics)92.97 kB--
CDN Bundle - uncompressed89.58 kB--
CDN Bundle (incl. Tracing) - uncompressed146.33 kB--
CDN Bundle (incl. Logs, Metrics) - uncompressed94.29 kB--
CDN Bundle (incl. Tracing, Logs, Metrics) - uncompressed150.31 kB--
CDN Bundle (incl. Replay, Logs, Metrics) - uncompressed219.02 kB--
CDN Bundle (incl. Tracing, Replay) - uncompressed265.54 kB--
CDN Bundle (incl. Tracing, Replay, Logs, Metrics) - uncompressed269.5 kB--
CDN Bundle (incl. Tracing, Replay, Feedback) - uncompressed279.24 kB--
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics) - uncompressed283.19 kB--
@sentry/nextjs (client)51.22 kB--
@sentry/sveltekit (client)46.86 kB--
@sentry/core/server78.51 kB--
@sentry/core/browser64.86 kB--
@sentry/node-core62.79 kB-0.01%-1 B 🔽
@sentry/node125.19 kB-0.01%-1 B 🔽
@sentry/node (incl. diagnostics channel injection)140.22 kB+0.18%+247 B 🔺
@sentry/node/import (ESM hook with diagnostics-channel injection)69.96 kB--
@sentry/node/light50.8 kB-0.01%-1 B 🔽
@sentry/node - without tracing74.17 kB--
@sentry/aws-serverless83.38 kB-0.01%-4 B 🔽
@sentry/cloudflare (withSentry) - minified181.79 kB--
@sentry/cloudflare (withSentry)449.98 kB--

View base workflow run


const INTEGRATION_NAME = 'Mysql2' as const;
const ORIGIN = 'auto.db.orchestrion.mysql2';
const DB_SYSTEM_VALUE_MYSQL = 'mysql';

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

Note: I decided to drop db.connection_string as we just build this from other attributes, so it is redundant information. we have this in some other places, e.g. mongo, postgres, ioredis, we can either drop those while migrating or also drop it in v11, both are fine IMHO.

...(host ? { [NET_PEER_NAME]: host } : {}),
// oxlint-disable-next-line typescript/no-deprecated
...(portIsNumber ? { [NET_PEER_PORT]: portNumber } : {}),
};

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Missing JDBC connection string attribute

Medium Severity

The orchestrion mysql2 span attributes omit db.connection_string, while the vendored @opentelemetry/instrumentation-mysql2 patcher and the orchestrion mysql integration always emit a JDBC-style connection string. Opt-in orchestrion users lose that attribute on query and execute spans for mysql2 versions below 3.20.0.

Fix in CursorFix in Web

Reviewed by Cursor Bugbot for commit be9e15d. Configure here.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

on purpose

Comment threadpackages/server-utils/src/integrations/tracing-channel/mysql2.ts Outdated
@mydea
mydea marked this pull request as ready for review July 14, 2026 07:52

@cursorcursorBot 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.

There are 2 total unresolved issues (including 1 from previous review).

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 2eb8253. Configure here.

origin: ORIGIN,
data: expect.objectContaining({
'db.system': 'mysql',
'db.statement': 'SELECT 42 AS scalar_value',

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Just a general question (out of scope for this PR): But db.statement/db.query.text should ideally be sanitized. However, this statement includes the actual value 42. Is it possible to sanitize/parametrize this?

Same for description

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

this is actually parametrized when it is parametrized in the code - here the test was wrong/failing, I just fixed this ^^

};
}

const _mysql2ChannelIntegration = (() => {

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This integration probably also needs to be added to Deno: https://github.com/getsentry/sentry-javascript/tree/develop/packages/deno/src/integrations

(if mysql2 is expected to work on Deno)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

And if this needs a Deno wrapper: this should have a guard (usually done with a closure like in redis) so it's not running twice.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

I would keep this in a separate/follow up PR IMHO, we do not need to do this at the same time :)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I wonder if rather than one-off each Deno integration, there's a way to have the Deno SDK automatically slurp these all up. They're all pretty much identical, after all, and exported by server-utils. 🤔

@mydea
mydeaforce-pushed the francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion branch from 2eb8253 to bf47d65CompareJuly 14, 2026 11:27

@JPeer264JPeer264 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM


return {
// oxlint-disable-next-line typescript/no-deprecated
...(database ? { [DB_NAME]: database } : {}),

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

super-l: Following is better to read (same for the ones below:

Suggested change
...(database ? {[DB_NAME]: database} : {}),
[DB_NAME]: database||undefined,

or the following if we don't care about falsy values:

Suggested change
...(database ? {[DB_NAME]: database} : {}),
[DB_NAME]: database,

@isaacsisaacs left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM

// bind values are left as `?` placeholders in `db.statement` (not inlined)
expect.objectContaining({
description: 'SELECT NOW()',
description: 'SELECT ? as a, ? as b, NOW() as c',

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Much more useful test 👍

};
}

const _mysql2ChannelIntegration = (() => {

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I wonder if rather than one-off each Deno integration, there's a way to have the Deno SDK automatically slurp these all up. They're all pretty much identical, after all, and exported by server-utils. 🤔

mydeaand others added 5 commits July 15, 2026 09:08
…o orchestrion
Rewrites the mysql2 instrumentation from an OTel `InstrumentationBase` patcher
to a diagnostics-channel listener with orchestrion injecting the channel into
the instrumented module, mirroring the mysql/kafkajs migrations.
Adds an opt-in `mysql2ChannelIntegration` (registered in `channelIntegrations`,
so `@sentry/node`/`@sentry/bun` swap it in for the OTel `Mysql2` integration
when diagnostics-channel injection is enabled). It subscribes to the injected
`orchestrion:mysql2:query`/`:execute` channels for mysql2 < 3.20.0 and to
mysql2's native tracing channels for >= 3.20.0, so the two ranges never overlap.
The orchestrion config uses `kind: 'Callback'` rather than `'Auto'`: `Auto`'s
no-callback branch probes the return value for `.then`, but mysql2's
callback-less `query(sql)` returns a `Query` whose `.then()` throws, which would
crash streamed queries. `Callback` traces the callback and promise forms (the
common case) and leaves the rarely-used row-streaming form untouched.
Fixes#20763
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mydea
mydeaforce-pushed the francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion branch from bf47d65 to fbe6507CompareJuly 15, 2026 07:08
@mydea
mydea enabled auto-merge (squash) July 15, 2026 07:08
@mydea
mydea merged commit 331026a into developJul 15, 2026
222 checks passed
@mydea
mydea deleted the francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion branch July 15, 2026 07:25
Sign up for freeto 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.

Rewrite @opentelemetry/instrumentation-mysql2 to orchestrion

5 participants

@mydea@isaacs@JPeer264@s1gr1d@andreiborza
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

feat(server-utils): Migrate @opentelemetry/instrumentation-mysql2 to orchestrion - #22229

Merged
mydea merged 5 commits into
developfrom
francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion
Jul 15, 2026
Merged

feat(server-utils): Migrate @opentelemetry/instrumentation-mysql2 to orchestrion#22229
mydea merged 5 commits into
developfrom
francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion

Conversation

@mydea

@mydeamydea commented Jul 13, 2026

Copy link
Copy Markdown
Member

Rewrites the mysql2 instrumentation from an OpenTelemetry InstrumentationBase patcher to a node:diagnostics_channel listener, with orchestrion injecting the channel into the instrumented module ..(#21923) migrations.

  • The orchestrion config covers both mysql2 file layouts (Connection in lib/connection.js for < 3.11.5; BaseConnection in lib/base/connection.js for >= 3.11.5).

Fixes#20763

🤖 Generated with Claude Code

@mydea
mydea requested review from a team as code ownersJuly 13, 2026 14:42
@mydea
mydea requested review from JPeer264, andreiborza and isaacs and removed request for a teamJuly 13, 2026 14:42
@linear-code

Copy link
Copy Markdown

JS-2414

@mydea
mydea marked this pull request as draft July 13, 2026 14:45
@github-actions

github-actionsBot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

size-limit report 📦

PathSize% ChangeChange
@sentry/browser27.65 kB--
@sentry/browser - with treeshaking flags26.1 kB--
@sentry/browser (incl. Tracing)46.42 kB--
@sentry/browser (incl. Tracing + Span Streaming)48.21 kB--
@sentry/browser (incl. Tracing, Profiling)51.2 kB--
@sentry/browser (incl. Tracing, Replay)85.67 kB--
@sentry/browser (incl. Tracing, Replay) - with treeshaking flags75.31 kB--
@sentry/browser (incl. Tracing, Replay with Canvas)90.38 kB--
@sentry/browser (incl. Tracing, Replay, Feedback)103.04 kB--
@sentry/browser (incl. Feedback)44.83 kB--
@sentry/browser (incl. sendFeedback)32.45 kB--
@sentry/browser (incl. FeedbackAsync)37.58 kB--
@sentry/browser (incl. Metrics)28.74 kB--
@sentry/browser (incl. Logs)28.98 kB--
@sentry/browser (incl. Metrics & Logs)29.67 kB--
@sentry/react29.45 kB--
@sentry/react (incl. Tracing)48.68 kB--
@sentry/vue33.08 kB--
@sentry/vue (incl. Tracing)48.4 kB--
@sentry/svelte27.67 kB--
CDN Bundle30.05 kB--
CDN Bundle (incl. Tracing)48.41 kB--
CDN Bundle (incl. Logs, Metrics)31.64 kB--
CDN Bundle (incl. Tracing, Logs, Metrics)49.71 kB--
CDN Bundle (incl. Replay, Logs, Metrics)70.87 kB--
CDN Bundle (incl. Tracing, Replay)85.9 kB--
CDN Bundle (incl. Tracing, Replay, Logs, Metrics)87.21 kB--
CDN Bundle (incl. Tracing, Replay, Feedback)91.7 kB--
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics)92.97 kB--
CDN Bundle - uncompressed89.58 kB--
CDN Bundle (incl. Tracing) - uncompressed146.33 kB--
CDN Bundle (incl. Logs, Metrics) - uncompressed94.29 kB--
CDN Bundle (incl. Tracing, Logs, Metrics) - uncompressed150.31 kB--
CDN Bundle (incl. Replay, Logs, Metrics) - uncompressed219.02 kB--
CDN Bundle (incl. Tracing, Replay) - uncompressed265.54 kB--
CDN Bundle (incl. Tracing, Replay, Logs, Metrics) - uncompressed269.5 kB--
CDN Bundle (incl. Tracing, Replay, Feedback) - uncompressed279.24 kB--
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics) - uncompressed283.19 kB--
@sentry/nextjs (client)51.22 kB--
@sentry/sveltekit (client)46.86 kB--
@sentry/core/server78.51 kB--
@sentry/core/browser64.86 kB--
@sentry/node-core62.79 kB-0.01%-1 B 🔽
@sentry/node125.19 kB-0.01%-1 B 🔽
@sentry/node (incl. diagnostics channel injection)140.22 kB+0.18%+247 B 🔺
@sentry/node/import (ESM hook with diagnostics-channel injection)69.96 kB--
@sentry/node/light50.8 kB-0.01%-1 B 🔽
@sentry/node - without tracing74.17 kB--
@sentry/aws-serverless83.38 kB-0.01%-4 B 🔽
@sentry/cloudflare (withSentry) - minified181.79 kB--
@sentry/cloudflare (withSentry)449.98 kB--

View base workflow run


const INTEGRATION_NAME = 'Mysql2' as const;
const ORIGIN = 'auto.db.orchestrion.mysql2';
const DB_SYSTEM_VALUE_MYSQL = 'mysql';

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

Note: I decided to drop db.connection_string as we just build this from other attributes, so it is redundant information. we have this in some other places, e.g. mongo, postgres, ioredis, we can either drop those while migrating or also drop it in v11, both are fine IMHO.

...(host ? { [NET_PEER_NAME]: host } : {}),
// oxlint-disable-next-line typescript/no-deprecated
...(portIsNumber ? { [NET_PEER_PORT]: portNumber } : {}),
};

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Missing JDBC connection string attribute

Medium Severity

The orchestrion mysql2 span attributes omit db.connection_string, while the vendored @opentelemetry/instrumentation-mysql2 patcher and the orchestrion mysql integration always emit a JDBC-style connection string. Opt-in orchestrion users lose that attribute on query and execute spans for mysql2 versions below 3.20.0.

Fix in CursorFix in Web

Reviewed by Cursor Bugbot for commit be9e15d. Configure here.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

on purpose

Comment threadpackages/server-utils/src/integrations/tracing-channel/mysql2.ts Outdated
@mydea
mydea marked this pull request as ready for review July 14, 2026 07:52

@cursorcursorBot 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.

There are 2 total unresolved issues (including 1 from previous review).

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 2eb8253. Configure here.

origin: ORIGIN,
data: expect.objectContaining({
'db.system': 'mysql',
'db.statement': 'SELECT 42 AS scalar_value',

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Just a general question (out of scope for this PR): But db.statement/db.query.text should ideally be sanitized. However, this statement includes the actual value 42. Is it possible to sanitize/parametrize this?

Same for description

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

this is actually parametrized when it is parametrized in the code - here the test was wrong/failing, I just fixed this ^^

};
}

const _mysql2ChannelIntegration = (() => {

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This integration probably also needs to be added to Deno: https://github.com/getsentry/sentry-javascript/tree/develop/packages/deno/src/integrations

(if mysql2 is expected to work on Deno)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

And if this needs a Deno wrapper: this should have a guard (usually done with a closure like in redis) so it's not running twice.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

I would keep this in a separate/follow up PR IMHO, we do not need to do this at the same time :)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I wonder if rather than one-off each Deno integration, there's a way to have the Deno SDK automatically slurp these all up. They're all pretty much identical, after all, and exported by server-utils. 🤔

@mydea
mydeaforce-pushed the francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion branch from 2eb8253 to bf47d65CompareJuly 14, 2026 11:27

@JPeer264JPeer264 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM


return {
// oxlint-disable-next-line typescript/no-deprecated
...(database ? { [DB_NAME]: database } : {}),

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

super-l: Following is better to read (same for the ones below:

Suggested change
...(database ? {[DB_NAME]: database} : {}),
[DB_NAME]: database||undefined,

or the following if we don't care about falsy values:

Suggested change
...(database ? {[DB_NAME]: database} : {}),
[DB_NAME]: database,

@isaacsisaacs left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM

// bind values are left as `?` placeholders in `db.statement` (not inlined)
expect.objectContaining({
description: 'SELECT NOW()',
description: 'SELECT ? as a, ? as b, NOW() as c',

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Much more useful test 👍

};
}

const _mysql2ChannelIntegration = (() => {

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I wonder if rather than one-off each Deno integration, there's a way to have the Deno SDK automatically slurp these all up. They're all pretty much identical, after all, and exported by server-utils. 🤔

mydeaand others added 5 commits July 15, 2026 09:08
…o orchestrion
Rewrites the mysql2 instrumentation from an OTel `InstrumentationBase` patcher
to a diagnostics-channel listener with orchestrion injecting the channel into
the instrumented module, mirroring the mysql/kafkajs migrations.
Adds an opt-in `mysql2ChannelIntegration` (registered in `channelIntegrations`,
so `@sentry/node`/`@sentry/bun` swap it in for the OTel `Mysql2` integration
when diagnostics-channel injection is enabled). It subscribes to the injected
`orchestrion:mysql2:query`/`:execute` channels for mysql2 < 3.20.0 and to
mysql2's native tracing channels for >= 3.20.0, so the two ranges never overlap.
The orchestrion config uses `kind: 'Callback'` rather than `'Auto'`: `Auto`'s
no-callback branch probes the return value for `.then`, but mysql2's
callback-less `query(sql)` returns a `Query` whose `.then()` throws, which would
crash streamed queries. `Callback` traces the callback and promise forms (the
common case) and leaves the rarely-used row-streaming form untouched.
Fixes#20763
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mydea
mydeaforce-pushed the francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion branch from bf47d65 to fbe6507CompareJuly 15, 2026 07:08
@mydea
mydea enabled auto-merge (squash) July 15, 2026 07:08
@mydea
mydea merged commit 331026a into developJul 15, 2026
222 checks passed
@mydea
mydea deleted the francesconovy/js-2414-rewrite-opentelemetryinstrumentation-mysql2-to-orchestrion branch July 15, 2026 07:25
Sign up for freeto 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.

Rewrite @opentelemetry/instrumentation-mysql2 to orchestrion

5 participants

@mydea@isaacs@JPeer264@s1gr1d@andreiborza