Skip to content

feat(otel): add support for opentelemetry logs#3748

Open
rachelyangdog wants to merge 7 commits intomasterfrom
rachel.yang/otel-logs
Open

feat(otel): add support for opentelemetry logs#3748
rachelyangdog wants to merge 7 commits intomasterfrom
rachel.yang/otel-logs

Conversation

@rachelyangdog
Copy link
Copy Markdown
Contributor

@rachelyangdog rachelyangdog commented Mar 27, 2026

Description

Adds OpenTelemetry logs support to dd-trace-php, gated behind a new DD_LOGS_OTEL_ENABLED configuration flag.

New config flag: DD_LOGS_OTEL_ENABLED (default: false) enables OTel log collection and OTLP export. When enabled, Datadog's own log injection is suppressed so the two pipelines don't conflict.

  • CompositeResolver now handles logs signal endpoints and protocols alongside the existing metrics support. Endpoint/protocol resolution is refactored from metrics-specific to signal-agnostic

Reviewer checklist

  • Test coverage seems ok.
  • Appropriate labels assigned.

@rachelyangdog rachelyangdog requested review from a team as code owners March 27, 2026 20:42
@rachelyangdog rachelyangdog marked this pull request as draft March 27, 2026 20:42
@rachelyangdog rachelyangdog requested a review from bwoebi March 27, 2026 20:42
@codecov-commenter
Copy link
Copy Markdown

codecov-commenter commented Mar 27, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 68.78%. Comparing base (fd1ba67) to head (5e7dc32).

Additional details and impacted files

Impacted file tree graph

@@            Coverage Diff             @@
##           master    #3748      +/-   ##
==========================================
- Coverage   68.85%   68.78%   -0.08%     
==========================================
  Files         166      166              
  Lines       19015    19015              
  Branches     1792     1792              
==========================================
- Hits        13093    13079      -14     
- Misses       5111     5124      +13     
- Partials      811      812       +1     
Flag Coverage Δ
helper-rust-integration 78.82% <ø> (ø)
helper-rust-unit 49.36% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.
see 3 files with indirect coverage changes


Continue to review full report in Codecov by Sentry.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update fd1ba67...5e7dc32. Read the comment docs.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@datadog-prod-us1-5
Copy link
Copy Markdown

datadog-prod-us1-5 Bot commented Mar 27, 2026

Tests

Fix all issues with BitsAI or with Cursor

⚠️ Warnings

🧪 1 Test failed

❄️ Known flaky: telemetry reflects the loading of a new integration() from com.datadog.appsec.php.integration.TelemetryTests   View in Datadog   (Fix with Cursor)
Assertion failed: 

assert !foundRedis
       ||
       |true
       false

Assertion failed: 

assert !foundRedis
...

ℹ️ Info

No other issues found (see more)

❄️ No new flaky tests detected

🎯 Code Coverage (details)
Patch Coverage: 100.00%
Overall Coverage: 60.67% (-0.03%)

Useful? React with 👍 / 👎

This comment will be updated automatically if new data arrives.
🔗 Commit SHA: 3bc3388 | Docs | Datadog PR Page | Give us feedback!

@pr-commenter
Copy link
Copy Markdown

pr-commenter Bot commented Mar 27, 2026

Benchmarks [ tracer ]

Benchmark execution time: 2026-05-08 20:59:03

Comparing candidate commit 3bc3388 in PR branch rachel.yang/otel-logs with baseline commit 29c8781 in branch master.

Found 3 performance improvements and 0 performance regressions! Performance is the same for 188 metrics, 3 unstable metrics.

scenario:MessagePackSerializationBench/benchMessagePackSerialization

  • 🟩 execution_time [-6.643µs; -5.857µs] or [-5.977%; -5.270%]

scenario:MessagePackSerializationBench/benchMessagePackSerialization-opcache

  • 🟩 execution_time [-8.128µs; -6.012µs] or [-7.400%; -5.473%]

scenario:SamplingRuleMatchingBench/benchRegexMatching1-opcache

  • 🟩 execution_time [-127.731ns; -51.269ns] or [-7.460%; -2.994%]

@rachelyangdog rachelyangdog marked this pull request as ready for review May 7, 2026 19:18
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d0b32bc04a

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +22 to +24
if ($name === 'OTEL_PHP_AUTOLOAD_ENABLED') {
return \dd_trace_env_config('DD_METRICS_OTEL_ENABLED')
|| \dd_trace_env_config('DD_LOGS_OTEL_ENABLED');
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Prevent logs mode from enabling all OTel signals

When only DD_LOGS_OTEL_ENABLED=true is set, this makes OTEL_PHP_AUTOLOAD_ENABLED resolve to true, and the OpenTelemetry PHP autoloader initializes tracer, meter, and logger providers together. Because this resolver does not also force OTEL_TRACES_EXPORTER and OTEL_METRICS_EXPORTER to none, their SDK defaults remain otlp, so enabling Datadog's OTel logs mode can also start exporting traces and metrics for applications that did not opt into those signals.

Useful? React with 👍 / 👎.

@rachelyangdog rachelyangdog changed the title WIP: feat(otel): add support for opentelemetry logs feat(otel): add support for opentelemetry logs May 7, 2026
rachelyangdog and others added 3 commits May 8, 2026 14:53
…olver

The previous override flipped OTEL_PHP_AUTOLOAD_ENABLED=true whenever
DD_LOGS_OTEL_ENABLED or DD_METRICS_OTEL_ENABLED was set. That caused two
unintended side effects:

1. SdkAutoloader::environmentBasedInitializer builds *all three* providers
   (Tracer, Meter, Logger), each defaulting to OTLP exporters via
   OTEL_TRACES_EXPORTER / OTEL_METRICS_EXPORTER / OTEL_LOGS_EXPORTER. So
   opting into Datadog's OTel logs path could silently activate OTLP
   trace + metric export for any user code reaching for
   Globals::tracerProvider() / meterProvider().

2. SdkAutoloader::registerInstrumentations runs ServiceLoader::load on the
   OTel auto-instrumentation SPI, registering every contrib-auto-* package
   present on the classpath — completely unrelated to logs.

DD_LOGS_OTEL_ENABLED now only triggers our existing bridge-file load (via
dd_perform_autoload) and the DatadogResolver defaults for
OTEL_EXPORTER_OTLP_LOGS_ENDPOINT, mirroring the pattern DD_METRICS_OTEL_ENABLED
already follows. Users wire their own LoggerProvider (and may opt into
OTEL_PHP_AUTOLOAD_ENABLED themselves with full knowledge of its side effects).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The function was added in the original WIP commit but never wired via
.env_config_fallback in configuration.h. The metrics counterpart hooks
DD_INTEGRATION_METRICS_ENABLED, but PHP has no equivalent
DD_INTEGRATION_LOGS_ENABLED to attach this to. Dead code; removing.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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