Skip to content

Detach local spans from propagated contexts - #97026

Draft
DavidIlie wants to merge 1 commit into
canaryfrom
codex/websocket-tracing-prerequisite
Draft

Detach local spans from propagated contexts#97026
DavidIlie wants to merge 1 commit into
canaryfrom
codex/websocket-tracing-prerequisite

Conversation

@DavidIlie

Copy link
Copy Markdown
Contributor

What?

Add a tracing primitive for running work outside both the current local span and the propagated OpenTelemetry context.

Why?

Long-lived work must not inherit a request span after that request has completed. WebSocket connection hooks need this behavior, but the underlying context-restoration contract also applies independently to middleware tracing.

How?

  • Add runWithoutLocalSpan() to the local span recorder.
  • Clear and restore both local and propagated tracing contexts across synchronous and asynchronous work.
  • Cover context restoration, unregistered recorders, and the middleware-only regression.

This is the first PR in the experimental WebSocket Route Handler stack. The transport and public API are added by the following PRs.

Verification

  • pnpm exec jest --runInBand packages/next/src/server/lib/trace/tracer.test.ts
  • WebSocket hook-context coverage in the complete stack

@github-actions

github-actions Bot commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

Stats from current PR

🟢 1 improvement

Metric Canary PR Change Trend
Webpack Build Time (cached) 25.117s 24.378s 🟢 739ms (-3%) ▄█▆▃█
📊 All Metrics
📖 Metrics Glossary

Dev Server Metrics:

  • Listen = TCP port starts accepting connections
  • First Request = HTTP server returns successful response
  • Cold = Fresh build (no cache)
  • Warm = With cached build artifacts

Build Metrics:

  • Fresh = Clean build (no .next directory)
  • Cached = With existing .next directory

Change Thresholds:

  • Time: Changes < 50ms AND < 10%, OR < 2% are insignificant
  • Size: Changes < 1KB AND < 1% are insignificant
  • All other changes are flagged to catch regressions

⚡ Dev Server

Metric Canary PR Change Trend
Cold (Listen) 865ms 864ms ▁█▁▁▁
Cold (Ready in log) 839ms 841ms ▁█▁▂▁
Cold (First Request) 1.363s 1.386s ▁█▂▃▂
Warm (Listen) 864ms 864ms ▁█▁▁▁
Warm (Ready in log) 839ms 852ms ▁█▁▁▁
Warm (First Request) 1.362s 1.371s ▄▁▅▅▄
📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric Canary PR Change Trend
Cold (Listen) 812ms 812ms ▇▇▇▅█
Cold (Ready in log) 798ms 799ms █▆▆▂█
Cold (First Request) 3.371s 3.324s ▇▄▄▂█
Warm (Listen) 813ms 812ms █████
Warm (Ready in log) 796ms 789ms ▇█▄▄█
Warm (First Request) 3.317s 3.377s ▅█▃▃█

⚡ Production Builds

