Skip to content

ref(node): Streamline pg instrumentation#21583

Open
logaretm wants to merge 7 commits into
developfrom
awad/js-2392-streamline-opentelemetryinstrumentation-pg
Open

ref(node): Streamline pg instrumentation#21583
logaretm wants to merge 7 commits into
developfrom
awad/js-2392-streamline-opentelemetryinstrumentation-pg

Conversation

@logaretm

@logaretm logaretm commented Jun 16, 2026

Copy link
Copy Markdown
Member

Streamlines the vendored pg (node-postgres) instrumentation onto Sentry's span APIs.

I found that some spans (pg.connect, pg-pool.connect) still use manual origin, this was the case prior so I kept them as-is but I think they should be changed in the future.

I added a bunch of real tests for various scenarios we were lacking.

@linear-code

linear-code Bot commented Jun 16, 2026

Copy link
Copy Markdown

JS-2392

@logaretm logaretm force-pushed the awad/js-2392-streamline-opentelemetryinstrumentation-pg branch from 207f6ec to 72548f7 Compare June 16, 2026 19:39
@logaretm logaretm changed the base branch from awad/js-2393-streamline-opentelemetryinstrumentation-redis to develop June 16, 2026 19:39
@github-actions

github-actions Bot commented Jun 16, 2026

Copy link
Copy Markdown
Contributor

size-limit report 📦

Path Size % Change Change
@sentry/browser 27.45 kB - -
@sentry/browser - with treeshaking flags 25.88 kB - -
@sentry/browser (incl. Tracing) 45.88 kB - -
@sentry/browser (incl. Tracing + Span Streaming) 48.11 kB - -
@sentry/browser (incl. Tracing, Profiling) 50.65 kB - -
@sentry/browser (incl. Tracing, Replay) 85.08 kB - -
@sentry/browser (incl. Tracing, Replay) - with treeshaking flags 74.68 kB - -
@sentry/browser (incl. Tracing, Replay with Canvas) 89.78 kB - -
@sentry/browser (incl. Tracing, Replay, Feedback) 102.44 kB - -
@sentry/browser (incl. Feedback) 44.62 kB - -
@sentry/browser (incl. sendFeedback) 32.25 kB - -
@sentry/browser (incl. FeedbackAsync) 37.38 kB - -
@sentry/browser (incl. Metrics) 28.52 kB - -
@sentry/browser (incl. Logs) 28.76 kB - -
@sentry/browser (incl. Metrics & Logs) 29.45 kB - -
@sentry/react 29.25 kB - -
@sentry/react (incl. Tracing) 48.17 kB - -
@sentry/vue 32.56 kB - -
@sentry/vue (incl. Tracing) 47.74 kB - -
@sentry/svelte 27.48 kB - -
CDN Bundle 29.86 kB - -
CDN Bundle (incl. Tracing) 48.28 kB - -
CDN Bundle (incl. Logs, Metrics) 31.4 kB - -
CDN Bundle (incl. Tracing, Logs, Metrics) 49.58 kB - -
CDN Bundle (incl. Replay, Logs, Metrics) 70.71 kB - -
CDN Bundle (incl. Tracing, Replay) 85.61 kB - -
CDN Bundle (incl. Tracing, Replay, Logs, Metrics) 86.88 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback) 91.46 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics) 92.71 kB - -
CDN Bundle - uncompressed 88.8 kB - -
CDN Bundle (incl. Tracing) - uncompressed 146.04 kB - -
CDN Bundle (incl. Logs, Metrics) - uncompressed 93.5 kB - -
CDN Bundle (incl. Tracing, Logs, Metrics) - uncompressed 150.02 kB - -
CDN Bundle (incl. Replay, Logs, Metrics) - uncompressed 218.33 kB - -
CDN Bundle (incl. Tracing, Replay) - uncompressed 264.91 kB - -
CDN Bundle (incl. Tracing, Replay, Logs, Metrics) - uncompressed 268.87 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback) - uncompressed 278.61 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics) - uncompressed 282.56 kB - -
@sentry/nextjs (client) 50.58 kB - -
@sentry/sveltekit (client) 46.27 kB - -
@sentry/core/server 76.16 kB - -
@sentry/core/browser 63.31 kB - -
@sentry/node-core 61.87 kB -0.01% -1 B 🔽
@sentry/node 125.6 kB -1.64% -2.08 kB 🔽
@sentry/node - without tracing 74.26 kB - -
@sentry/aws-serverless 85.35 kB - -
@sentry/cloudflare (withSentry) - minified 174.48 kB - -
@sentry/cloudflare (withSentry) 436.52 kB - -

View base workflow run

