From a068848c9866ace174eab0ccf7df4b1ecac61fec Mon Sep 17 00:00:00 2001 From: Onur Temizkan Date: Fri, 20 Feb 2026 13:23:58 +0000 Subject: [PATCH 1/6] feat(remix): Add Server-Timing header trace propagation --- .../remix-hydrogen/app/entry.server.tsx | 10 +- .../tests/server-timing-header.test.ts | 17 +++ .../remix-server-timing/.eslintrc.js | 4 + .../remix-server-timing/.gitignore | 3 + .../remix-server-timing/.npmrc | 2 + .../remix-server-timing/app/entry.client.tsx | 44 ++++++ .../remix-server-timing/app/entry.server.tsx | 115 +++++++++++++++ .../remix-server-timing/app/root.tsx | 63 +++++++++ .../remix-server-timing/app/routes/_index.tsx | 28 ++++ .../app/routes/redirect-test.tsx | 5 + .../app/routes/user.$id.tsx | 19 +++ .../remix-server-timing/globals.d.ts | 2 + .../remix-server-timing/instrument.server.cjs | 8 ++ .../remix-server-timing/package.json | 42 ++++++ .../remix-server-timing/playwright.config.mjs | 8 ++ .../remix-server-timing/remix.env.d.ts | 2 + .../remix-server-timing/start-event-proxy.mjs | 6 + .../server-timing-trace-propagation.test.ts | 73 ++++++++++ .../remix-server-timing/tsconfig.json | 23 +++ .../remix-server-timing/vite.config.ts | 15 ++ packages/remix/src/cloudflare/index.ts | 1 + packages/remix/src/server/index.ts | 1 + packages/remix/src/server/instrumentServer.ts | 48 +++++-- .../server/serverTimingTracePropagation.ts | 77 ++++++++++ packages/remix/src/utils/utils.ts | 6 + .../serverTimingTracePropagation.test.ts | 131 ++++++++++++++++++ 26 files changed, 739 insertions(+), 14 deletions(-) create mode 100644 dev-packages/e2e-tests/test-applications/remix-hydrogen/tests/server-timing-header.test.ts create mode 100644 dev-packages/e2e-tests/test-applications/remix-server-timing/.eslintrc.js create mode 100644 dev-packages/e2e-tests/test-applications/remix-server-timing/.gitignore create mode 100644 dev-packages/e2e-tests/test-applications/remix-server-timing/.npmrc create mode 100644 dev-packages/e2e-tests/test-applications/remix-server-timing/app/entry.client.tsx create mode 100644 dev-packages/e2e-tests/test-applications/remix-server-timing/app/entry.server.tsx create mode 100644 dev-packages/e2e-tests/test-applications/remix-server-timing/app/root.tsx create mode 100644 dev-packages/e2e-tests/test-applications/remix-server-timing/app/routes/_index.tsx create mode 100644 dev-packages/e2e-tests/test-applications/remix-server-timing/app/routes/redirect-test.tsx create mode 100644 dev-packages/e2e-tests/test-applications/remix-server-timing/app/routes/user.$id.tsx create mode 100644 dev-packages/e2e-tests/test-applications/remix-server-timing/globals.d.ts create mode 100644 dev-packages/e2e-tests/test-applications/remix-server-timing/instrument.server.cjs create mode 100644 dev-packages/e2e-tests/test-applications/remix-server-timing/package.json create mode 100644 dev-packages/e2e-tests/test-applications/remix-server-timing/playwright.config.mjs create mode 100644 dev-packages/e2e-tests/test-applications/remix-server-timing/remix.env.d.ts create mode 100644 dev-packages/e2e-tests/test-applications/remix-server-timing/start-event-proxy.mjs create mode 100644 dev-packages/e2e-tests/test-applications/remix-server-timing/tests/server-timing-trace-propagation.test.ts create mode 100644 dev-packages/e2e-tests/test-applications/remix-server-timing/tsconfig.json create mode 100644 dev-packages/e2e-tests/test-applications/remix-server-timing/vite.config.ts create mode 100644 packages/remix/src/server/serverTimingTracePropagation.ts create mode 100644 packages/remix/test/server/serverTimingTracePropagation.test.ts diff --git a/dev-packages/e2e-tests/test-applications/remix-hydrogen/app/entry.server.tsx b/dev-packages/e2e-tests/test-applications/remix-hydrogen/app/entry.server.tsx index afae990db239..1db0c9e23207 100644 --- a/dev-packages/e2e-tests/test-applications/remix-hydrogen/app/entry.server.tsx +++ b/dev-packages/e2e-tests/test-applications/remix-hydrogen/app/entry.server.tsx @@ -1,4 +1,5 @@ import { RemixServer } from '@remix-run/react'; +import { generateSentryServerTimingHeader } from '@sentry/remix/cloudflare'; import { createContentSecurityPolicy } from '@shopify/hydrogen'; import type { EntryContext } from '@shopify/remix-oxygen'; import isbot from 'isbot'; @@ -43,8 +44,15 @@ export default async function handleRequest( // This is required for Sentry's profiling integration responseHeaders.set('Document-Policy', 'js-profiling'); - return new Response(body, { + const response = new Response(body, { headers: responseHeaders, status: responseStatusCode, }); + + const serverTimingValue = generateSentryServerTimingHeader(); + if (serverTimingValue) { + response.headers.append('Server-Timing', serverTimingValue); + } + + return response; } diff --git a/dev-packages/e2e-tests/test-applications/remix-hydrogen/tests/server-timing-header.test.ts b/dev-packages/e2e-tests/test-applications/remix-hydrogen/tests/server-timing-header.test.ts new file mode 100644 index 000000000000..194afa2fa0a4 --- /dev/null +++ b/dev-packages/e2e-tests/test-applications/remix-hydrogen/tests/server-timing-header.test.ts @@ -0,0 +1,17 @@ +import { expect, test } from '@playwright/test'; + +test('Server-Timing header contains sentry-trace on page load', async ({ page }) => { + const responsePromise = page.waitForResponse( + response => + response.url().endsWith('/') && response.status() === 200 && response.request().resourceType() === 'document', + ); + + await page.goto('/'); + + const response = await responsePromise; + const serverTimingHeader = response.headers()['server-timing']; + + expect(serverTimingHeader).toBeDefined(); + expect(serverTimingHeader).toContain('sentry-trace'); + expect(serverTimingHeader).toContain('baggage'); +}); diff --git a/dev-packages/e2e-tests/test-applications/remix-server-timing/.eslintrc.js b/dev-packages/e2e-tests/test-applications/remix-server-timing/.eslintrc.js new file mode 100644 index 000000000000..f2faf1470fd8 --- /dev/null +++ b/dev-packages/e2e-tests/test-applications/remix-server-timing/.eslintrc.js @@ -0,0 +1,4 @@ +/** @type {import('eslint').Linter.Config} */ +module.exports = { + extends: ['@remix-run/eslint-config', '@remix-run/eslint-config/node'], +}; diff --git a/dev-packages/e2e-tests/test-applications/remix-server-timing/.gitignore b/dev-packages/e2e-tests/test-applications/remix-server-timing/.gitignore new file mode 100644 index 000000000000..a735ebed5b56 --- /dev/null +++ b/dev-packages/e2e-tests/test-applications/remix-server-timing/.gitignore @@ -0,0 +1,3 @@ +node_modules +build +.env diff --git a/dev-packages/e2e-tests/test-applications/remix-server-timing/.npmrc b/dev-packages/e2e-tests/test-applications/remix-server-timing/.npmrc new file mode 100644 index 000000000000..070f80f05092 --- /dev/null +++ b/dev-packages/e2e-tests/test-applications/remix-server-timing/.npmrc @@ -0,0 +1,2 @@ +@sentry:registry=http://127.0.0.1:4873 +@sentry-internal:registry=http://127.0.0.1:4873 diff --git a/dev-packages/e2e-tests/test-applications/remix-server-timing/app/entry.client.tsx b/dev-packages/e2e-tests/test-applications/remix-server-timing/app/entry.client.tsx new file mode 100644 index 000000000000..85c29d310c1a --- /dev/null +++ b/dev-packages/e2e-tests/test-applications/remix-server-timing/app/entry.client.tsx @@ -0,0 +1,44 @@ +/** + * By default, Remix will handle hydrating your app on the client for you. + * You are free to delete this file if you'd like to, but if you ever want it revealed again, you can run `npx remix reveal` + * For more information, see https://remix.run/file-conventions/entry.client + */ + +// Extend the Window interface to include ENV +declare global { + interface Window { + ENV: { + SENTRY_DSN: string; + [key: string]: unknown; + }; + } +} + +import { RemixBrowser, useLocation, useMatches } from '@remix-run/react'; +import * as Sentry from '@sentry/remix'; +import { StrictMode, startTransition, useEffect } from 'react'; +import { hydrateRoot } from 'react-dom/client'; + +Sentry.init({ + environment: 'qa', // dynamic sampling bias to keep transactions + dsn: window.ENV.SENTRY_DSN, + integrations: [ + Sentry.browserTracingIntegration({ + useEffect, + useLocation, + useMatches, + }), + ], + // Performance Monitoring + tracesSampleRate: 1.0, // Capture 100% of the transactions + tunnel: 'http://localhost:3031/', // proxy server +}); + +startTransition(() => { + hydrateRoot( + document, + + + , + ); +}); diff --git a/dev-packages/e2e-tests/test-applications/remix-server-timing/app/entry.server.tsx b/dev-packages/e2e-tests/test-applications/remix-server-timing/app/entry.server.tsx new file mode 100644 index 000000000000..3eb9423dff22 --- /dev/null +++ b/dev-packages/e2e-tests/test-applications/remix-server-timing/app/entry.server.tsx @@ -0,0 +1,115 @@ +import * as Sentry from '@sentry/remix'; + +import { PassThrough } from 'node:stream'; + +import type { AppLoadContext, EntryContext } from '@remix-run/node'; +import { createReadableStreamFromReadable } from '@remix-run/node'; +import { installGlobals } from '@remix-run/node'; +import { RemixServer } from '@remix-run/react'; +import isbot from 'isbot'; +import { renderToPipeableStream } from 'react-dom/server'; + +installGlobals(); + +const ABORT_DELAY = 5_000; + +export const handleError = Sentry.sentryHandleError; + +export default function handleRequest( + request: Request, + responseStatusCode: number, + responseHeaders: Headers, + remixContext: EntryContext, + // eslint-disable-next-line @typescript-eslint/no-unused-vars + loadContext: AppLoadContext, +) { + return isbot(request.headers.get('user-agent')) + ? handleBotRequest(request, responseStatusCode, responseHeaders, remixContext) + : handleBrowserRequest(request, responseStatusCode, responseHeaders, remixContext); +} + +function handleBotRequest( + request: Request, + responseStatusCode: number, + responseHeaders: Headers, + remixContext: EntryContext, +) { + return new Promise((resolve, reject) => { + let shellRendered = false; + const { pipe, abort } = renderToPipeableStream( + , + { + onAllReady() { + shellRendered = true; + const body = new PassThrough(); + const stream = createReadableStreamFromReadable(body); + + responseHeaders.set('Content-Type', 'text/html'); + + resolve( + new Response(stream, { + headers: responseHeaders, + status: responseStatusCode, + }), + ); + + pipe(body); + }, + onShellError(error: unknown) { + reject(error); + }, + onError(error: unknown) { + responseStatusCode = 500; + if (shellRendered) { + console.error(error); + } + }, + }, + ); + + setTimeout(abort, ABORT_DELAY); + }); +} + +function handleBrowserRequest( + request: Request, + responseStatusCode: number, + responseHeaders: Headers, + remixContext: EntryContext, +) { + return new Promise((resolve, reject) => { + let shellRendered = false; + const { pipe, abort } = renderToPipeableStream( + , + { + onShellReady() { + shellRendered = true; + const body = new PassThrough(); + const stream = createReadableStreamFromReadable(body); + + responseHeaders.set('Content-Type', 'text/html'); + + resolve( + new Response(stream, { + headers: responseHeaders, + status: responseStatusCode, + }), + ); + + pipe(body); + }, + onShellError(error: unknown) { + reject(error); + }, + onError(error: unknown) { + responseStatusCode = 500; + if (shellRendered) { + console.error(error); + } + }, + }, + ); + + setTimeout(abort, ABORT_DELAY); + }); +} diff --git a/dev-packages/e2e-tests/test-applications/remix-server-timing/app/root.tsx b/dev-packages/e2e-tests/test-applications/remix-server-timing/app/root.tsx new file mode 100644 index 000000000000..beb9fdb70357 --- /dev/null +++ b/dev-packages/e2e-tests/test-applications/remix-server-timing/app/root.tsx @@ -0,0 +1,63 @@ +import { cssBundleHref } from '@remix-run/css-bundle'; +import { LinksFunction, json } from '@remix-run/node'; +import { + Links, + LiveReload, + Meta, + Outlet, + Scripts, + ScrollRestoration, + useLoaderData, + useRouteError, +} from '@remix-run/react'; +import { captureRemixErrorBoundaryError, withSentry } from '@sentry/remix'; + +export const links: LinksFunction = () => [...(cssBundleHref ? [{ rel: 'stylesheet', href: cssBundleHref }] : [])]; + +export const loader = () => { + return json({ + ENV: { + SENTRY_DSN: process.env.E2E_TEST_DSN, + }, + }); +}; + +export function ErrorBoundary() { + const error = useRouteError(); + const eventId = captureRemixErrorBoundaryError(error); + + return ( +
+ ErrorBoundary Error + {eventId} +
+ ); +} + +function App() { + const { ENV } = useLoaderData() as { ENV: { SENTRY_DSN: string } }; + + return ( + + + + +