Metric Canary PR Change Trend
Fresh Build 6.536s 6.582s ▁█▂▃▁
Cached Build 3.362s 3.371s ▁█▃▃▂
📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric Canary PR Change Trend
Fresh Build 24.693s 24.370s ▂█▃▁▆
Cached Build 25.117s 24.378s 🟢 739ms (-3%) ▄█▆▃█
node_modules Size 554 MB 554 MB ▁▁▁▁▁
📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles
Canary PR Change
050icza-xjz0i.js gzip 5.73 kB N/A -
07jdby0ue616s.js gzip 450 B N/A -
0bjdc8muo74n5.js gzip 8.71 kB N/A -
0cz1d0mv5g_q7.js gzip 39.4 kB 39.4 kB
0eo3xvq-zd3j2.js gzip 65.6 kB N/A -
0rci1f3or1a19.js gzip 13.3 kB N/A -
1_2x714--ii1i.js gzip 8.76 kB N/A -
1-3y752pkth5-.js gzip 10 kB N/A -
1-nfv1877mihd.js gzip 156 B N/A -
12bso2e_5x4zx.js gzip 157 B N/A -
140af-gch2905.js gzip 157 B N/A -
1469bmgz0r8ob.js gzip 154 B N/A -
15_1l6mmqyrws.js gzip 156 B N/A -
15xlq53c28l8-.js gzip 159 B N/A -
16loy0anq4cfq.js gzip 154 B N/A -
19gb-1_5udxfb.js gzip 13.2 kB N/A -
1cywsbjgohnj9.js gzip 167 B N/A -
1elt1qium-r2m.css gzip 115 B 115 B
1qij_v1qfn8w5.js gzip 71.6 kB N/A -
1tf1phijqlx9j.js gzip 220 B 220 B
1uzabyd1120a1.js gzip 8.71 kB N/A -
1y91ypv-32-2c.js gzip 150 B N/A -
2-ufv8lc-g7gg.js gzip 10.6 kB N/A -
21kmjy_10x14f.js gzip 8.81 kB N/A -
28dhc6t85q1_p.js gzip 8.78 kB N/A -
2f-ilvczue-tp.js gzip 9.46 kB N/A -
2f1u17u5c8iny.js gzip 8.79 kB N/A -
2ikltg_8iegxw.js gzip 10.3 kB N/A -
2ixp3xn2_vz0r.js gzip 3.57 kB N/A -
2r1yklvxhy9fu.js gzip 154 B N/A -
2vxi673cz1-t4.js gzip 8.79 kB N/A -
37zg4vafpzsi1.js gzip 155 B N/A -
38-q43pzktqhs.js gzip 1.46 kB N/A -
3f977fytahn5a.js gzip 7.53 kB N/A -
3nbojhxiy1qv_.js gzip 13.7 kB N/A -
3npru_5qbg6lt.js gzip 155 B N/A -
3r9mg09sag_yr.js gzip 47 kB N/A -
41u5s3oe2-erp.js gzip 2.29 kB N/A -
445s_9hf8o7ao.js gzip 8.76 kB N/A -
4486in8mnn3zl.js gzip 154 B N/A -
turbopack-0d..9ejy.js gzip 3.74 kB 3.74 kB
0-6bcj16ji2wf.js gzip N/A 10.6 kB -
07ryk0jced-sc.js gzip N/A 8.78 kB -
0bck4f999fyqy.js gzip N/A 71.7 kB -
0cib1uxlom68m.js gzip N/A 154 B -
0jwho9fkrb_t3.js gzip N/A 2.29 kB -
0kfnsdg9gjq_a.js gzip N/A 155 B -
0roh390ijzxa5.js gzip N/A 8.75 kB -
0vex9w55ursqj.js gzip N/A 8.79 kB -
11zw3t1q0obkt.js gzip N/A 46.9 kB -
13fdp6hysi38e.js gzip N/A 7.53 kB -
17oe55cu76cd7.js gzip N/A 450 B -
1dmmbm4sdub-n.js gzip N/A 160 B -
1drww5xikb-c-.js gzip N/A 9.46 kB -
1g60xde_dv17t.js gzip N/A 8.79 kB -
1i8agvlvgn56i.js gzip N/A 155 B -
1q_2qy9pu40_5.js gzip N/A 153 B -
1t5nnab0mb-xk.js gzip N/A 167 B -
1uzv47btzam64.js gzip N/A 5.73 kB -
1vy7n7wxv_rh5.js gzip N/A 8.81 kB -
2_y_gel90e96i.js gzip N/A 153 B -
2-0i7pl900-ou.js gzip N/A 8.71 kB -
2-kcbngm7ik7y.js gzip N/A 8.75 kB -
238feb_ximsbi.js gzip N/A 155 B -
29p5-xa4jmdhg.js gzip N/A 13.7 kB -
2is1q248dqrlh.js gzip N/A 151 B -
2mg811to9eum0.js gzip N/A 155 B -
2nsrcvgnlgkby.js gzip N/A 3.56 kB -
2sxo-ur6g5fuc.js gzip N/A 65.6 kB -
2ugc69z0t0ypz.js gzip N/A 1.46 kB -
36dn8i-_3dnq5.js gzip N/A 10 kB -
3fljpmwcjxqhx.js gzip N/A 10.3 kB -
3gz44skqdlsrb.js gzip N/A 8.71 kB -
3j8es5as0tfa4.js gzip N/A 154 B -
3mycjgbtvwtnm.js gzip N/A 155 B -
3skgwg3_u6i_e.js gzip N/A 13.2 kB -
3y9tus7kb5su0.js gzip N/A 13.3 kB -
4379ebyrlu8xj.js gzip N/A 159 B -
Total 401 kB 401 kB ✅ -7 B

Server

Middleware
Canary PR Change
middleware-b..fest.js gzip 1.06 kB 1.06 kB
Total 1.06 kB 1.06 kB
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 877 B 873 B
Total 877 B 873 B ✅ -4 B
Build Cache
Canary PR Change
00000001.sst gzip 15.8 MB 15.1 MB 🟢 634 kB (-4%)
00000002.sst gzip 13.7 MB 14.1 MB 🔴 +470 kB (+3%)
00000003.sst gzip 13.3 MB 11.5 MB 🟢 1.87 MB (-14%)
00000004.sst gzip 12.8 MB 14.8 MB 🔴 +2.06 MB (+16%)
00000005.sst gzip 10.2 MB 10.2 MB
00000006.sst gzip 2.8 MB 2.8 MB
00000007.sst gzip 59 B 59 B
00000008.meta gzip 89 B 89 B
00000009.meta gzip 298 kB 298 kB
00000010.meta gzip 298 kB 298 kB
00000011.meta gzip 298 kB 298 kB
00000012.sst gzip 51 kB 52.2 kB 🔴 +1.23 kB (+2%)
00000013.sst gzip 1.84 MB 1.77 MB 🟢 63 kB (-3%)
00000014.sst gzip 59 B 59 B
00000015.meta gzip 116 B 116 B
00000016.meta gzip 327 kB 327 kB
00000017.meta gzip 407 kB 405 kB
00000018.sst gzip 51.9 kB 53 kB 🔴 +1.05 kB (+2%)
00000019.sst gzip 1.41 MB 1.41 MB
00000020.sst gzip 59 B 59 B
00000021.meta gzip 116 B 116 B
00000022.meta gzip 327 kB 327 kB
00000023.meta gzip 374 kB 374 kB
00000024.sst gzip 51.9 kB 53 kB 🔴 +1.1 kB (+2%)
00000025.sst gzip 1.41 MB 1.41 MB
00000026.sst gzip 59 B 59 B
00000027.meta gzip 116 B 116 B
00000028.meta gzip 327 kB 327 kB
00000029.meta gzip 374 kB 374 kB
00000030.sst gzip 51 kB 52.3 kB 🔴 +1.36 kB (+3%)
00000031.sst gzip 1.41 MB 1.41 MB
00000032.sst gzip 59 B 59 B
00000033.meta gzip 116 B 116 B
00000034.meta gzip 327 kB 327 kB
00000035.meta gzip 374 kB 374 kB
00000036.sst gzip 51.9 kB 53 kB 🔴 +1.13 kB (+2%)
00000037.sst gzip 1.41 MB 1.41 MB
00000038.sst gzip 59 B 59 B
00000039.meta gzip 116 B 116 B
00000040.meta gzip 327 kB 327 kB
00000041.meta gzip 374 kB 374 kB
CURRENT gzip 92 B 94 B 🔴 +2 B (+2%)
LOG gzip 680 B 660 B 🟢 20 B (-3%)
Total 80.7 MB 80.7 MB ✅ -18.6 kB

📦 Webpack

Client

Main Bundles
Canary PR Change
3322-HASH.js gzip 66.1 kB N/A -
4191.HASH.js gzip 169 B N/A -
7920-HASH.js gzip 4.67 kB N/A -
9784-HASH.js gzip 5.63 kB N/A -
b1ad9f4c-HASH.js gzip 63.5 kB N/A -
framework-HASH.js gzip 59.7 kB 59.7 kB
main-app-HASH.js gzip 253 B 253 B
main-HASH.js gzip 40.2 kB 40.2 kB
webpack-HASH.js gzip 1.68 kB 1.68 kB
3577.HASH.js gzip N/A 168 B -
578-HASH.js gzip N/A 66.3 kB -
8590-HASH.js gzip N/A 5.61 kB -
9750-HASH.js gzip N/A 4.68 kB -
a8984546-HASH.js gzip N/A 63.5 kB -
Total 242 kB 242 kB ⚠️ +68 B
Polyfills
Canary PR Change
polyfills-HASH.js gzip 39.4 kB 39.4 kB
Total 39.4 kB 39.4 kB
Pages
Canary PR Change
_app-HASH.js gzip 194 B 193 B
_error-HASH.js gzip 181 B 182 B
css-HASH.js gzip 334 B 331 B
dynamic-HASH.js gzip 1.81 kB 1.81 kB
edge-ssr-HASH.js gzip 255 B 253 B
head-HASH.js gzip 349 B 351 B
hooks-HASH.js gzip 382 B 384 B
image-HASH.js gzip 581 B 582 B
index-HASH.js gzip 260 B 259 B
link-HASH.js gzip 2.48 kB 2.48 kB
routerDirect..HASH.js gzip 317 B 318 B
script-HASH.js gzip 384 B 386 B
withRouter-HASH.js gzip 316 B 315 B
1afbb74e6ecf..834.css gzip 106 B 106 B
Total 7.95 kB 7.96 kB ⚠️ +4 B