@logaretm logaretm force-pushed the awad/js-2392-streamline-opentelemetryinstrumentation-pg branch 2 times, most recently from 56a88b9 to 936f0c8 Compare June 16, 2026 20:29
@logaretm logaretm marked this pull request as ready for review June 16, 2026 20:29
@logaretm logaretm requested a review from a team as a code owner June 16, 2026 20:29
@logaretm logaretm requested review from JPeer264 and mydea and removed request for a team June 16, 2026 20:29
Comment thread packages/node/src/integrations/tracing/postgres/vendored/utils.ts
Comment thread packages/node/src/integrations/tracing/postgres/vendored/utils.ts

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Cursor Bugbot has reviewed your changes and found 2 potential issues.

There are 3 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 321e80d. Configure here.

Comment thread packages/node/src/integrations/tracing/postgres/vendored/utils.ts
Comment thread packages/node/src/integrations/tracing/postgres/vendored/utils.ts
Comment thread packages/node/src/integrations/tracing/postgres/vendored/instrumentation.ts Outdated
const poolName = utils.getPoolName(pgPool.options);

pgPool.on('connect', () => {
this._connectionsCounter = utils.updateCounter(

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.

note: Actually sad that we never took advantage of these metrics.

@logaretm logaretm Jun 18, 2026

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

I think our "app metrics" need to be incorporated into these integrations somehow, maybe via a toggle on option on the integration.

Redis have a lot of useful metrics that they emit natively for OTEL, we can emit similar metrics using the same diag channels.

Comment thread packages/node/src/integrations/tracing/postgres/vendored/instrumentation.ts Outdated
Comment thread .oxlintrc.base.json Outdated
@logaretm logaretm force-pushed the awad/js-2392-streamline-opentelemetryinstrumentation-pg branch 2 times, most recently from a3ac2d3 to c78d8b3 Compare June 18, 2026 14:12
logaretm and others added 7 commits June 18, 2026 11:20
Streamlines the vendored `pg` (node-postgres) instrumentation to use
Sentry's span APIs instead of the OpenTelemetry tracing APIs, following
the redis/ioredis precedent.

- Replace `tracer.startSpan` + `context.with(trace.setSpan(...))` with
  `startInactiveSpan`/`withActiveSpan`, `SpanStatusCode.ERROR` with
  `SPAN_STATUS_ERROR`, and drop `recordException` (a no-op in Sentry's
  pipeline) across the client query, client connect and pool connect paths.
- Drop the OTel metrics (operation duration + pool connection counters):
  the SDK wires up no `MeterProvider`, so `this.meter` is the no-op meter
  and every `record`/`add` was dead. Also removes the pool event-listener
  plumbing and the `db.client.connection.*` semconv.
- Drop the `SemconvStability` dual-emission and keep the OLD semconv
  attributes only (the STABLE path was env-gated behind
  `OTEL_SEMCONV_STABILITY_OPT_IN` and never enabled by the SDK).
- Remove config the SDK never passes (`requestHook`, `responseHook`,
  `enhancedDatabaseReporting`, `addSqlCommenterCommentToQueries`) and
  hardcode the always-on `requireParentSpan` behaviour; bake the
  `auto.db.otel.postgres` origin into the query span attributes (connect
  spans keep their `manual` origin, matching prior output).
- Drop the blanket eslint-disable and rely on the consolidated path entry.

Removes the config-passing `Postgres` unit test (its only pg-specific
behaviour, `ignoreConnectSpans` forwarding, is covered end-to-end) and
expands the real integration suite to cover every code path, matching the
redis/mysql2 precedent:

- error paths: a failing query and a refused connect assert
  `status: 'internal_error'`;
- `Pool`: a new scenario covers `pg-pool.connect` spans, callback-style
  queries, and connection-string credential masking on `db.connection_string`;
- prepared statements: a named query asserts the `db.postgresql.plan` attribute;
- `requireParentSpan`: a new scenario asserts queries/connects without an
  active parent span are not instrumented.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Replace trace.getSpan(context.active()) with getActiveSpan() for the
requireParentSpan check and parent detection, and translate the
context.bind callback binding to a withActiveSpan-based helper. The
connect-result promise no longer needs explicit binding since the SDK's
async context propagates across the caller's await.
Add a scenario that chains a query off connect() with .then() instead of
awaiting it, asserting the query span is still parented to the active
transaction. This pins that the trace context survives the connect
promise continuation after dropping the explicit OTel context.bind.
Vendored OTel instrumentations intentionally emit the old db.*/net.*
semantic conventions, whose local semconv constants carry the upstream
@deprecated JSDoc. The type-aware no-deprecated rule flagged every usage
as an error and failed lint. Downgrade it to a warning for the vendored
tracing paths so the intentional usage is surfaced without breaking CI.
@logaretm logaretm force-pushed the awad/js-2392-streamline-opentelemetryinstrumentation-pg branch from c78d8b3 to 54b6140 Compare June 18, 2026 15:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants