Refer to instrumentation-client.ts instead of sentry.client.config.ts for Next.js

[lforst]

We changed what file we want users to create for client instrumentation because Next.js added the instrumentation-client.ts hook as a native mechanism.

I thought of doing versioned docs but that is a huge pain in the butt for all of the places we have the client config. The SDK logs a warning to migrate you from sentry.client.config.ts to instrumentation-client.ts in any case.

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
sentry-docs	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Apr 9, 2025 0:00am

2 Skipped Deployments

Name	Status	Preview	Comments	Updated (UTC)
changelog	⬜️ Ignored (Inspect)	Visit Preview		Apr 9, 2025 0:00am
develop-docs	⬜️ Ignored (Inspect)	Visit Preview		Apr 9, 2025 0:00am

[codecov]

Bundle Report

Changes will decrease total bundle size by 15 bytes (-0.0%) ⬇️. This is within the configured threshold ✅

Detailed changes

Bundle name	Size	Change
sentry-docs-server-cjs	11.13MB	-9 bytes (-0.0%) ⬇️
sentry-docs-client-array-push	9.47MB	-6 bytes (-0.0%) ⬇️

Affected Assets, Files, and Routes:

view changes for bundle: sentry-docs-client-array-push

Assets Changed:

Asset Name	Size Change	Total Size	Change (%)
static/chunks/pages/_app-*.js	-3 bytes	868.7kB	-0.0%
static/chunks/8165-*.js	-3 bytes	410.1kB	-0.0%
server/middleware-*.js	5.55kB	6.55kB	555.3% ⚠️
server/middleware-*.js	-5.55kB	1.0kB	-84.74%
static/rmmjBYONpq65h9AJYWFCd/_buildManifest.js (New)	578 bytes	578 bytes	100.0% 🚀
static/rmmjBYONpq65h9AJYWFCd/_ssgManifest.js (New)	77 bytes	77 bytes	100.0% 🚀
static/2ggWBO4-*.js (Deleted)	-77 bytes	0 bytes	-100.0% 🗑️
static/2ggWBO4-*.js (Deleted)	-578 bytes	0 bytes	-100.0% 🗑️

view changes for bundle: sentry-docs-server-cjs

Assets Changed:

Asset Name	Size Change	Total Size	Change (%)
1729.js	-3 bytes	1.75MB	-0.0%
../instrumentation.js	-3 bytes	1.08MB	-0.0%
9523.js	-3 bytes	1.05MB	-0.0%

[mydea]

Just to be clear/sure, this also works for older next.js versions I suppose?

[lforst]

Just to be clear/sure, this also works for older next.js versions I suppose?

Yes, the SDK "backfills" the feature for older nextjs versions by creating a webpack entrypoint for "client-instrumentation.ts". That is our migration path.