[DI] Support enabling Dynamic Instrumentation with simple boolean

[watson]

What does this PR do?

Support configuring Dynamic Instrumentation (DI) with a simple boolean instead of a complex object:

tracer.init({ dynamicInstrumentation: true })

Previously, you'd have to do it like so:

tracer.init({ dynamicInstrumentation: { enabled: true } })

The old approach is still the supported. The new version is just an alias for the more complex object.

Motivation

Make it easier to enable DI and align with how a lot of the other complex config objects work.

Plugin Checklist

• Unit tests.
• TypeScript definitions.
• TypeScript tests.
• API documentation.
• CircleCI jobs/workflows.
• Plugin is exported.

Additional Notes

[watson]

• [DI] Support enabling Dynamic Instrumentation with simple boolean #5636 👈 (View in Graphite)
• [Code Origin for Spans] Allow code origin to be disabled #5635
• master

This stack of pull requests is managed by Graphite. Learn more about stacking.

[github-actions]

Overall package size

Self size: 9.31 MB
Deduped: 102.56 MB
No deduping: 103.08 MB

Dependency sizes

| name | version | self size | total size | |------|---------|-----------|------------| | @datadog/libdatadog | 0.5.1 | 29.73 MB | 29.73 MB | | @datadog/native-appsec | 8.5.2 | 19.33 MB | 19.34 MB | | @datadog/native-iast-taint-tracking | 3.3.1 | 13.99 MB | 13.99 MB | | @datadog/pprof | 5.7.1 | 9.51 MB | 9.88 MB | | @opentelemetry/core | 1.30.1 | 908.66 kB | 7.16 MB | | protobufjs | 7.4.0 | 2.77 MB | 5.42 MB | | @datadog/wasm-js-rewriter | 4.0.1 | 2.85 MB | 3.58 MB | | @datadog/native-metrics | 3.1.1 | 1.02 MB | 1.43 MB | | @opentelemetry/api | 1.8.0 | 1.21 MB | 1.21 MB | | import-in-the-middle | 1.13.1 | 117.64 kB | 839.26 kB | | source-map | 0.7.4 | 226 kB | 226 kB | | opentracing | 0.14.7 | 194.81 kB | 194.81 kB | | lru-cache | 7.18.3 | 133.92 kB | 133.92 kB | | pprof-format | 2.1.0 | 111.69 kB | 111.69 kB | | @datadog/sketches-js | 2.1.1 | 109.9 kB | 109.9 kB | | lodash.sortby | 4.7.0 | 75.76 kB | 75.76 kB | | ignore | 5.3.2 | 53.63 kB | 53.63 kB | | istanbul-lib-coverage | 3.2.0 | 29.34 kB | 29.34 kB | | rfdc | 1.4.1 | 27.15 kB | 27.15 kB | | @isaacs/ttlcache | 1.4.1 | 25.2 kB | 25.2 kB | | dc-polyfill | 0.1.8 | 25.08 kB | 25.08 kB | | tlhunter-sorted-set | 0.1.0 | 24.94 kB | 24.94 kB | | shell-quote | 1.8.2 | 23.54 kB | 23.54 kB | | limiter | 1.1.5 | 23.17 kB | 23.17 kB | | retry | 0.13.1 | 18.85 kB | 18.85 kB | | semifies | 1.0.0 | 15.84 kB | 15.84 kB | | jest-docblock | 29.7.0 | 8.99 kB | 12.76 kB | | crypto-randomuuid | 1.0.0 | 11.18 kB | 11.18 kB | | ttl-set | 1.0.0 | 4.61 kB | 9.69 kB | | mutexify | 1.4.0 | 5.71 kB | 8.74 kB | | path-to-regexp | 0.1.12 | 6.6 kB | 6.6 kB | | koalas | 1.0.2 | 6.47 kB | 6.47 kB | | module-details-from-path | 1.0.3 | 4.47 kB | 4.47 kB |

_{🤖 This report was automatically generated by heaviest-objects-in-the-universe}

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 79.06%. Comparing base (91d30e8) to head (237f8e2).
Report is 1 commits behind head on graphite-base/5636.

Additional details and impacted files

@@                  Coverage Diff                   @@
##           graphite-base/5636    #5636      +/-   ##
======================================================
+ Coverage               79.03%   79.06%   +0.02%     
======================================================
  Files                     512      512              
  Lines                   23391    23406      +15     
======================================================
+ Hits                    18488    18505      +17     
+ Misses                   4903     4901       -2     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 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.

[pr-commenter]

Benchmarks

Benchmark execution time: 2025-04-30 11:12:44

Comparing candidate commit 237f8e2 in PR branch watson/DEBUG-3793/di-conf-boolean with baseline commit 91d30e8 in branch watson/DEBUG-3790/fix-code-origin-for-spans-config.

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

[datadog-datadog-prod-us1]

Datadog Report

Branch report: watson/DEBUG-3793/di-conf-boolean
Commit report: 6766ef0
Test service: dd-trace-js-integration-tests

✅ 0 Failed, 931 Passed, 0 Skipped, 15m 36.14s Total Time

[BridgeAR]

Was that actively requested as feature? I am asking due to trying to minimize the programmatic API usage and to make sure users use environment variables as much as possible instead.

[BridgeAR]

Seems like our options are generally very inconsistent at the moment.

This is something we should probably tackle in a generic fashion in the config.js file to use accept a boolean in case .enabled exists for the option.