Server

Edge SSR
Canary PR Change
edge-ssr.js gzip 129 kB 129 kB
page.js gzip 294 kB 294 kB
Total 424 kB 423 kB ✅ -798 B
Middleware
Canary PR Change
middleware-b..fest.js gzip 618 B 616 B
middleware-r..fest.js gzip 156 B 156 B
middleware.js gzip 46 kB 45.6 kB
edge-runtime..pack.js gzip 842 B 842 B
Total 47.6 kB 47.2 kB ✅ -406 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 717 B 718 B
Total 717 B 718 B ⚠️ +1 B
Build Cache
Canary PR Change
0.pack gzip 4.83 MB 4.83 MB
index.pack gzip 124 kB 123 kB 🟢 1.27 kB (-1%)
index.pack.old gzip 123 kB 123 kB
Total 5.08 MB 5.07 MB ✅ -3.65 kB

🔄 Shared (bundler-independent)

Runtimes
Canary PR Change
app-page-exp...dev.js gzip 376 kB 376 kB
app-page-exp..prod.js gzip 207 kB 207 kB
app-page-tur...dev.js gzip 375 kB 375 kB
app-page-tur..prod.js gzip 206 kB 206 kB
app-page-tur...dev.js gzip 372 kB 372 kB
app-page-tur..prod.js gzip 204 kB 204 kB
app-page.run...dev.js gzip 372 kB 372 kB
app-page.run..prod.js gzip 204 kB 204 kB
app-route-ex...dev.js gzip 83.2 kB 83.2 kB
app-route-ex..prod.js gzip 56.2 kB 56.2 kB
app-route-tu...dev.js gzip 83.2 kB 83.2 kB
app-route-tu..prod.js gzip 56.2 kB 56.2 kB
app-route-tu...dev.js gzip 82.8 kB 82.8 kB
app-route-tu..prod.js gzip 56 kB 56 kB
app-route.ru...dev.js gzip 82.8 kB 82.8 kB
app-route.ru..prod.js gzip 55.9 kB 55.9 kB
dev-validati...dev.js gzip 134 kB 134 kB
dev-validati...dev.js gzip 134 kB 134 kB
dev-validati...dev.js gzip 132 kB 132 kB
dev-validati...dev.js gzip 132 kB 132 kB
dist_client_...dev.js gzip 324 B 324 B
dist_client_...dev.js gzip 326 B 326 B
dist_client_...dev.js gzip 318 B 318 B
dist_client_...dev.js gzip 317 B 317 B
pages-api-tu...dev.js gzip 46.5 kB 46.5 kB
pages-api-tu..prod.js gzip 34.7 kB 34.7 kB
pages-api.ru...dev.js gzip 46.5 kB 46.5 kB
pages-api.ru..prod.js gzip 34.7 kB 34.7 kB
pages-turbo....dev.js gzip 55.3 kB 55.3 kB
pages-turbo...prod.js gzip 40.2 kB 40.2 kB
pages.runtim...dev.js gzip 55.3 kB 55.3 kB
pages.runtim..prod.js gzip 40.2 kB 40.2 kB
server.runti..prod.js gzip 66.6 kB 66.6 kB
use-cache-pr...dev.js gzip 72.7 kB 72.7 kB
use-cache-pr...dev.js gzip 72.7 kB 72.7 kB
use-cache-pr...dev.js gzip 70.9 kB 70.9 kB
use-cache-pr...dev.js gzip 70.9 kB 70.9 kB
Total 4.11 MB 4.11 MB ✅ -4 B
📎 Tarball URL
https://vercel-packages.vercel.app/next/commits/815d285a1cceb933f77e1e1566d3dd4b96de611b/next

Commit: 815d285

@github-actions

github-actions Bot commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

Tests Passed

Commit: 815d285

@DavidIlie
DavidIlie force-pushed the codex/websocket-tracing-prerequisite branch 2 times, most recently from 6e5d71e to 8d5f674 Compare August 10, 2026 16:29
@DavidIlie
DavidIlie force-pushed the codex/websocket-tracing-prerequisite branch from 8d5f674 to 815d285 Compare August 17, 2026 13:00
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