Skip to content

Document OTel service-level DBM correlation - #38533

Open
pierreln-dd wants to merge 5 commits into
masterfrom
pierreln-dd/document-otel-dbm-correlation-gaps
Open

Document OTel service-level DBM correlation#38533
pierreln-dd wants to merge 5 commits into
masterfrom
pierreln-dd/document-otel-dbm-correlation-gaps

Conversation

@pierreln-dd

@pierreln-dd pierreln-dd commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

What does this PR do? What is the motivation?

Adds documentation for OpenTelemetry service-level vs. statement-level APM<>DBM correlation, which wasn't previously covered in public docs.

Clarifies that statement-level correlation works automatically for OTel setups, but service-level correlation (Calling Services, Databases tab) requires a SQL comment with service metadata that OTel auto-instrumentation doesn't add by default. Documents the comment format needed to enable it manually, and notes that stored procedure calls aren't supported for correlation.

Merge instructions

Merge readiness:

  • Ready for merge

Additional notes

pierreln-dd and others added 4 commits July 28, 2026 15:41
Add a Correlation levels section to the OTel + DBM guide distinguishing
statement-level from service-level correlation, including the stored
procedure limitation and the manual comment format needed to enable
service-level correlation for OpenTelemetry setups. Add a callout to
the Go tab of Connect DBM and APM warning about a latency regression
when using full propagation mode with the pgx driver.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@pierreln-dd pierreln-dd changed the title Document OTel service-level DBM correlation and pgx propagation caveat Document OTel service-level DBM correlation Jul 28, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Preview links (active after the build_preview check completes)

Modified Files

Remove reassurance-style phrasing and redundant restatements to match
Datadog's straightforward, direct documentation voice.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@pierreln-dd
pierreln-dd marked this pull request as ready for review July 29, 2026 11:32
@pierreln-dd
pierreln-dd requested a review from a team as a code owner July 29, 2026 11:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant