Skip to content

docs(v6): updated documentation for v6#9159

Merged
pabloerhard merged 4 commits into
masterfrom
pabloerhard/documentation-v6
Jul 2, 2026
Merged

docs(v6): updated documentation for v6#9159
pabloerhard merged 4 commits into
masterfrom
pabloerhard/documentation-v6

Conversation

@pabloerhard

Copy link
Copy Markdown
Contributor

What does this PR do?

This PR updates the README.md and MIGRATION.md file in preparation of v6 release.

Motivation

Additional Notes

@dd-octo-sts

dd-octo-sts Bot commented Jun 30, 2026

Copy link
Copy Markdown
Contributor

Overall package size

Self size: 6.52 MB
Deduped: 7.59 MB
No deduping: 7.59 MB

Dependency sizes | name | version | self size | total size | |------|---------|-----------|------------| | import-in-the-middle | 3.2.0 | 104.26 kB | 843.44 kB | | opentracing | 0.14.7 | 194.81 kB | 194.81 kB | | dc-polyfill | 0.1.11 | 25.74 kB | 25.74 kB |

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

@datadog-prod-us1-5

datadog-prod-us1-5 Bot commented Jun 30, 2026

Copy link
Copy Markdown

Tests

🎉 All green!

🧪 All tests passed
❄️ No new flaky tests detected

🎯 Code Coverage (details)
Patch Coverage: 100.00%
Overall Coverage: 87.86% (-0.18%)

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

Comment thread MIGRATING.md
Comment on lines +11 to +13
Node.js 18 reached EOL in April 2025 and Node.js 20 reached EOL in April 2026;
neither is supported in v6. We highly recommend always keeping Node.js up to
date regardless of our support policy.

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 think it would be nice to mention that it helps for security reasons and I believe we should mention that we want to start Node.js 22 support from LTS on, not from 20.0.0

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.

Since the release is already late, I think we should address this after v6.

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.

Is pushing that small change so time consuming? 😄

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 is a more significant change than you make it seem. It requires changes to our docs, external policies, all of CI and multiple scripts since everything only expects to receive a major version. It also gives us effectively no benefit as the difference between 22 and 22.11 is not much, and according to our numbers most people are on LTS so both are effectively equivalent. I see no reason why that should be blocking this release, and you can implement all that is required by v7.

@codecov

codecov Bot commented Jun 30, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.64%. Comparing base (2d62430) to head (b84c79f).
⚠️ Report is 22 commits behind head on master.

Additional details and impacted files
@@            Coverage Diff             @@
##           master    #9159      +/-   ##
==========================================
- Coverage   93.73%   93.64%   -0.09%     
==========================================
  Files         892      898       +6     
  Lines       51238    52365    +1127     
  Branches    11923    12324     +401     
==========================================
+ Hits        48027    49037    +1010     
- Misses       3211     3328     +117     
Flag Coverage Δ
aiguard 34.88% <ø> (-0.07%) ⬇️
aiguard-integration 41.96% <ø> (+0.17%) ⬆️
apm-bucket-0 34.84% <ø> (-0.07%) ⬇️
apm-bucket-1 40.51% <ø> (+0.10%) ⬆️
apm-bucket-2 37.50% <ø> (+0.09%) ⬆️
apm-capabilities-tracing 48.88% <ø> (+0.20%) ⬆️
apm-integrations-aerospike 33.13% <ø> (-0.07%) ⬇️
apm-integrations-confluentinc-kafka-javascript 40.03% <ø> (-0.07%) ⬇️
apm-integrations-couchbase 33.52% <ø> (+0.20%) ⬆️
apm-integrations-http 42.05% <ø> (+0.03%) ⬆️
apm-integrations-kafkajs 40.27% <ø> (-0.07%) ⬇️
apm-integrations-next 29.60% <ø> (+0.03%) ⬆️
apm-integrations-prisma 35.18% <ø> (+0.08%) ⬆️
apm-integrations-tedious 34.05% <ø> (+0.08%) ⬆️
appsec 57.92% <ø> (+0.17%) ⬆️
appsec-express_fastify_graphql 53.86% <ø> (+0.14%) ⬆️
appsec-integration 35.68% <ø> (-0.54%) ⬇️
appsec-kafka_ldapjs_lodash 43.83% <ø> (+0.19%) ⬆️
appsec-mongodb-core_mongoose_mysql 48.91% <ø> (+0.11%) ⬆️
appsec-next 28.11% <ø> (+0.04%) ⬆️
appsec-node-serialize_passport_postgres 48.08% <ø> (+0.11%) ⬆️
appsec-sourcing_stripe_template 45.64% <ø> (+0.10%) ⬆️
debugger 44.64% <ø> (+0.26%) ⬆️
instrumentations-bucket-0 28.17% <ø> (-0.06%) ⬇️
instrumentations-bucket-1 37.57% <ø> (+0.09%) ⬆️
instrumentations-bucket-10 40.52% <ø> (+0.10%) ⬆️
instrumentations-bucket-11 27.96% <ø> (-0.06%) ⬇️
instrumentations-bucket-12 28.79% <ø> (+0.05%) ⬆️
instrumentations-bucket-13 27.79% <ø> (-0.07%) ⬇️
instrumentations-bucket-2 30.36% <ø> (+0.06%) ⬆️
instrumentations-bucket-3 36.06% <ø> (+0.08%) ⬆️
instrumentations-bucket-4 28.58% <ø> (-0.07%) ⬇️
instrumentations-bucket-5 36.42% <ø> (+0.08%) ⬆️
instrumentations-bucket-6 38.43% <ø> (+0.10%) ⬆️
instrumentations-bucket-7 36.16% <ø> (+0.08%) ⬆️
instrumentations-bucket-8 37.11% <ø> (+0.09%) ⬆️
instrumentations-bucket-9 39.62% <ø> (+0.09%) ⬆️
instrumentations-instrumentation-couchbase 46.48% <ø> (ø)
instrumentations-integration-esbuild 24.51% <ø> (-0.36%) ⬇️
llmobs-ai_anthropic_bedrock 39.68% <ø> (+0.09%) ⬆️
llmobs-google-genai_langchain_vertex-ai 37.10% <ø> (+0.07%) ⬆️
llmobs-openai 39.74% <ø> (+0.10%) ⬆️
llmobs-sdk 43.59% <ø> (-0.08%) ⬇️
master-coverage 93.64% <ø> (?)
openfeature 37.94% <ø> (+0.17%) ⬆️
openfeature-unit 50.47% <ø> (+0.07%) ⬆️
platform-core_esbuild_instrumentations-misc 22.96% <ø> (-0.40%) ⬇️
platform-integration 47.59% <ø> (+0.16%) ⬆️
platform-shimmer_unit-guardrails_webpack 18.48% <ø> (-0.43%) ⬇️
plugins-bucket-0 36.52% <ø> (+0.12%) ⬆️
plugins-bucket-1 39.78% <ø> (+0.18%) ⬆️
plugins-bucket-11 38.63% <ø> (+0.10%) ⬆️
plugins-bucket-17 39.22% <ø> (+<0.01%) ⬆️
plugins-bucket-18 42.17% <ø> (+0.10%) ⬆️
plugins-bucket-19 39.73% <ø> (+0.10%) ⬆️
plugins-bucket-20 43.44% <ø> (+0.11%) ⬆️
plugins-bucket-4 37.88% <ø> (+0.09%) ⬆️
plugins-bullmq_cassandra_cookie 39.93% <ø> (+0.10%) ⬆️
plugins-cookie-parser_crypto_dd-trace-api 33.23% <ø> (-0.07%) ⬇️
plugins-fetch_fs_generic-pool 36.21% <ø> (+0.08%) ⬆️
plugins-google-cloud-pubsub_grpc_handlebars 43.09% <ø> (-0.08%) ⬇️
plugins-hapi_hono_ioredis 37.95% <ø> (+0.09%) ⬆️
plugins-jest_knex_langgraph 32.61% <ø> (-0.07%) ⬇️
plugins-ldapjs_light-my-request_limitd-client 27.92% <ø> (+<0.01%) ⬆️
plugins-lodash_mariadb_memcached 35.18% <ø> (-0.07%) ⬇️
plugins-mongodb_mongodb-core_mongoose 36.46% <ø> (+0.09%) ⬆️
plugins-multer_mysql_mysql2 35.15% <ø> (-0.07%) ⬇️
plugins-nats_node-serialize_opensearch 37.31% <ø> (+0.09%) ⬆️
plugins-passport-http_pino_postgres 35.53% <ø> (-0.07%) ⬇️
plugins-process_pug_redis 34.27% <ø> (-0.07%) ⬇️
plugins-undici_url_valkey 36.04% <ø> (+0.09%) ⬆️
plugins-vm_winston_ws 37.72% <ø> (+0.09%) ⬆️
profiling 43.81% <ø> (+0.12%) ⬆️
serverless-aws-sdk-aws-sdk 33.32% <ø> (-0.04%) ⬇️
serverless-aws-sdk-bedrockruntime 32.19% <ø> (-0.03%) ⬇️
serverless-aws-sdk-client 37.16% <ø> (ø)
serverless-aws-sdk-dynamodb 34.19% <ø> (-0.02%) ⬇️
serverless-aws-sdk-eventbridge 27.36% <ø> (+0.05%) ⬆️
serverless-aws-sdk-kinesis 37.55% <ø> (+0.08%) ⬆️
serverless-aws-sdk-lambda 34.64% <ø> (-0.02%) ⬇️
serverless-aws-sdk-s3 32.63% <ø> (-0.03%) ⬇️
serverless-aws-sdk-serverless-peer-service 39.65% <ø> (+0.10%) ⬆️
serverless-aws-sdk-sns 38.40% <ø> (+0.08%) ⬆️
serverless-aws-sdk-sqs 38.14% <ø> (+0.08%) ⬆️
serverless-aws-sdk-stepfunctions 33.22% <ø> (-0.03%) ⬇️
serverless-aws-sdk-util 47.95% <ø> (ø)
serverless-bucket-0 39.64% <ø> (+0.18%) ⬆️
serverless-lambda 34.34% <ø> (-0.08%) ⬇️
test-optimization-cucumber 52.54% <ø> (+0.25%) ⬆️
test-optimization-cypress 49.63% <ø> (+0.29%) ⬆️
test-optimization-jest 55.61% <ø> (+0.40%) ⬆️
test-optimization-mocha 53.61% <ø> (+0.31%) ⬆️
test-optimization-playwright-playwright-atr 43.53% <ø> (+0.29%) ⬆️
test-optimization-playwright-playwright-efd 43.81% <ø> (+0.29%) ⬆️
test-optimization-playwright-playwright-final-status 43.94% <ø> (+0.29%) ⬆️
test-optimization-playwright-playwright-impacted-tests 43.36% <ø> (+0.20%) ⬆️
test-optimization-playwright-playwright-reporting 43.47% <ø> (+0.29%) ⬆️
test-optimization-playwright-playwright-test-management 44.94% <ø> (+0.31%) ⬆️
test-optimization-playwright-playwright-test-span 44.72% <ø> (+0.29%) ⬆️
test-optimization-selenium 45.44% <ø> (+0.22%) ⬆️
test-optimization-testopt 46.82% <ø> (-1.14%) ⬇️
test-optimization-vitest 52.71% <ø> (+2.16%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 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

pr-commenter Bot commented Jun 30, 2026

Copy link
Copy Markdown

Benchmarks

Benchmark execution time: 2026-07-02 16:27:43

Comparing candidate commit b84c79f in PR branch pabloerhard/documentation-v6 with baseline commit 2d62430 in branch master.

📊 Benchmarking dashboard

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

Explanation

This is an A/B test comparing a candidate commit's performance against that of a baseline commit. Performance changes are noted in the tables below as:

  • 🟩 = significantly better candidate vs. baseline
  • 🟥 = significantly worse candidate vs. baseline

We compute a confidence interval (CI) over the relative difference of means between metrics from the candidate and baseline commits, considering the baseline as the reference.

If the CI is entirely outside the configured SIGNIFICANT_IMPACT_THRESHOLD (or the deprecated UNCONFIDENCE_THRESHOLD), the change is considered significant.

Feel free to reach out to #apm-benchmarking-platform on Slack if you have any questions.

More details about the CI and significant changes

You can imagine this CI as a range of values that is likely to contain the true difference of means between the candidate and baseline commits.

CIs of the difference of means are often centered around 0%, because often changes are not that big:

---------------------------------(------|---^--------)-------------------------------->
                              -0.6%    0%  0.3%     +1.2%
                                 |          |        |
         lower bound of the CI --'          |        |
sample mean (center of the CI) -------------'        |
         upper bound of the CI ----------------------'

As described above, a change is considered significant if the CI is entirely outside the configured SIGNIFICANT_IMPACT_THRESHOLD (or the deprecated UNCONFIDENCE_THRESHOLD).

For instance, for an execution time metric, this confidence interval indicates a significantly worse performance:

----------------------------------------|---------|---(---------^---------)---------->
                                       0%        1%  1.3%      2.2%      3.1%
                                                  |   |         |         |
       significant impact threshold --------------'   |         |         |
                      lower bound of CI --------------'         |         |
       sample mean (center of the CI) --------------------------'         |
                      upper bound of CI ----------------------------------'

Unstable benchmarks

These benchmarks have a confidence interval too wide to call a change; treat them as noise rather than signal.

scenario:appsec-appsec-enabled-20

  • unstable execution_time [-191.369ms; +183.108ms] or [-5.135%; +4.913%]

scenario:appsec-appsec-enabled-24

  • unstable execution_time [-177.736ms; +183.543ms] or [-6.766%; +6.987%]

scenario:appsec-appsec-enabled-26

  • unstable execution_time [-210.447ms; +208.090ms] or [-8.353%; +8.260%]

scenario:appsec-appsec-enabled-with-attacks-26

  • unstable execution_time [-159170.718µs; +158755.718µs] or [-5.538%; +5.523%]

scenario:appsec-control-20

  • unstable execution_time [-154.381ms; +147.594ms] or [-8.937%; +8.545%]

scenario:appsec-control-24

  • unstable execution_time [-105.799ms; +83.186ms] or [-8.781%; +6.904%]

scenario:appsec-control-26

  • unstable execution_time [-112.257ms; +117.740ms] or [-9.274%; +9.727%]

scenario:debugger-line-probe-with-snapshot-default-24

  • unstable cpu_user_time [-2674.864ms; +2713.348ms] or [-31.502%; +31.955%]
  • unstable execution_time [-2716.159ms; +2746.028ms] or [-29.566%; +29.891%]
  • unstable instructions [-22898.9M instructions; +23200.0M instructions] or [-33.018%; +33.452%]
  • unstable max_rss_usage [-9979.064KB; +9735.064KB] or [-6.225%; +6.072%]
  • unstable throughput [-798.759op/s; +791.910op/s] or [-21.775%; +21.589%]

scenario:debugger-line-probe-with-snapshot-default-26

  • unstable cpu_user_time [-3632.455ms; +3596.333ms] or [-32.338%; +32.016%]
  • unstable execution_time [-3721.089ms; +3659.916ms] or [-31.120%; +30.609%]
  • unstable instructions [-31718.6M instructions; +31535.7M instructions] or [-33.538%; +33.344%]
  • unstable max_rss_usage [-11039.478KB; +10658.678KB] or [-6.706%; +6.475%]
  • unstable throughput [-789.040op/s; +815.021op/s] or [-27.625%; +28.535%]

scenario:debugger-line-probe-with-snapshot-minimal-24

  • unstable cpu_user_time [-2642.360ms; +3784.536ms] or [-29.102%; +41.681%]
  • unstable execution_time [-2669.761ms; +3812.175ms] or [-27.371%; +39.084%]
  • unstable instructions [-23.0G instructions; +32.5G instructions] or [-30.876%; +43.722%]
  • unstable max_rss_usage [-10.099MB; +14.108MB] or [-6.216%; +8.684%]
  • unstable throughput [-1116.808op/s; +774.518op/s] or [-31.854%; +22.091%]

scenario:debugger-line-probe-with-snapshot-minimal-26

  • unstable cpu_user_time [-3683.336ms; +2448.055ms] or [-34.976%; +23.246%]
  • unstable execution_time [-3727.414ms; +2499.410ms] or [-33.201%; +22.263%]
  • unstable instructions [-32.9G instructions; +21.9G instructions] or [-37.225%; +24.767%]
  • unstable max_rss_usage [-11.217MB; +6.712MB] or [-6.874%; +4.113%]
  • unstable throughput [-557.046op/s; +817.746op/s] or [-18.415%; +27.034%]

scenario:debugger-line-probe-without-snapshot-24

  • unstable cpu_user_time [-1823.214ms; +2928.742ms] or [-23.075%; +37.066%]
  • unstable execution_time [-1833.691ms; +2953.096ms] or [-21.356%; +34.394%]
  • unstable instructions [-15.8G instructions; +25.2G instructions] or [-24.585%; +39.171%]
  • unstable max_rss_usage [-6.567MB; +10.720MB] or [-4.159%; +6.790%]
  • unstable throughput [-882.753op/s; +544.055op/s] or [-22.993%; +14.171%]

scenario:debugger-line-probe-without-snapshot-26

  • unstable cpu_user_time [-3108.559ms; +2906.314ms] or [-30.823%; +28.817%]
  • unstable execution_time [-3123.614ms; +2926.459ms] or [-28.930%; +27.104%]
  • unstable instructions [-27722.2M instructions; +26253.4M instructions] or [-32.881%; +31.139%]
  • unstable max_rss_usage [-11.462MB; +8.857MB] or [-7.113%; +5.496%]
  • unstable throughput [-649.277op/s; +647.172op/s] or [-20.795%; +20.727%]

scenario:dogstatsd-with-tags-20

  • unstable cpu_user_time [-354.523ms; +366.977ms] or [-7.143%; +7.394%]
  • unstable execution_time [-354.980ms; +366.477ms] or [-7.047%; +7.275%]
  • unstable throughput [-127177.524op/s; +120848.334op/s] or [-7.621%; +7.242%]

scenario:plugin-graphql-long-with-depth-and-collapse-off-20

  • unstable max_rss_usage [-33.626MB; +51.311MB] or [-8.465%; +12.917%]

scenario:plugin-graphql-long-with-depth-off-20

  • unstable max_rss_usage [-8063.584KB; +6958.441KB] or [-6.154%; +5.311%]

@pabloerhard
pabloerhard marked this pull request as ready for review June 30, 2026 20:57
@pabloerhard
pabloerhard requested a review from a team as a code owner June 30, 2026 20:57

@chatgpt-codex-connector chatgpt-codex-connector 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.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 32e1946833

ℹ️ About Codex in GitHub

Codex has been enabled to automatically 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 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment thread MIGRATING.md
Comment thread MIGRATING.md Outdated
rochdev
rochdev previously approved these changes Jun 30, 2026
rochdev
rochdev previously approved these changes Jun 30, 2026
@pabloerhard pabloerhard changed the title docs(v6): updated documentation for v6 [DONT MERGE] docs(v6): updated documentation for v6 Jul 1, 2026
rochdev
rochdev previously approved these changes Jul 2, 2026
Comment thread MIGRATING.md Outdated
Comment thread MIGRATING.md Outdated
Comment thread MIGRATING.md
Comment thread MIGRATING.md Outdated
Comment thread MIGRATING.md Outdated
@pabloerhard pabloerhard changed the title [DONT MERGE] docs(v6): updated documentation for v6 docs(v6): updated documentation for v6 Jul 2, 2026
@pabloerhard
pabloerhard merged commit 7bc2032 into master Jul 2, 2026
696 of 697 checks passed
@pabloerhard
pabloerhard deleted the pabloerhard/documentation-v6 branch July 2, 2026 18:36
dd-octo-sts Bot pushed a commit that referenced this pull request Jul 2, 2026
* docs(v6): updated documentation for v6

* update release date

* fix CI test session migratin doc

* Fix for test-opt concerns
@dd-octo-sts dd-octo-sts Bot mentioned this pull request Jul 2, 2026
dd-octo-sts Bot pushed a commit that referenced this pull request Jul 2, 2026
* docs(v6): updated documentation for v6

* update release date

* fix CI test session migratin doc

* Fix for test-opt concerns
@dd-octo-sts dd-octo-sts Bot mentioned this pull request Jul 2, 2026
rochdev pushed a commit that referenced this pull request Jul 2, 2026
* docs(v6): updated documentation for v6

* update release date

* fix CI test session migratin doc

* Fix for test-opt concerns
rochdev pushed a commit that referenced this pull request Jul 2, 2026
* docs(v6): updated documentation for v6

* update release date

* fix CI test session migratin doc

* Fix for test-opt concerns
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants