Skip to content

Add MemorySample to Turbopack trace infrastructure#90597

Draft
sokra wants to merge 2 commits intocanaryfrom
sokra/trace-mem
Draft

Add MemorySample to Turbopack trace infrastructure#90597
sokra wants to merge 2 commits intocanaryfrom
sokra/trace-mem

Conversation

@sokra
Copy link
Member

@sokra sokra commented Feb 26, 2026

What?

Adds periodic process memory sampling to the Turbopack trace system.

Two new capabilities:

  1. TraceRow::MemorySample — A new trace row variant that captures TurboMalloc::memory_usage() at ~10ms intervals
  2. memory_samples in QueryResult — When querying a span, returns up to 200 memory usage samples covering the span's time range

Why?

To provide visibility into process memory usage over time in the Turbopack trace viewer. Currently the trace system tracks per-span allocations/deallocations but has no global memory usage timeline.

How?

Sampling (turbopack-trace-utils):

  • New TraceRow::MemorySample { ts, memory } variant
  • Sampling triggered from on_enter using a three-tier dedup strategy to minimize overhead:
    1. Thread-local check (no synchronization)
    2. Global atomic read (single load)
    3. CAS to claim the sample (only one thread wins per interval)
  • This ensures at most one sample per 10ms across all threads

Storage (turbopack-trace-server):

  • Global sorted Vec<(Timestamp, u64)> in the Store
  • Insertion-sort step on add (efficient since samples arrive nearly sorted)
  • Binary search for range queries

Query (turbopack-trace-server):

  • memory_samples_for_range(start, end) returns up to 200 samples
  • When more exist, merges groups of N by taking the max value per group
  • Added memory_samples: Vec<u64> field to QueryResult

Captures TurboMalloc::memory_usage() at ~10ms intervals from on_enter,
using a three-tier dedup strategy (thread-local → global atomic → CAS)
to minimize overhead in hot paths.
Store all MemorySample trace rows in a sorted list in the Store.
When a span is queried, return up to 200 memory samples covering
the span's [start, end] range. When more samples exist, merge
groups of N by taking the max memory value per group.
@nextjs-bot nextjs-bot added created-by: Turbopack team PRs by the Turbopack team. Turbopack Related to Turbopack with Next.js. labels Feb 26, 2026
@codspeed-hq
Copy link

codspeed-hq bot commented Feb 26, 2026

Merging this PR will not alter performance

✅ 17 untouched benchmarks
⏩ 3 skipped benchmarks1


Comparing sokra/trace-mem (a4b3dfe) with canary (d1601a1)

Open in CodSpeed

Footnotes

  1. 3 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports.

@nextjs-bot
Copy link
Collaborator

Stats from current PR

✅ No significant changes detected

📊 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) 455ms 456ms ▁▁▁▁▁
Cold (Ready in log) 439ms 438ms ▂▂▂▂▂
Cold (First Request) 1.228s 1.252s ▄▄▄▄▄
Warm (Listen) 457ms 457ms ▁▁▁▁▁
Warm (Ready in log) 444ms 444ms ▁▁▁▁▁
Warm (First Request) 353ms 350ms ▁▁▂▁▂
📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric Canary PR Change Trend
Cold (Listen) 560ms 558ms █▁▁█▁
Cold (Ready in log) 550ms 545ms ▆▅▆▆▁
Cold (First Request) 2.571s 2.590s ▄▃▅▄▁
Warm (Listen) 558ms 559ms ▅▅▅▅▅
Warm (Ready in log) 547ms 547ms ▇▅█▅▁
Warm (First Request) 2.662s 2.629s ▄▃▅▃▁

⚡ Production Builds

Metric Canary PR Change Trend
Fresh Build 3.914s 3.952s ▁▁▁▁▁
Cached Build 3.960s 3.974s ▁▁▁▁▁
📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric Canary PR Change Trend
Fresh Build 18.254s 18.203s ▂▁▂▂▂
Cached Build 18.341s 18.371s ▂▁▁▁▃
node_modules Size 475 MB 475 MB ▁▁▁▁▁
📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles: **400 kB** → **400 kB** ✅ -13 B

80 files with content-based hashes (individual files not comparable between builds)

Server

Middleware
Canary PR Change
middleware-b..fest.js gzip 764 B 764 B
Total 764 B 764 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 451 B 452 B
Total 451 B 452 B ⚠️ +1 B

📦 Webpack

Client

Main Bundles
Canary PR Change
5528-HASH.js gzip 5.54 kB N/A -
6280-HASH.js gzip 58.3 kB N/A -
6335.HASH.js gzip 169 B N/A -
912-HASH.js gzip 4.59 kB N/A -
e8aec2e4-HASH.js gzip 62.6 kB N/A -
framework-HASH.js gzip 59.7 kB 59.7 kB
main-app-HASH.js gzip 255 B 255 B
main-HASH.js gzip 39.1 kB 39.1 kB
webpack-HASH.js gzip 1.68 kB 1.68 kB
262-HASH.js gzip N/A 4.59 kB -
2889.HASH.js gzip N/A 169 B -
5602-HASH.js gzip N/A 5.55 kB -
6948ada0-HASH.js gzip N/A 62.6 kB -
9544-HASH.js gzip N/A 59 kB -
Total 232 kB 233 kB ⚠️ +721 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 194 B
_error-HASH.js gzip 183 B 180 B 🟢 3 B (-2%)
css-HASH.js gzip 331 B 330 B
dynamic-HASH.js gzip 1.81 kB 1.81 kB
edge-ssr-HASH.js gzip 256 B 256 B
head-HASH.js gzip 351 B 352 B
hooks-HASH.js gzip 384 B 383 B
image-HASH.js gzip 580 B 581 B
index-HASH.js gzip 260 B 260 B
link-HASH.js gzip 2.5 kB 2.5 kB
routerDirect..HASH.js gzip 320 B 319 B
script-HASH.js gzip 386 B 386 B
withRouter-HASH.js gzip 315 B 315 B
1afbb74e6ecf..834.css gzip 106 B 106 B
Total 7.97 kB 7.97 kB ✅ -2 B

Server

Edge SSR
Canary PR Change
edge-ssr.js gzip 125 kB 125 kB
page.js gzip 254 kB 254 kB
Total 379 kB 379 kB ⚠️ +324 B
Middleware
Canary PR Change
middleware-b..fest.js gzip 616 B 612 B
middleware-r..fest.js gzip 156 B 155 B
middleware.js gzip 43.5 kB 43.6 kB
edge-runtime..pack.js gzip 842 B 842 B
Total 45.1 kB 45.2 kB ⚠️ +108 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 715 B 718 B
Total 715 B 718 B ⚠️ +3 B
Build Cache
Canary PR Change
0.pack gzip 4.02 MB 4.02 MB
index.pack gzip 103 kB 102 kB
index.pack.old gzip 103 kB 103 kB
Total 4.23 MB 4.23 MB ⚠️ +464 B

🔄 Shared (bundler-independent)

Runtimes
Canary PR Change
app-page-exp...dev.js gzip 320 kB 320 kB
app-page-exp..prod.js gzip 170 kB 170 kB
app-page-tur...dev.js gzip 319 kB 319 kB
app-page-tur..prod.js gzip 169 kB 169 kB
app-page-tur...dev.js gzip 316 kB 316 kB
app-page-tur..prod.js gzip 168 kB 168 kB
app-page.run...dev.js gzip 316 kB 316 kB
app-page.run..prod.js gzip 168 kB 168 kB
app-route-ex...dev.js gzip 70.8 kB 70.8 kB
app-route-ex..prod.js gzip 49.2 kB 49.2 kB
app-route-tu...dev.js gzip 70.8 kB 70.8 kB
app-route-tu..prod.js gzip 49.2 kB 49.2 kB
app-route-tu...dev.js gzip 70.4 kB 70.4 kB
app-route-tu..prod.js gzip 49 kB 49 kB
app-route.ru...dev.js gzip 70.4 kB 70.4 kB
app-route.ru..prod.js gzip 49 kB 49 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 43.2 kB 43.2 kB
pages-api-tu..prod.js gzip 32.9 kB 32.9 kB
pages-api.ru...dev.js gzip 43.2 kB 43.2 kB
pages-api.ru..prod.js gzip 32.8 kB 32.8 kB
pages-turbo....dev.js gzip 52.5 kB 52.5 kB
pages-turbo...prod.js gzip 38.5 kB 38.5 kB
pages.runtim...dev.js gzip 52.5 kB 52.5 kB
pages.runtim..prod.js gzip 38.4 kB 38.4 kB
server.runti..prod.js gzip 62 kB 62 kB
Total 2.82 MB 2.82 MB ✅ -3 B
📎 Tarball URL
next@https://vercel-packages.vercel.app/next/prs/90597/next

@sokra sokra requested a review from lukesandberg February 26, 2026 17:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

created-by: Turbopack team PRs by the Turbopack team. Turbopack Related to Turbopack with Next.js.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants