feat: Add http.route attribute to http.server spans with parameterized routes

dev-packages/e2e-tests/test-applications/create-remix-app-express/tests/server-transactions.test.ts

@@ -14,6 +14,7 @@ test('Sends parameterized transaction name to Sentry', async ({ page }) => {
 
  expect(transaction).toBeDefined();
  expect(transaction.transaction).toBe('GET user/:id');
+ expect(transaction.contexts?.trace?.data?.['http.route']).toBe('user/:id');
 });
 
 test('Sends form data with action span', async ({ page }) => {
@@ -271,6 +272,7 @@ test('Sends two linked transactions (server & client) to Sentry', async ({ page
  const pageLoadParentSpanId = pageloadTransaction.contexts?.trace?.parent_span_id;
 
  expect(httpServerTransaction.transaction).toBe('GET http://localhost:3030/');
+ expect(httpServerTransaction.contexts?.trace?.data?.['http.route']).toBeUndefined();
  expect(pageloadTransaction.transaction).toBe('/');
 
  expect(httpServerTraceId).toBeDefined();

dev-packages/e2e-tests/test-applications/nextjs-orpc/tests/orpc-tracing.test.ts

@@ -42,7 +42,7 @@ test('should trace orpc server component', async ({ page }) => {
  'http.method': 'POST',
  'http.target': '/rpc/planet/list',
  'next.rsc': false,
- 'http.route': '/rpc/[[...rest]]/route',
+ 'http.route': '/rpc/[[...rest]]',
  'next.route': '/rpc/[[...rest]]',
  'http.status_code': 200,
  },
@@ -99,7 +99,7 @@ test('should trace orpc client component', async ({ page }) => {
  'http.method': 'POST',
  'http.target': '/rpc/planet/find',
  'next.rsc': false,
- 'http.route': '/rpc/[[...rest]]/route',
+ 'http.route': '/rpc/[[...rest]]',
  'next.route': '/rpc/[[...rest]]',
  'http.status_code': 200,
  },

packages/elysia/src/withElysia.ts

@@ -1,4 +1,4 @@
-import { URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 import type { Span } from '@sentry/core';
 import {
  captureException,
@@ -60,18 +60,24 @@ const instrumentedApps = new WeakSet<Elysia>();
 function updateRouteTransactionName(request: Request, method: string, route: string): void {
  const transactionName = `${method} ${route}`;
 
+ function applyRouteToSpan(span: Span): void {
+ updateSpanName(span, transactionName);
+ span.setAttributes({
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [HTTP_ROUTE]: route,
+ });
+ }
+
  // Try the stored root span first (reliable across async contexts),
  // then fall back to getActiveSpan() for cases where async context is preserved.
  const rootSpan = rootSpanForRequest.get(request);
  if (rootSpan) {
- updateSpanName(rootSpan, transactionName);
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
+ applyRouteToSpan(rootSpan);
  } else {
  const activeSpan = getActiveSpan();
  if (activeSpan) {
  const root = getRootSpan(activeSpan);
- updateSpanName(root, transactionName);
- root.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
+ applyRouteToSpan(root);
  }
  }
 

packages/elysia/test/withElysia.test.ts

@@ -1,3 +1,4 @@
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 import type { ErrorContext } from 'elysia';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
@@ -32,6 +33,12 @@ const mockGetIsolationScope = vi.fn(() => ({
 const mockGetClient = vi.fn(() => ({
  on: vi.fn(),
 }));
+const mockRootSpan = {
+ setAttributes: vi.fn(),
+ updateName: vi.fn(),
+};
+const mockGetActiveSpan = vi.fn();
+const mockGetRootSpan = vi.fn(() => mockRootSpan);
 const mockGetTraceData = vi.fn(() => ({
  'sentry-trace': 'abc123-def456-1',
  baggage: 'sentry-environment=test,sentry-trace_id=abc123',
@@ -43,8 +50,10 @@ vi.mock('@sentry/core', async importActual => {
  return {
  ...actual,
  captureException: (...args: unknown[]) => mockCaptureException(...args),
+ getActiveSpan: () => mockGetActiveSpan(),
  getIsolationScope: () => mockGetIsolationScope(),
  getClient: () => mockGetClient(),
+ getRootSpan: () => mockGetRootSpan(),
  getTraceData: () => mockGetTraceData(),
  };
 });
@@ -88,6 +97,23 @@ describe('withElysia', () => {
  expect(headers['baggage']).toBe('sentry-environment=test,sentry-trace_id=abc123');
  });
 
+ it('sets the matched route on the root span', () => {
+ mockGetActiveSpan.mockReturnValueOnce(mockRootSpan);
+ // @ts-expect-error - mock app
+ withElysia(mockApp);
+
+ onAfterHandleHandler({
+ route: '/users/:id',
+ request: new Request('https://example.com/users/42', { method: 'GET' }),
+ set: { headers: {} },
+ });
+
+ expect(mockRootSpan.setAttributes).toHaveBeenCalledWith({
+ 'sentry.source': 'route',
+ [HTTP_ROUTE]: '/users/:id',
+ });
+ });
+
  it('does not set headers when trace data is empty', () => {
  mockGetTraceData.mockReturnValueOnce({});
  // @ts-expect-error - mock app

packages/hono/package.json

@@ -73,7 +73,8 @@
  },
  "dependencies": {
  "@opentelemetry/api": "^1.9.1",
- "@sentry/core": "10.67.0"
+ "@sentry/core": "10.67.0",
+ "@sentry/conventions": "^0.16.0"
  },
  "peerDependencies": {
  "@cloudflare/workers-types": "^4.x",

packages/hono/src/shared/middlewareHandlers.ts

@@ -15,6 +15,7 @@ import { defaultShouldHandleError } from './defaultShouldHandleError';
 import { resolveRouteName } from './resolveRouteName';
 import { type SentryHonoMiddlewareOptions } from '../shared/types';
 import { type GetConnInfo } from 'hono/conninfo';
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 
 /**
  * Request handler for Hono framework
@@ -99,7 +100,8 @@ export function responseHandler(
 }
 
 function updateSpanRouteName(isolationScope: Scope, context: Context): void {
- const routeName = `${context.req.method} ${resolveRouteName(context)}`;
+ const route = resolveRouteName(context);
+ const routeName = `${context.req.method} ${route}`;
  const activeSpan = getActiveSpan();
 
  if (activeSpan) {
@@ -108,7 +110,10 @@ function updateSpanRouteName(isolationScope: Scope, context: Context): void {
 
  const rootSpan = getRootSpan(activeSpan);
  updateSpanName(rootSpan, routeName);
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
+ rootSpan.setAttributes({
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [HTTP_ROUTE]: route,
+ });
  }
 
  isolationScope.setTransactionName(routeName);

packages/hono/test/shared/middlewareHandlers.test.ts

@@ -1,4 +1,5 @@
 import * as SentryCore from '@sentry/core';
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 import { requestHandler, responseHandler } from '../../src/shared/middlewareHandlers';
 
@@ -245,6 +246,18 @@ describe('responseHandler', () => {
 
  expect(mockSetTransactionName).toHaveBeenCalledWith('GET /test');
  });
+
+ it('sets http.route on the root span', () => {
+ getActiveSpanMock.mockReturnValue(mockRootSpan);
+
+ // oxlint-disable-next-line typescript/no-explicit-any
+ requestHandler(createMockContext(200) as any);
+
+ expect(mockRootSpan.setAttributes).toHaveBeenCalledWith({
+ 'sentry.source': 'route',
+ [HTTP_ROUTE]: '/test',
+ });
+ });
  });
 });
 

packages/nextjs/src/common/pages-router-instrumentation/wrapApiHandlerWithSentry.ts

@@ -18,7 +18,7 @@ import type { NextApiRequest } from 'next';
 import type { AugmentedNextApiResponse, NextApiHandler } from '../types';
 import { flushSafelyWithTimeout, waitUntil } from '../utils/responseEnd';
 import { dropNextjsRootContext, escapeNextjsTracing } from '../utils/tracingUtils';
-import { SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 
 export type AugmentedNextApiRequest = NextApiRequest & {
  __withSentry_applied__?: boolean;
@@ -95,6 +95,7 @@ export function wrapApiHandlerWithSentry(apiHandler: NextApiHandler, parameteriz
  [SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.http.nextjs',
  [URL_FULL]: urlObject && !isURLObjectRelative(urlObject) ? urlObject.href : undefined,
  [URL_PATH]: urlObject?.pathname,
+ [HTTP_ROUTE]: parameterizedRoute,
  },
  },
  async span => {

packages/nextjs/src/common/wrapRouteHandlerWithSentry.ts

@@ -20,6 +20,7 @@ import { isNotFoundNavigationError, isRedirectNavigationError } from './nextNavi
 import type { RouteHandlerContext } from './types';
 import { flushSafelyWithTimeout, waitUntil } from './utils/responseEnd';
 import { commonObjectToIsolationScope } from './utils/tracingUtils';
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 
 /**
  * Wraps a Next.js App Router Route handler with Sentry error and performance instrumentation.
@@ -47,8 +48,11 @@ export function wrapRouteHandlerWithSentry<F extends (...args: any[]) => any>(
  edgeRuntimeIsolationScopeOverride = isolationScope;
 
  rootSpan.updateName(`${method} ${parameterizedRoute}`);
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_OP, 'http.server');
+ rootSpan.setAttributes({
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [SEMANTIC_ATTRIBUTE_SENTRY_OP]: 'http.server',
+ [HTTP_ROUTE]: parameterizedRoute,
+ });
  }
 
  return withIsolationScope(

packages/nextjs/src/edge/wrapApiHandlerWithSentry.ts

@@ -18,7 +18,7 @@ import {
 import { addHeadersAsAttributes } from '../common/utils/addHeadersAsAttributes';
 import { flushSafelyWithTimeout, waitUntil } from '../common/utils/responseEnd';
 import type { EdgeRouteHandler } from './types';
-import { SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 
 /**
  * Wraps a Next.js edge route handler with Sentry error and performance instrumentation.
@@ -75,6 +75,7 @@ export function wrapApiHandlerWithSentry<H extends EdgeRouteHandler>(
  [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
  [URL_FULL]: rootSpanAttributes[URL_FULL] ?? urlAttributes[URL_FULL],
  [URL_PATH]: rootSpanAttributes[URL_PATH] ?? urlAttributes[URL_PATH],
+ [HTTP_ROUTE]: parameterizedRoute,
  ...headerAttributes,
  });
  setCapturedScopesOnSpan(rootSpan, currentScope, isolationScope);
@@ -93,6 +94,7 @@ export function wrapApiHandlerWithSentry<H extends EdgeRouteHandler>(
  [SENTRY_KIND]: 'server',
  [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
  [SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.function.nextjs.wrap_api_handler',
+ [HTTP_ROUTE]: parameterizedRoute,
  ...urlAttributes,
  ...headerAttributes,
  },

packages/nextjs/src/server/enhanceHandleRequestRootSpan.ts

@@ -47,6 +47,7 @@ export function enhanceHandleRequestRootSpan(span: MutableRootSpan): void {
  const cleanRoute = route.replace(/\/route$/, '');
  span.setName(`${method} ${cleanRoute}`);
  attributes[SEMANTIC_ATTRIBUTE_SENTRY_SOURCE] = 'route';
+ attributes[HTTP_ROUTE] = cleanRoute;
  // Preserve next.route in case it did not get hoisted
  attributes[ATTR_NEXT_ROUTE] = cleanRoute;
  }
@@ -55,6 +56,7 @@ export function enhanceHandleRequestRootSpan(span: MutableRootSpan): void {
  const routeBackfill = attributes[TRANSACTION_ATTR_SENTRY_ROUTE_BACKFILL];
  if (typeof routeBackfill === 'string' && span.getName() !== 'GET /_app') {
  span.setName(`${typeof method === 'string' ? method : 'GET'} ${routeBackfill}`);
+ attributes[HTTP_ROUTE] = attributes[HTTP_ROUTE] ?? routeBackfill;
  }
 
  const middlewareMatch =

packages/nextjs/test/config/withSentry.test.ts

@@ -1,5 +1,5 @@
 import * as SentryCore from '@sentry/core';
-import { SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 import { SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE } from '@sentry/core';
 import type { NextApiRequest, NextApiResponse } from 'next';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
@@ -56,6 +56,7 @@ describe('withSentry', () => {
  [SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.http.nextjs',
  [URL_FULL]: 'https://dogs.are.great/api/dogs?good=true',
  [URL_PATH]: '/api/dogs',
+ [HTTP_ROUTE]: '/my-parameterized-route',
  },
  },
  expect.any(Function),

packages/nextjs/test/edge/withSentryAPI.test.ts

@@ -1,4 +1,7 @@
-import { afterAll, afterEach, describe, it, vi } from 'vitest';
+import * as SentryCore from '@sentry/core';
+import { HTTP_ROUTE, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { SEMANTIC_ATTRIBUTE_SENTRY_OP, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE } from '@sentry/core';
+import { afterAll, afterEach, describe, expect, it, vi } from 'vitest';
 import { wrapApiHandlerWithSentry } from '../../src/edge';
 
 const origRequest = global.Request;
@@ -30,7 +33,7 @@ afterAll(() => {
 });
 
 afterEach(() => {
- vi.clearAllMocks();
+ vi.restoreAllMocks();
 });
 
 describe('wrapApiHandlerWithSentry', () => {
@@ -41,4 +44,50 @@ describe('wrapApiHandlerWithSentry', () => {
 
  await wrappedFunction();
  });
+
+ it('adds normalized request URL and route attributes to the active root span', async () => {
+ const rootSpan = {
+ updateName: vi.fn(),
+ setAttributes: vi.fn(),
+ };
+ vi.spyOn(SentryCore, 'getActiveSpan').mockReturnValueOnce({} as any);
+ vi.spyOn(SentryCore, 'getRootSpan').mockReturnValueOnce(rootSpan as any);
+ vi.spyOn(SentryCore, 'spanToJSON').mockReturnValueOnce({ data: {} } as any);
+ const origFunction = vi.fn(() => new Response());
+ const parameterizedRoute = '/user/[userId]/post/[postId]';
+ const wrappedFunction = wrapApiHandlerWithSentry(origFunction, parameterizedRoute);
+
+ await wrappedFunction(new Request('https://dogs.are.great/user/123/post/456?good=true'));
+
+ expect(rootSpan.updateName).toHaveBeenCalledWith(`POST ${parameterizedRoute}`);
+ expect(rootSpan.setAttributes).toHaveBeenCalledWith({
+ [SEMANTIC_ATTRIBUTE_SENTRY_OP]: 'http.server',
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [URL_FULL]: 'https://dogs.are.great/user/123/post/456?good=true',
+ [URL_PATH]: '/user/123/post/456',
+ [HTTP_ROUTE]: parameterizedRoute,
+ });
+ });
+
+ it('replaces a concrete root span route with the parameterized route', async () => {
+ const rootSpan = {
+ updateName: vi.fn(),
+ setAttributes: vi.fn(),
+ };
+ vi.spyOn(SentryCore, 'getActiveSpan').mockReturnValueOnce({} as any);
+ vi.spyOn(SentryCore, 'getRootSpan').mockReturnValueOnce(rootSpan as any);
+ vi.spyOn(SentryCore, 'spanToJSON').mockReturnValueOnce({
+ data: { [HTTP_ROUTE]: '/user/123/post/456' },
+ } as any);
+ const parameterizedRoute = '/user/[userId]/post/[postId]';
+ const wrappedFunction = wrapApiHandlerWithSentry(() => new Response(), parameterizedRoute);
+
+ await wrappedFunction(new Request('https://dogs.are.great/user/123/post/456'));
+
+ expect(rootSpan.setAttributes).toHaveBeenCalledWith(
+ expect.objectContaining({
+ [HTTP_ROUTE]: parameterizedRoute,
+ }),
+ );
+ });
 });

packages/nextjs/test/server/enhanceHandleRequestRootSpan.test.ts

@@ -1,3 +1,4 @@
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 import { SEMANTIC_ATTRIBUTE_SENTRY_OP, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE } from '@sentry/core';
 import { describe, expect, it } from 'vitest';
 import { ATTR_NEXT_ROUTE, ATTR_NEXT_SPAN_NAME, ATTR_NEXT_SPAN_TYPE } from '../../src/common/nextSpanAttributes';
@@ -48,6 +49,7 @@ describe('enhanceHandleRequestRootSpan', () => {
  expect(getName()).toBe('GET /api/users/[id]');
  expect(span.attributes[SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]).toBe('route');
  expect(span.attributes[ATTR_NEXT_ROUTE]).toBe('/api/users/[id]');
+ expect(span.attributes[HTTP_ROUTE]).toBe('/api/users/[id]');
  });
 
  it('strips trailing /route from app router route handler routes', () => {
@@ -64,6 +66,7 @@ describe('enhanceHandleRequestRootSpan', () => {
 
  expect(getName()).toBe('POST /api/widgets');
  expect(span.attributes[ATTR_NEXT_ROUTE]).toBe('/api/widgets');
+ expect(span.attributes[HTTP_ROUTE]).toBe('/api/widgets');
  });
 
  it('strips URL query and fragment from the segment name', () => {
@@ -105,6 +108,7 @@ describe('enhanceHandleRequestRootSpan', () => {
  enhanceHandleRequestRootSpan(span);
 
  expect(getName()).toBe('GET /posts/[slug]');
+ expect(span.attributes[HTTP_ROUTE]).toBe('/posts/[slug]');
  });
 
  it('does not apply the backfill for the special GET /_app transaction', () => {

dev-packages/e2e-tests/test-applications/create-remix-app-express/tests/server-transactions.test.ts

@@ -14,6 +14,7 @@ test('Sends parameterized transaction name to Sentry', async ({ page }) => {
 
  expect(transaction).toBeDefined();
  expect(transaction.transaction).toBe('GET user/:id');
+ expect(transaction.contexts?.trace?.data?.['http.route']).toBe('user/:id');
 });
 
 test('Sends form data with action span', async ({ page }) => {
@@ -271,6 +272,7 @@ test('Sends two linked transactions (server & client) to Sentry', async ({ page
  const pageLoadParentSpanId = pageloadTransaction.contexts?.trace?.parent_span_id;
 
  expect(httpServerTransaction.transaction).toBe('GET http://localhost:3030/');
+ expect(httpServerTransaction.contexts?.trace?.data?.['http.route']).toBeUndefined();
  expect(pageloadTransaction.transaction).toBe('/');
 
  expect(httpServerTraceId).toBeDefined();

dev-packages/e2e-tests/test-applications/nextjs-orpc/tests/orpc-tracing.test.ts

@@ -42,7 +42,7 @@ test('should trace orpc server component', async ({ page }) => {
  'http.method': 'POST',
  'http.target': '/rpc/planet/list',
  'next.rsc': false,
- 'http.route': '/rpc/[[...rest]]/route',
+ 'http.route': '/rpc/[[...rest]]',
  'next.route': '/rpc/[[...rest]]',
  'http.status_code': 200,
  },
@@ -99,7 +99,7 @@ test('should trace orpc client component', async ({ page }) => {
  'http.method': 'POST',
  'http.target': '/rpc/planet/find',
  'next.rsc': false,
- 'http.route': '/rpc/[[...rest]]/route',
+ 'http.route': '/rpc/[[...rest]]',
  'next.route': '/rpc/[[...rest]]',
  'http.status_code': 200,
  },

packages/elysia/src/withElysia.ts

@@ -1,4 +1,4 @@
-import { URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 import type { Span } from '@sentry/core';
 import {
  captureException,
@@ -60,18 +60,24 @@ const instrumentedApps = new WeakSet<Elysia>();
 function updateRouteTransactionName(request: Request, method: string, route: string): void {
  const transactionName = `${method} ${route}`;
 
+ function applyRouteToSpan(span: Span): void {
+ updateSpanName(span, transactionName);
+ span.setAttributes({
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [HTTP_ROUTE]: route,
+ });
+ }
+
  // Try the stored root span first (reliable across async contexts),
  // then fall back to getActiveSpan() for cases where async context is preserved.
  const rootSpan = rootSpanForRequest.get(request);
  if (rootSpan) {
- updateSpanName(rootSpan, transactionName);
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
+ applyRouteToSpan(rootSpan);
  } else {
  const activeSpan = getActiveSpan();
  if (activeSpan) {
  const root = getRootSpan(activeSpan);
- updateSpanName(root, transactionName);
- root.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
+ applyRouteToSpan(root);
  }
  }
 

packages/elysia/test/withElysia.test.ts

@@ -1,3 +1,4 @@
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 import type { ErrorContext } from 'elysia';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
@@ -32,6 +33,12 @@ const mockGetIsolationScope = vi.fn(() => ({
 const mockGetClient = vi.fn(() => ({
  on: vi.fn(),
 }));
+const mockRootSpan = {
+ setAttributes: vi.fn(),
+ updateName: vi.fn(),
+};
+const mockGetActiveSpan = vi.fn();
+const mockGetRootSpan = vi.fn(() => mockRootSpan);
 const mockGetTraceData = vi.fn(() => ({
  'sentry-trace': 'abc123-def456-1',
  baggage: 'sentry-environment=test,sentry-trace_id=abc123',
@@ -43,8 +50,10 @@ vi.mock('@sentry/core', async importActual => {
  return {
  ...actual,
  captureException: (...args: unknown[]) => mockCaptureException(...args),
+ getActiveSpan: () => mockGetActiveSpan(),
  getIsolationScope: () => mockGetIsolationScope(),
  getClient: () => mockGetClient(),
+ getRootSpan: () => mockGetRootSpan(),
  getTraceData: () => mockGetTraceData(),
  };
 });
@@ -88,6 +97,23 @@ describe('withElysia', () => {
  expect(headers['baggage']).toBe('sentry-environment=test,sentry-trace_id=abc123');
  });
 
+ it('sets the matched route on the root span', () => {
+ mockGetActiveSpan.mockReturnValueOnce(mockRootSpan);
+ // @ts-expect-error - mock app
+ withElysia(mockApp);
+
+ onAfterHandleHandler({
+ route: '/users/:id',
+ request: new Request('https://example.com/users/42', { method: 'GET' }),
+ set: { headers: {} },
+ });
+
+ expect(mockRootSpan.setAttributes).toHaveBeenCalledWith({
+ 'sentry.source': 'route',
+ [HTTP_ROUTE]: '/users/:id',
+ });
+ });
+
  it('does not set headers when trace data is empty', () => {
  mockGetTraceData.mockReturnValueOnce({});
  // @ts-expect-error - mock app

packages/hono/package.json

@@ -73,7 +73,8 @@
  },
  "dependencies": {
  "@opentelemetry/api": "^1.9.1",
- "@sentry/core": "10.67.0"
+ "@sentry/core": "10.67.0",
+ "@sentry/conventions": "^0.16.0"
  },
  "peerDependencies": {
  "@cloudflare/workers-types": "^4.x",

packages/hono/src/shared/middlewareHandlers.ts

@@ -15,6 +15,7 @@ import { defaultShouldHandleError } from './defaultShouldHandleError';
 import { resolveRouteName } from './resolveRouteName';
 import { type SentryHonoMiddlewareOptions } from '../shared/types';
 import { type GetConnInfo } from 'hono/conninfo';
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 
 /**
  * Request handler for Hono framework
@@ -99,7 +100,8 @@ export function responseHandler(
 }
 
 function updateSpanRouteName(isolationScope: Scope, context: Context): void {
- const routeName = `${context.req.method} ${resolveRouteName(context)}`;
+ const route = resolveRouteName(context);
+ const routeName = `${context.req.method} ${route}`;
  const activeSpan = getActiveSpan();
 
  if (activeSpan) {
@@ -108,7 +110,10 @@ function updateSpanRouteName(isolationScope: Scope, context: Context): void {
 
  const rootSpan = getRootSpan(activeSpan);
  updateSpanName(rootSpan, routeName);
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
+ rootSpan.setAttributes({
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [HTTP_ROUTE]: route,
+ });
  }
 
  isolationScope.setTransactionName(routeName);

packages/hono/test/shared/middlewareHandlers.test.ts

@@ -1,4 +1,5 @@
 import * as SentryCore from '@sentry/core';
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 import { requestHandler, responseHandler } from '../../src/shared/middlewareHandlers';
 
@@ -245,6 +246,18 @@ describe('responseHandler', () => {
 
  expect(mockSetTransactionName).toHaveBeenCalledWith('GET /test');
  });
+
+ it('sets http.route on the root span', () => {
+ getActiveSpanMock.mockReturnValue(mockRootSpan);
+
+ // oxlint-disable-next-line typescript/no-explicit-any
+ requestHandler(createMockContext(200) as any);
+
+ expect(mockRootSpan.setAttributes).toHaveBeenCalledWith({
+ 'sentry.source': 'route',
+ [HTTP_ROUTE]: '/test',
+ });
+ });
  });
 });
 

packages/nextjs/src/common/pages-router-instrumentation/wrapApiHandlerWithSentry.ts

@@ -18,7 +18,7 @@ import type { NextApiRequest } from 'next';
 import type { AugmentedNextApiResponse, NextApiHandler } from '../types';
 import { flushSafelyWithTimeout, waitUntil } from '../utils/responseEnd';
 import { dropNextjsRootContext, escapeNextjsTracing } from '../utils/tracingUtils';
-import { SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 
 export type AugmentedNextApiRequest = NextApiRequest & {
  __withSentry_applied__?: boolean;
@@ -95,6 +95,7 @@ export function wrapApiHandlerWithSentry(apiHandler: NextApiHandler, parameteriz
  [SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.http.nextjs',
  [URL_FULL]: urlObject && !isURLObjectRelative(urlObject) ? urlObject.href : undefined,
  [URL_PATH]: urlObject?.pathname,
+ [HTTP_ROUTE]: parameterizedRoute,
  },
  },
  async span => {

packages/nextjs/src/common/wrapRouteHandlerWithSentry.ts

@@ -20,6 +20,7 @@ import { isNotFoundNavigationError, isRedirectNavigationError } from './nextNavi
 import type { RouteHandlerContext } from './types';
 import { flushSafelyWithTimeout, waitUntil } from './utils/responseEnd';
 import { commonObjectToIsolationScope } from './utils/tracingUtils';
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 
 /**
  * Wraps a Next.js App Router Route handler with Sentry error and performance instrumentation.
@@ -47,8 +48,11 @@ export function wrapRouteHandlerWithSentry<F extends (...args: any[]) => any>(
  edgeRuntimeIsolationScopeOverride = isolationScope;
 
  rootSpan.updateName(`${method} ${parameterizedRoute}`);
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_OP, 'http.server');
+ rootSpan.setAttributes({
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [SEMANTIC_ATTRIBUTE_SENTRY_OP]: 'http.server',
+ [HTTP_ROUTE]: parameterizedRoute,
+ });
  }
 
  return withIsolationScope(

packages/nextjs/src/edge/wrapApiHandlerWithSentry.ts

@@ -18,7 +18,7 @@ import {
 import { addHeadersAsAttributes } from '../common/utils/addHeadersAsAttributes';
 import { flushSafelyWithTimeout, waitUntil } from '../common/utils/responseEnd';
 import type { EdgeRouteHandler } from './types';
-import { SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 
 /**
  * Wraps a Next.js edge route handler with Sentry error and performance instrumentation.
@@ -75,6 +75,7 @@ export function wrapApiHandlerWithSentry<H extends EdgeRouteHandler>(
  [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
  [URL_FULL]: rootSpanAttributes[URL_FULL] ?? urlAttributes[URL_FULL],
  [URL_PATH]: rootSpanAttributes[URL_PATH] ?? urlAttributes[URL_PATH],
+ [HTTP_ROUTE]: parameterizedRoute,
  ...headerAttributes,
  });
  setCapturedScopesOnSpan(rootSpan, currentScope, isolationScope);
@@ -93,6 +94,7 @@ export function wrapApiHandlerWithSentry<H extends EdgeRouteHandler>(
  [SENTRY_KIND]: 'server',
  [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
  [SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.function.nextjs.wrap_api_handler',
+ [HTTP_ROUTE]: parameterizedRoute,
  ...urlAttributes,
  ...headerAttributes,
  },

packages/nextjs/src/server/enhanceHandleRequestRootSpan.ts

@@ -47,6 +47,7 @@ export function enhanceHandleRequestRootSpan(span: MutableRootSpan): void {
  const cleanRoute = route.replace(/\/route$/, '');
  span.setName(`${method} ${cleanRoute}`);
  attributes[SEMANTIC_ATTRIBUTE_SENTRY_SOURCE] = 'route';
+ attributes[HTTP_ROUTE] = cleanRoute;
  // Preserve next.route in case it did not get hoisted
  attributes[ATTR_NEXT_ROUTE] = cleanRoute;
  }
@@ -55,6 +56,7 @@ export function enhanceHandleRequestRootSpan(span: MutableRootSpan): void {
  const routeBackfill = attributes[TRANSACTION_ATTR_SENTRY_ROUTE_BACKFILL];
  if (typeof routeBackfill === 'string' && span.getName() !== 'GET /_app') {
  span.setName(`${typeof method === 'string' ? method : 'GET'} ${routeBackfill}`);
+ attributes[HTTP_ROUTE] = attributes[HTTP_ROUTE] ?? routeBackfill;
  }
 
  const middlewareMatch =

packages/nextjs/test/config/withSentry.test.ts

@@ -1,5 +1,5 @@
 import * as SentryCore from '@sentry/core';
-import { SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 import { SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE } from '@sentry/core';
 import type { NextApiRequest, NextApiResponse } from 'next';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
@@ -56,6 +56,7 @@ describe('withSentry', () => {
  [SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.http.nextjs',
  [URL_FULL]: 'https://dogs.are.great/api/dogs?good=true',
  [URL_PATH]: '/api/dogs',
+ [HTTP_ROUTE]: '/my-parameterized-route',
  },
  },
  expect.any(Function),

packages/nextjs/test/edge/withSentryAPI.test.ts

@@ -1,4 +1,7 @@
-import { afterAll, afterEach, describe, it, vi } from 'vitest';
+import * as SentryCore from '@sentry/core';
+import { HTTP_ROUTE, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { SEMANTIC_ATTRIBUTE_SENTRY_OP, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE } from '@sentry/core';
+import { afterAll, afterEach, describe, expect, it, vi } from 'vitest';
 import { wrapApiHandlerWithSentry } from '../../src/edge';
 
 const origRequest = global.Request;
@@ -30,7 +33,7 @@ afterAll(() => {
 });
 
 afterEach(() => {
- vi.clearAllMocks();
+ vi.restoreAllMocks();
 });
 
 describe('wrapApiHandlerWithSentry', () => {
@@ -41,4 +44,50 @@ describe('wrapApiHandlerWithSentry', () => {
 
  await wrappedFunction();
  });
+
+ it('adds normalized request URL and route attributes to the active root span', async () => {
+ const rootSpan = {
+ updateName: vi.fn(),
+ setAttributes: vi.fn(),
+ };
+ vi.spyOn(SentryCore, 'getActiveSpan').mockReturnValueOnce({} as any);
+ vi.spyOn(SentryCore, 'getRootSpan').mockReturnValueOnce(rootSpan as any);
+ vi.spyOn(SentryCore, 'spanToJSON').mockReturnValueOnce({ data: {} } as any);
+ const origFunction = vi.fn(() => new Response());
+ const parameterizedRoute = '/user/[userId]/post/[postId]';
+ const wrappedFunction = wrapApiHandlerWithSentry(origFunction, parameterizedRoute);
+
+ await wrappedFunction(new Request('https://dogs.are.great/user/123/post/456?good=true'));
+
+ expect(rootSpan.updateName).toHaveBeenCalledWith(`POST ${parameterizedRoute}`);
+ expect(rootSpan.setAttributes).toHaveBeenCalledWith({
+ [SEMANTIC_ATTRIBUTE_SENTRY_OP]: 'http.server',
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [URL_FULL]: 'https://dogs.are.great/user/123/post/456?good=true',
+ [URL_PATH]: '/user/123/post/456',
+ [HTTP_ROUTE]: parameterizedRoute,
+ });
+ });
+
+ it('replaces a concrete root span route with the parameterized route', async () => {
+ const rootSpan = {
+ updateName: vi.fn(),
+ setAttributes: vi.fn(),
+ };
+ vi.spyOn(SentryCore, 'getActiveSpan').mockReturnValueOnce({} as any);
+ vi.spyOn(SentryCore, 'getRootSpan').mockReturnValueOnce(rootSpan as any);
+ vi.spyOn(SentryCore, 'spanToJSON').mockReturnValueOnce({
+ data: { [HTTP_ROUTE]: '/user/123/post/456' },
+ } as any);
+ const parameterizedRoute = '/user/[userId]/post/[postId]';
+ const wrappedFunction = wrapApiHandlerWithSentry(() => new Response(), parameterizedRoute);
+
+ await wrappedFunction(new Request('https://dogs.are.great/user/123/post/456'));
+
+ expect(rootSpan.setAttributes).toHaveBeenCalledWith(
+ expect.objectContaining({
+ [HTTP_ROUTE]: parameterizedRoute,
+ }),
+ );
+ });
 });

packages/nextjs/test/server/enhanceHandleRequestRootSpan.test.ts

@@ -1,3 +1,4 @@
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 import { SEMANTIC_ATTRIBUTE_SENTRY_OP, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE } from '@sentry/core';
 import { describe, expect, it } from 'vitest';
 import { ATTR_NEXT_ROUTE, ATTR_NEXT_SPAN_NAME, ATTR_NEXT_SPAN_TYPE } from '../../src/common/nextSpanAttributes';
@@ -48,6 +49,7 @@ describe('enhanceHandleRequestRootSpan', () => {
  expect(getName()).toBe('GET /api/users/[id]');
  expect(span.attributes[SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]).toBe('route');
  expect(span.attributes[ATTR_NEXT_ROUTE]).toBe('/api/users/[id]');
+ expect(span.attributes[HTTP_ROUTE]).toBe('/api/users/[id]');
  });
 
  it('strips trailing /route from app router route handler routes', () => {
@@ -64,6 +66,7 @@ describe('enhanceHandleRequestRootSpan', () => {
 
  expect(getName()).toBe('POST /api/widgets');
  expect(span.attributes[ATTR_NEXT_ROUTE]).toBe('/api/widgets');
+ expect(span.attributes[HTTP_ROUTE]).toBe('/api/widgets');
  });
 
  it('strips URL query and fragment from the segment name', () => {
@@ -105,6 +108,7 @@ describe('enhanceHandleRequestRootSpan', () => {
  enhanceHandleRequestRootSpan(span);
 
  expect(getName()).toBe('GET /posts/[slug]');
+ expect(span.attributes[HTTP_ROUTE]).toBe('/posts/[slug]');
  });
 
  it('does not apply the backfill for the special GET /_app transaction', () => {

dev-packages/e2e-tests/test-applications/create-remix-app-express/tests/server-transactions.test.ts

@@ -14,6 +14,7 @@ test('Sends parameterized transaction name to Sentry', async ({ page }) => {
 
  expect(transaction).toBeDefined();
  expect(transaction.transaction).toBe('GET user/:id');
+ expect(transaction.contexts?.trace?.data?.['http.route']).toBe('user/:id');
 });
 
 test('Sends form data with action span', async ({ page }) => {
@@ -271,6 +272,7 @@ test('Sends two linked transactions (server & client) to Sentry', async ({ page
  const pageLoadParentSpanId = pageloadTransaction.contexts?.trace?.parent_span_id;
 
  expect(httpServerTransaction.transaction).toBe('GET http://localhost:3030/');
+ expect(httpServerTransaction.contexts?.trace?.data?.['http.route']).toBeUndefined();
  expect(pageloadTransaction.transaction).toBe('/');
 
  expect(httpServerTraceId).toBeDefined();

dev-packages/e2e-tests/test-applications/nextjs-orpc/tests/orpc-tracing.test.ts

@@ -42,7 +42,7 @@ test('should trace orpc server component', async ({ page }) => {
  'http.method': 'POST',
  'http.target': '/rpc/planet/list',
  'next.rsc': false,
- 'http.route': '/rpc/[[...rest]]/route',
+ 'http.route': '/rpc/[[...rest]]',
  'next.route': '/rpc/[[...rest]]',
  'http.status_code': 200,
  },
@@ -99,7 +99,7 @@ test('should trace orpc client component', async ({ page }) => {
  'http.method': 'POST',
  'http.target': '/rpc/planet/find',
  'next.rsc': false,
- 'http.route': '/rpc/[[...rest]]/route',
+ 'http.route': '/rpc/[[...rest]]',
  'next.route': '/rpc/[[...rest]]',
  'http.status_code': 200,
  },

packages/elysia/src/withElysia.ts

@@ -1,4 +1,4 @@
-import { URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 import type { Span } from '@sentry/core';
 import {
  captureException,
@@ -60,18 +60,24 @@ const instrumentedApps = new WeakSet<Elysia>();
 function updateRouteTransactionName(request: Request, method: string, route: string): void {
  const transactionName = `${method} ${route}`;
 
+ function applyRouteToSpan(span: Span): void {
+ updateSpanName(span, transactionName);
+ span.setAttributes({
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [HTTP_ROUTE]: route,
+ });
+ }
+
  // Try the stored root span first (reliable across async contexts),
  // then fall back to getActiveSpan() for cases where async context is preserved.
  const rootSpan = rootSpanForRequest.get(request);
  if (rootSpan) {
- updateSpanName(rootSpan, transactionName);
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
+ applyRouteToSpan(rootSpan);
  } else {
  const activeSpan = getActiveSpan();
  if (activeSpan) {
  const root = getRootSpan(activeSpan);
- updateSpanName(root, transactionName);
- root.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
+ applyRouteToSpan(root);
  }
  }
 

packages/elysia/test/withElysia.test.ts

@@ -1,3 +1,4 @@
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 import type { ErrorContext } from 'elysia';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
@@ -32,6 +33,12 @@ const mockGetIsolationScope = vi.fn(() => ({
 const mockGetClient = vi.fn(() => ({
  on: vi.fn(),
 }));
+const mockRootSpan = {
+ setAttributes: vi.fn(),
+ updateName: vi.fn(),
+};
+const mockGetActiveSpan = vi.fn();
+const mockGetRootSpan = vi.fn(() => mockRootSpan);
 const mockGetTraceData = vi.fn(() => ({
  'sentry-trace': 'abc123-def456-1',
  baggage: 'sentry-environment=test,sentry-trace_id=abc123',
@@ -43,8 +50,10 @@ vi.mock('@sentry/core', async importActual => {
  return {
  ...actual,
  captureException: (...args: unknown[]) => mockCaptureException(...args),
+ getActiveSpan: () => mockGetActiveSpan(),
  getIsolationScope: () => mockGetIsolationScope(),
  getClient: () => mockGetClient(),
+ getRootSpan: () => mockGetRootSpan(),
  getTraceData: () => mockGetTraceData(),
  };
 });
@@ -88,6 +97,23 @@ describe('withElysia', () => {
  expect(headers['baggage']).toBe('sentry-environment=test,sentry-trace_id=abc123');
  });
 
+ it('sets the matched route on the root span', () => {
+ mockGetActiveSpan.mockReturnValueOnce(mockRootSpan);
+ // @ts-expect-error - mock app
+ withElysia(mockApp);
+
+ onAfterHandleHandler({
+ route: '/users/:id',
+ request: new Request('https://example.com/users/42', { method: 'GET' }),
+ set: { headers: {} },
+ });
+
+ expect(mockRootSpan.setAttributes).toHaveBeenCalledWith({
+ 'sentry.source': 'route',
+ [HTTP_ROUTE]: '/users/:id',
+ });
+ });
+
  it('does not set headers when trace data is empty', () => {
  mockGetTraceData.mockReturnValueOnce({});
  // @ts-expect-error - mock app

packages/hono/package.json

@@ -73,7 +73,8 @@
  },
  "dependencies": {
  "@opentelemetry/api": "^1.9.1",
- "@sentry/core": "10.67.0"
+ "@sentry/core": "10.67.0",
+ "@sentry/conventions": "^0.16.0"
  },
  "peerDependencies": {
  "@cloudflare/workers-types": "^4.x",

packages/hono/src/shared/middlewareHandlers.ts

@@ -15,6 +15,7 @@ import { defaultShouldHandleError } from './defaultShouldHandleError';
 import { resolveRouteName } from './resolveRouteName';
 import { type SentryHonoMiddlewareOptions } from '../shared/types';
 import { type GetConnInfo } from 'hono/conninfo';
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 
 /**
  * Request handler for Hono framework
@@ -99,7 +100,8 @@ export function responseHandler(
 }
 
 function updateSpanRouteName(isolationScope: Scope, context: Context): void {
- const routeName = `${context.req.method} ${resolveRouteName(context)}`;
+ const route = resolveRouteName(context);
+ const routeName = `${context.req.method} ${route}`;
  const activeSpan = getActiveSpan();
 
  if (activeSpan) {
@@ -108,7 +110,10 @@ function updateSpanRouteName(isolationScope: Scope, context: Context): void {
 
  const rootSpan = getRootSpan(activeSpan);
  updateSpanName(rootSpan, routeName);
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
+ rootSpan.setAttributes({
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [HTTP_ROUTE]: route,
+ });
  }
 
  isolationScope.setTransactionName(routeName);

packages/hono/test/shared/middlewareHandlers.test.ts

@@ -1,4 +1,5 @@
 import * as SentryCore from '@sentry/core';
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 import { requestHandler, responseHandler } from '../../src/shared/middlewareHandlers';
 
@@ -245,6 +246,18 @@ describe('responseHandler', () => {
 
  expect(mockSetTransactionName).toHaveBeenCalledWith('GET /test');
  });
+
+ it('sets http.route on the root span', () => {
+ getActiveSpanMock.mockReturnValue(mockRootSpan);
+
+ // oxlint-disable-next-line typescript/no-explicit-any
+ requestHandler(createMockContext(200) as any);
+
+ expect(mockRootSpan.setAttributes).toHaveBeenCalledWith({
+ 'sentry.source': 'route',
+ [HTTP_ROUTE]: '/test',
+ });
+ });
  });
 });
 

packages/nextjs/src/common/pages-router-instrumentation/wrapApiHandlerWithSentry.ts

@@ -18,7 +18,7 @@ import type { NextApiRequest } from 'next';
 import type { AugmentedNextApiResponse, NextApiHandler } from '../types';
 import { flushSafelyWithTimeout, waitUntil } from '../utils/responseEnd';
 import { dropNextjsRootContext, escapeNextjsTracing } from '../utils/tracingUtils';
-import { SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 
 export type AugmentedNextApiRequest = NextApiRequest & {
  __withSentry_applied__?: boolean;
@@ -95,6 +95,7 @@ export function wrapApiHandlerWithSentry(apiHandler: NextApiHandler, parameteriz
  [SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.http.nextjs',
  [URL_FULL]: urlObject && !isURLObjectRelative(urlObject) ? urlObject.href : undefined,
  [URL_PATH]: urlObject?.pathname,
+ [HTTP_ROUTE]: parameterizedRoute,
  },
  },
  async span => {

packages/nextjs/src/common/wrapRouteHandlerWithSentry.ts

@@ -20,6 +20,7 @@ import { isNotFoundNavigationError, isRedirectNavigationError } from './nextNavi
 import type { RouteHandlerContext } from './types';
 import { flushSafelyWithTimeout, waitUntil } from './utils/responseEnd';
 import { commonObjectToIsolationScope } from './utils/tracingUtils';
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 
 /**
  * Wraps a Next.js App Router Route handler with Sentry error and performance instrumentation.
@@ -47,8 +48,11 @@ export function wrapRouteHandlerWithSentry<F extends (...args: any[]) => any>(
  edgeRuntimeIsolationScopeOverride = isolationScope;
 
  rootSpan.updateName(`${method} ${parameterizedRoute}`);
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_OP, 'http.server');
+ rootSpan.setAttributes({
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [SEMANTIC_ATTRIBUTE_SENTRY_OP]: 'http.server',
+ [HTTP_ROUTE]: parameterizedRoute,
+ });
  }
 
  return withIsolationScope(

packages/nextjs/src/edge/wrapApiHandlerWithSentry.ts

@@ -18,7 +18,7 @@ import {
 import { addHeadersAsAttributes } from '../common/utils/addHeadersAsAttributes';
 import { flushSafelyWithTimeout, waitUntil } from '../common/utils/responseEnd';
 import type { EdgeRouteHandler } from './types';
-import { SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 
 /**
  * Wraps a Next.js edge route handler with Sentry error and performance instrumentation.
@@ -75,6 +75,7 @@ export function wrapApiHandlerWithSentry<H extends EdgeRouteHandler>(
  [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
  [URL_FULL]: rootSpanAttributes[URL_FULL] ?? urlAttributes[URL_FULL],
  [URL_PATH]: rootSpanAttributes[URL_PATH] ?? urlAttributes[URL_PATH],
+ [HTTP_ROUTE]: parameterizedRoute,
  ...headerAttributes,
  });
  setCapturedScopesOnSpan(rootSpan, currentScope, isolationScope);
@@ -93,6 +94,7 @@ export function wrapApiHandlerWithSentry<H extends EdgeRouteHandler>(
  [SENTRY_KIND]: 'server',
  [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
  [SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.function.nextjs.wrap_api_handler',
+ [HTTP_ROUTE]: parameterizedRoute,
  ...urlAttributes,
  ...headerAttributes,
  },

packages/nextjs/src/server/enhanceHandleRequestRootSpan.ts

@@ -47,6 +47,7 @@ export function enhanceHandleRequestRootSpan(span: MutableRootSpan): void {
  const cleanRoute = route.replace(/\/route$/, '');
  span.setName(`${method} ${cleanRoute}`);
  attributes[SEMANTIC_ATTRIBUTE_SENTRY_SOURCE] = 'route';
+ attributes[HTTP_ROUTE] = cleanRoute;
  // Preserve next.route in case it did not get hoisted
  attributes[ATTR_NEXT_ROUTE] = cleanRoute;
  }
@@ -55,6 +56,7 @@ export function enhanceHandleRequestRootSpan(span: MutableRootSpan): void {
  const routeBackfill = attributes[TRANSACTION_ATTR_SENTRY_ROUTE_BACKFILL];
  if (typeof routeBackfill === 'string' && span.getName() !== 'GET /_app') {
  span.setName(`${typeof method === 'string' ? method : 'GET'} ${routeBackfill}`);
+ attributes[HTTP_ROUTE] = attributes[HTTP_ROUTE] ?? routeBackfill;
  }
 
  const middlewareMatch =

packages/nextjs/test/config/withSentry.test.ts

@@ -1,5 +1,5 @@
 import * as SentryCore from '@sentry/core';
-import { SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 import { SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE } from '@sentry/core';
 import type { NextApiRequest, NextApiResponse } from 'next';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
@@ -56,6 +56,7 @@ describe('withSentry', () => {
  [SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.http.nextjs',
  [URL_FULL]: 'https://dogs.are.great/api/dogs?good=true',
  [URL_PATH]: '/api/dogs',
+ [HTTP_ROUTE]: '/my-parameterized-route',
  },
  },
  expect.any(Function),

packages/nextjs/test/edge/withSentryAPI.test.ts

@@ -1,4 +1,7 @@
-import { afterAll, afterEach, describe, it, vi } from 'vitest';
+import * as SentryCore from '@sentry/core';
+import { HTTP_ROUTE, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { SEMANTIC_ATTRIBUTE_SENTRY_OP, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE } from '@sentry/core';
+import { afterAll, afterEach, describe, expect, it, vi } from 'vitest';
 import { wrapApiHandlerWithSentry } from '../../src/edge';
 
 const origRequest = global.Request;
@@ -30,7 +33,7 @@ afterAll(() => {
 });
 
 afterEach(() => {
- vi.clearAllMocks();
+ vi.restoreAllMocks();
 });
 
 describe('wrapApiHandlerWithSentry', () => {
@@ -41,4 +44,50 @@ describe('wrapApiHandlerWithSentry', () => {
 
  await wrappedFunction();
  });
+
+ it('adds normalized request URL and route attributes to the active root span', async () => {
+ const rootSpan = {
+ updateName: vi.fn(),
+ setAttributes: vi.fn(),
+ };
+ vi.spyOn(SentryCore, 'getActiveSpan').mockReturnValueOnce({} as any);
+ vi.spyOn(SentryCore, 'getRootSpan').mockReturnValueOnce(rootSpan as any);
+ vi.spyOn(SentryCore, 'spanToJSON').mockReturnValueOnce({ data: {} } as any);
+ const origFunction = vi.fn(() => new Response());
+ const parameterizedRoute = '/user/[userId]/post/[postId]';
+ const wrappedFunction = wrapApiHandlerWithSentry(origFunction, parameterizedRoute);
+
+ await wrappedFunction(new Request('https://dogs.are.great/user/123/post/456?good=true'));
+
+ expect(rootSpan.updateName).toHaveBeenCalledWith(`POST ${parameterizedRoute}`);
+ expect(rootSpan.setAttributes).toHaveBeenCalledWith({
+ [SEMANTIC_ATTRIBUTE_SENTRY_OP]: 'http.server',
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [URL_FULL]: 'https://dogs.are.great/user/123/post/456?good=true',
+ [URL_PATH]: '/user/123/post/456',
+ [HTTP_ROUTE]: parameterizedRoute,
+ });
+ });
+
+ it('replaces a concrete root span route with the parameterized route', async () => {
+ const rootSpan = {
+ updateName: vi.fn(),
+ setAttributes: vi.fn(),
+ };
+ vi.spyOn(SentryCore, 'getActiveSpan').mockReturnValueOnce({} as any);
+ vi.spyOn(SentryCore, 'getRootSpan').mockReturnValueOnce(rootSpan as any);
+ vi.spyOn(SentryCore, 'spanToJSON').mockReturnValueOnce({
+ data: { [HTTP_ROUTE]: '/user/123/post/456' },
+ } as any);
+ const parameterizedRoute = '/user/[userId]/post/[postId]';
+ const wrappedFunction = wrapApiHandlerWithSentry(() => new Response(), parameterizedRoute);
+
+ await wrappedFunction(new Request('https://dogs.are.great/user/123/post/456'));
+
+ expect(rootSpan.setAttributes).toHaveBeenCalledWith(
+ expect.objectContaining({
+ [HTTP_ROUTE]: parameterizedRoute,
+ }),
+ );
+ });
 });

packages/nextjs/test/server/enhanceHandleRequestRootSpan.test.ts

@@ -1,3 +1,4 @@
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 import { SEMANTIC_ATTRIBUTE_SENTRY_OP, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE } from '@sentry/core';
 import { describe, expect, it } from 'vitest';
 import { ATTR_NEXT_ROUTE, ATTR_NEXT_SPAN_NAME, ATTR_NEXT_SPAN_TYPE } from '../../src/common/nextSpanAttributes';
@@ -48,6 +49,7 @@ describe('enhanceHandleRequestRootSpan', () => {
  expect(getName()).toBe('GET /api/users/[id]');
  expect(span.attributes[SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]).toBe('route');
  expect(span.attributes[ATTR_NEXT_ROUTE]).toBe('/api/users/[id]');
+ expect(span.attributes[HTTP_ROUTE]).toBe('/api/users/[id]');
  });
 
  it('strips trailing /route from app router route handler routes', () => {
@@ -64,6 +66,7 @@ describe('enhanceHandleRequestRootSpan', () => {
 
  expect(getName()).toBe('POST /api/widgets');
  expect(span.attributes[ATTR_NEXT_ROUTE]).toBe('/api/widgets');
+ expect(span.attributes[HTTP_ROUTE]).toBe('/api/widgets');
  });
 
  it('strips URL query and fragment from the segment name', () => {
@@ -105,6 +108,7 @@ describe('enhanceHandleRequestRootSpan', () => {
  enhanceHandleRequestRootSpan(span);
 
  expect(getName()).toBe('GET /posts/[slug]');
+ expect(span.attributes[HTTP_ROUTE]).toBe('/posts/[slug]');
  });
 
  it('does not apply the backfill for the special GET /_app transaction', () => {

dev-packages/e2e-tests/test-applications/create-remix-app-express/tests/server-transactions.test.ts

@@ -14,6 +14,7 @@ test('Sends parameterized transaction name to Sentry', async ({ page }) => {
 
  expect(transaction).toBeDefined();
  expect(transaction.transaction).toBe('GET user/:id');
+ expect(transaction.contexts?.trace?.data?.['http.route']).toBe('user/:id');
 });
 
 test('Sends form data with action span', async ({ page }) => {
@@ -271,6 +272,7 @@ test('Sends two linked transactions (server & client) to Sentry', async ({ page
  const pageLoadParentSpanId = pageloadTransaction.contexts?.trace?.parent_span_id;
 
  expect(httpServerTransaction.transaction).toBe('GET http://localhost:3030/');
+ expect(httpServerTransaction.contexts?.trace?.data?.['http.route']).toBeUndefined();
  expect(pageloadTransaction.transaction).toBe('/');
 
  expect(httpServerTraceId).toBeDefined();

dev-packages/e2e-tests/test-applications/nextjs-orpc/tests/orpc-tracing.test.ts

@@ -42,7 +42,7 @@ test('should trace orpc server component', async ({ page }) => {
  'http.method': 'POST',
  'http.target': '/rpc/planet/list',
  'next.rsc': false,
- 'http.route': '/rpc/[[...rest]]/route',
+ 'http.route': '/rpc/[[...rest]]',
  'next.route': '/rpc/[[...rest]]',
  'http.status_code': 200,
  },
@@ -99,7 +99,7 @@ test('should trace orpc client component', async ({ page }) => {
  'http.method': 'POST',
  'http.target': '/rpc/planet/find',
  'next.rsc': false,
- 'http.route': '/rpc/[[...rest]]/route',
+ 'http.route': '/rpc/[[...rest]]',
  'next.route': '/rpc/[[...rest]]',
  'http.status_code': 200,
  },

packages/elysia/src/withElysia.ts

@@ -1,4 +1,4 @@
-import { URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 import type { Span } from '@sentry/core';
 import {
  captureException,
@@ -60,18 +60,24 @@ const instrumentedApps = new WeakSet<Elysia>();
 function updateRouteTransactionName(request: Request, method: string, route: string): void {
  const transactionName = `${method} ${route}`;
 
+ function applyRouteToSpan(span: Span): void {
+ updateSpanName(span, transactionName);
+ span.setAttributes({
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [HTTP_ROUTE]: route,
+ });
+ }
+
  // Try the stored root span first (reliable across async contexts),
  // then fall back to getActiveSpan() for cases where async context is preserved.
  const rootSpan = rootSpanForRequest.get(request);
  if (rootSpan) {
- updateSpanName(rootSpan, transactionName);
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
+ applyRouteToSpan(rootSpan);
  } else {
  const activeSpan = getActiveSpan();
  if (activeSpan) {
  const root = getRootSpan(activeSpan);
- updateSpanName(root, transactionName);
- root.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
+ applyRouteToSpan(root);
  }
  }
 

packages/elysia/test/withElysia.test.ts

@@ -1,3 +1,4 @@
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 import type { ErrorContext } from 'elysia';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
@@ -32,6 +33,12 @@ const mockGetIsolationScope = vi.fn(() => ({
 const mockGetClient = vi.fn(() => ({
  on: vi.fn(),
 }));
+const mockRootSpan = {
+ setAttributes: vi.fn(),
+ updateName: vi.fn(),
+};
+const mockGetActiveSpan = vi.fn();
+const mockGetRootSpan = vi.fn(() => mockRootSpan);
 const mockGetTraceData = vi.fn(() => ({
  'sentry-trace': 'abc123-def456-1',
  baggage: 'sentry-environment=test,sentry-trace_id=abc123',
@@ -43,8 +50,10 @@ vi.mock('@sentry/core', async importActual => {
  return {
  ...actual,
  captureException: (...args: unknown[]) => mockCaptureException(...args),
+ getActiveSpan: () => mockGetActiveSpan(),
  getIsolationScope: () => mockGetIsolationScope(),
  getClient: () => mockGetClient(),
+ getRootSpan: () => mockGetRootSpan(),
  getTraceData: () => mockGetTraceData(),
  };
 });
@@ -88,6 +97,23 @@ describe('withElysia', () => {
  expect(headers['baggage']).toBe('sentry-environment=test,sentry-trace_id=abc123');
  });
 
+ it('sets the matched route on the root span', () => {
+ mockGetActiveSpan.mockReturnValueOnce(mockRootSpan);
+ // @ts-expect-error - mock app
+ withElysia(mockApp);
+
+ onAfterHandleHandler({
+ route: '/users/:id',
+ request: new Request('https://example.com/users/42', { method: 'GET' }),
+ set: { headers: {} },
+ });
+
+ expect(mockRootSpan.setAttributes).toHaveBeenCalledWith({
+ 'sentry.source': 'route',
+ [HTTP_ROUTE]: '/users/:id',
+ });
+ });
+
  it('does not set headers when trace data is empty', () => {
  mockGetTraceData.mockReturnValueOnce({});
  // @ts-expect-error - mock app

packages/hono/package.json

@@ -73,7 +73,8 @@
  },
  "dependencies": {
  "@opentelemetry/api": "^1.9.1",
- "@sentry/core": "10.67.0"
+ "@sentry/core": "10.67.0",
+ "@sentry/conventions": "^0.16.0"
  },
  "peerDependencies": {
  "@cloudflare/workers-types": "^4.x",

packages/hono/src/shared/middlewareHandlers.ts

@@ -15,6 +15,7 @@ import { defaultShouldHandleError } from './defaultShouldHandleError';
 import { resolveRouteName } from './resolveRouteName';
 import { type SentryHonoMiddlewareOptions } from '../shared/types';
 import { type GetConnInfo } from 'hono/conninfo';
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 
 /**
  * Request handler for Hono framework
@@ -99,7 +100,8 @@ export function responseHandler(
 }
 
 function updateSpanRouteName(isolationScope: Scope, context: Context): void {
- const routeName = `${context.req.method} ${resolveRouteName(context)}`;
+ const route = resolveRouteName(context);
+ const routeName = `${context.req.method} ${route}`;
  const activeSpan = getActiveSpan();
 
  if (activeSpan) {
@@ -108,7 +110,10 @@ function updateSpanRouteName(isolationScope: Scope, context: Context): void {
 
  const rootSpan = getRootSpan(activeSpan);
  updateSpanName(rootSpan, routeName);
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
+ rootSpan.setAttributes({
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [HTTP_ROUTE]: route,
+ });
  }
 
  isolationScope.setTransactionName(routeName);

packages/hono/test/shared/middlewareHandlers.test.ts

@@ -1,4 +1,5 @@
 import * as SentryCore from '@sentry/core';
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 import { requestHandler, responseHandler } from '../../src/shared/middlewareHandlers';
 
@@ -245,6 +246,18 @@ describe('responseHandler', () => {
 
  expect(mockSetTransactionName).toHaveBeenCalledWith('GET /test');
  });
+
+ it('sets http.route on the root span', () => {
+ getActiveSpanMock.mockReturnValue(mockRootSpan);
+
+ // oxlint-disable-next-line typescript/no-explicit-any
+ requestHandler(createMockContext(200) as any);
+
+ expect(mockRootSpan.setAttributes).toHaveBeenCalledWith({
+ 'sentry.source': 'route',
+ [HTTP_ROUTE]: '/test',
+ });
+ });
  });
 });
 

packages/nextjs/src/common/pages-router-instrumentation/wrapApiHandlerWithSentry.ts

@@ -18,7 +18,7 @@ import type { NextApiRequest } from 'next';
 import type { AugmentedNextApiResponse, NextApiHandler } from '../types';
 import { flushSafelyWithTimeout, waitUntil } from '../utils/responseEnd';
 import { dropNextjsRootContext, escapeNextjsTracing } from '../utils/tracingUtils';
-import { SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 
 export type AugmentedNextApiRequest = NextApiRequest & {
  __withSentry_applied__?: boolean;
@@ -95,6 +95,7 @@ export function wrapApiHandlerWithSentry(apiHandler: NextApiHandler, parameteriz
  [SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.http.nextjs',
  [URL_FULL]: urlObject && !isURLObjectRelative(urlObject) ? urlObject.href : undefined,
  [URL_PATH]: urlObject?.pathname,
+ [HTTP_ROUTE]: parameterizedRoute,
  },
  },
  async span => {

packages/nextjs/src/common/wrapRouteHandlerWithSentry.ts

@@ -20,6 +20,7 @@ import { isNotFoundNavigationError, isRedirectNavigationError } from './nextNavi
 import type { RouteHandlerContext } from './types';
 import { flushSafelyWithTimeout, waitUntil } from './utils/responseEnd';
 import { commonObjectToIsolationScope } from './utils/tracingUtils';
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 
 /**
  * Wraps a Next.js App Router Route handler with Sentry error and performance instrumentation.
@@ -47,8 +48,11 @@ export function wrapRouteHandlerWithSentry<F extends (...args: any[]) => any>(
  edgeRuntimeIsolationScopeOverride = isolationScope;
 
  rootSpan.updateName(`${method} ${parameterizedRoute}`);
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_OP, 'http.server');
+ rootSpan.setAttributes({
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [SEMANTIC_ATTRIBUTE_SENTRY_OP]: 'http.server',
+ [HTTP_ROUTE]: parameterizedRoute,
+ });
  }
 
  return withIsolationScope(

packages/nextjs/src/edge/wrapApiHandlerWithSentry.ts

@@ -18,7 +18,7 @@ import {
 import { addHeadersAsAttributes } from '../common/utils/addHeadersAsAttributes';
 import { flushSafelyWithTimeout, waitUntil } from '../common/utils/responseEnd';
 import type { EdgeRouteHandler } from './types';
-import { SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 
 /**
  * Wraps a Next.js edge route handler with Sentry error and performance instrumentation.
@@ -75,6 +75,7 @@ export function wrapApiHandlerWithSentry<H extends EdgeRouteHandler>(
  [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
  [URL_FULL]: rootSpanAttributes[URL_FULL] ?? urlAttributes[URL_FULL],
  [URL_PATH]: rootSpanAttributes[URL_PATH] ?? urlAttributes[URL_PATH],
+ [HTTP_ROUTE]: parameterizedRoute,
  ...headerAttributes,
  });
  setCapturedScopesOnSpan(rootSpan, currentScope, isolationScope);
@@ -93,6 +94,7 @@ export function wrapApiHandlerWithSentry<H extends EdgeRouteHandler>(
  [SENTRY_KIND]: 'server',
  [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
  [SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.function.nextjs.wrap_api_handler',
+ [HTTP_ROUTE]: parameterizedRoute,
  ...urlAttributes,
  ...headerAttributes,
  },

packages/nextjs/src/server/enhanceHandleRequestRootSpan.ts

@@ -47,6 +47,7 @@ export function enhanceHandleRequestRootSpan(span: MutableRootSpan): void {
  const cleanRoute = route.replace(/\/route$/, '');
  span.setName(`${method} ${cleanRoute}`);
  attributes[SEMANTIC_ATTRIBUTE_SENTRY_SOURCE] = 'route';
+ attributes[HTTP_ROUTE] = cleanRoute;
  // Preserve next.route in case it did not get hoisted
  attributes[ATTR_NEXT_ROUTE] = cleanRoute;
  }
@@ -55,6 +56,7 @@ export function enhanceHandleRequestRootSpan(span: MutableRootSpan): void {
  const routeBackfill = attributes[TRANSACTION_ATTR_SENTRY_ROUTE_BACKFILL];
  if (typeof routeBackfill === 'string' && span.getName() !== 'GET /_app') {
  span.setName(`${typeof method === 'string' ? method : 'GET'} ${routeBackfill}`);
+ attributes[HTTP_ROUTE] = attributes[HTTP_ROUTE] ?? routeBackfill;
  }
 
  const middlewareMatch =

packages/nextjs/test/config/withSentry.test.ts

@@ -1,5 +1,5 @@
 import * as SentryCore from '@sentry/core';
-import { SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 import { SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE } from '@sentry/core';
 import type { NextApiRequest, NextApiResponse } from 'next';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
@@ -56,6 +56,7 @@ describe('withSentry', () => {
  [SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.http.nextjs',
  [URL_FULL]: 'https://dogs.are.great/api/dogs?good=true',
  [URL_PATH]: '/api/dogs',
+ [HTTP_ROUTE]: '/my-parameterized-route',
  },
  },
  expect.any(Function),

packages/nextjs/test/edge/withSentryAPI.test.ts

@@ -1,4 +1,7 @@
-import { afterAll, afterEach, describe, it, vi } from 'vitest';
+import * as SentryCore from '@sentry/core';
+import { HTTP_ROUTE, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { SEMANTIC_ATTRIBUTE_SENTRY_OP, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE } from '@sentry/core';
+import { afterAll, afterEach, describe, expect, it, vi } from 'vitest';
 import { wrapApiHandlerWithSentry } from '../../src/edge';
 
 const origRequest = global.Request;
@@ -30,7 +33,7 @@ afterAll(() => {
 });
 
 afterEach(() => {
- vi.clearAllMocks();
+ vi.restoreAllMocks();
 });
 
 describe('wrapApiHandlerWithSentry', () => {
@@ -41,4 +44,50 @@ describe('wrapApiHandlerWithSentry', () => {
 
  await wrappedFunction();
  });
+
+ it('adds normalized request URL and route attributes to the active root span', async () => {
+ const rootSpan = {
+ updateName: vi.fn(),
+ setAttributes: vi.fn(),
+ };
+ vi.spyOn(SentryCore, 'getActiveSpan').mockReturnValueOnce({} as any);
+ vi.spyOn(SentryCore, 'getRootSpan').mockReturnValueOnce(rootSpan as any);
+ vi.spyOn(SentryCore, 'spanToJSON').mockReturnValueOnce({ data: {} } as any);
+ const origFunction = vi.fn(() => new Response());
+ const parameterizedRoute = '/user/[userId]/post/[postId]';
+ const wrappedFunction = wrapApiHandlerWithSentry(origFunction, parameterizedRoute);
+
+ await wrappedFunction(new Request('https://dogs.are.great/user/123/post/456?good=true'));
+
+ expect(rootSpan.updateName).toHaveBeenCalledWith(`POST ${parameterizedRoute}`);
+ expect(rootSpan.setAttributes).toHaveBeenCalledWith({
+ [SEMANTIC_ATTRIBUTE_SENTRY_OP]: 'http.server',
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [URL_FULL]: 'https://dogs.are.great/user/123/post/456?good=true',
+ [URL_PATH]: '/user/123/post/456',
+ [HTTP_ROUTE]: parameterizedRoute,
+ });
+ });
+
+ it('replaces a concrete root span route with the parameterized route', async () => {
+ const rootSpan = {
+ updateName: vi.fn(),
+ setAttributes: vi.fn(),
+ };
+ vi.spyOn(SentryCore, 'getActiveSpan').mockReturnValueOnce({} as any);
+ vi.spyOn(SentryCore, 'getRootSpan').mockReturnValueOnce(rootSpan as any);
+ vi.spyOn(SentryCore, 'spanToJSON').mockReturnValueOnce({
+ data: { [HTTP_ROUTE]: '/user/123/post/456' },
+ } as any);
+ const parameterizedRoute = '/user/[userId]/post/[postId]';
+ const wrappedFunction = wrapApiHandlerWithSentry(() => new Response(), parameterizedRoute);
+
+ await wrappedFunction(new Request('https://dogs.are.great/user/123/post/456'));
+
+ expect(rootSpan.setAttributes).toHaveBeenCalledWith(
+ expect.objectContaining({
+ [HTTP_ROUTE]: parameterizedRoute,
+ }),
+ );
+ });
 });

packages/nextjs/test/server/enhanceHandleRequestRootSpan.test.ts

@@ -1,3 +1,4 @@
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 import { SEMANTIC_ATTRIBUTE_SENTRY_OP, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE } from '@sentry/core';
 import { describe, expect, it } from 'vitest';
 import { ATTR_NEXT_ROUTE, ATTR_NEXT_SPAN_NAME, ATTR_NEXT_SPAN_TYPE } from '../../src/common/nextSpanAttributes';
@@ -48,6 +49,7 @@ describe('enhanceHandleRequestRootSpan', () => {
  expect(getName()).toBe('GET /api/users/[id]');
  expect(span.attributes[SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]).toBe('route');
  expect(span.attributes[ATTR_NEXT_ROUTE]).toBe('/api/users/[id]');
+ expect(span.attributes[HTTP_ROUTE]).toBe('/api/users/[id]');
  });
 
  it('strips trailing /route from app router route handler routes', () => {
@@ -64,6 +66,7 @@ describe('enhanceHandleRequestRootSpan', () => {
 
  expect(getName()).toBe('POST /api/widgets');
  expect(span.attributes[ATTR_NEXT_ROUTE]).toBe('/api/widgets');
+ expect(span.attributes[HTTP_ROUTE]).toBe('/api/widgets');
  });
 
  it('strips URL query and fragment from the segment name', () => {
@@ -105,6 +108,7 @@ describe('enhanceHandleRequestRootSpan', () => {
  enhanceHandleRequestRootSpan(span);
 
  expect(getName()).toBe('GET /posts/[slug]');
+ expect(span.attributes[HTTP_ROUTE]).toBe('/posts/[slug]');
  });
 
  it('does not apply the backfill for the special GET /_app transaction', () => {

dev-packages/e2e-tests/test-applications/create-remix-app-express/tests/server-transactions.test.ts

@@ -14,6 +14,7 @@ test('Sends parameterized transaction name to Sentry', async ({ page }) => {
 
  expect(transaction).toBeDefined();
  expect(transaction.transaction).toBe('GET user/:id');
+ expect(transaction.contexts?.trace?.data?.['http.route']).toBe('user/:id');
 });
 
 test('Sends form data with action span', async ({ page }) => {
@@ -271,6 +272,7 @@ test('Sends two linked transactions (server & client) to Sentry', async ({ page
  const pageLoadParentSpanId = pageloadTransaction.contexts?.trace?.parent_span_id;
 
  expect(httpServerTransaction.transaction).toBe('GET http://localhost:3030/');
+ expect(httpServerTransaction.contexts?.trace?.data?.['http.route']).toBeUndefined();
  expect(pageloadTransaction.transaction).toBe('/');
 
  expect(httpServerTraceId).toBeDefined();

dev-packages/e2e-tests/test-applications/nextjs-orpc/tests/orpc-tracing.test.ts

@@ -42,7 +42,7 @@ test('should trace orpc server component', async ({ page }) => {
  'http.method': 'POST',
  'http.target': '/rpc/planet/list',
  'next.rsc': false,
- 'http.route': '/rpc/[[...rest]]/route',
+ 'http.route': '/rpc/[[...rest]]',
  'next.route': '/rpc/[[...rest]]',
  'http.status_code': 200,
  },
@@ -99,7 +99,7 @@ test('should trace orpc client component', async ({ page }) => {
  'http.method': 'POST',
  'http.target': '/rpc/planet/find',
  'next.rsc': false,
- 'http.route': '/rpc/[[...rest]]/route',
+ 'http.route': '/rpc/[[...rest]]',
  'next.route': '/rpc/[[...rest]]',
  'http.status_code': 200,
  },

packages/elysia/src/withElysia.ts

@@ -1,4 +1,4 @@
-import { URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 import type { Span } from '@sentry/core';
 import {
  captureException,
@@ -60,18 +60,24 @@ const instrumentedApps = new WeakSet<Elysia>();
 function updateRouteTransactionName(request: Request, method: string, route: string): void {
  const transactionName = `${method} ${route}`;
 
+ function applyRouteToSpan(span: Span): void {
+ updateSpanName(span, transactionName);
+ span.setAttributes({
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [HTTP_ROUTE]: route,
+ });
+ }
+
  // Try the stored root span first (reliable across async contexts),
  // then fall back to getActiveSpan() for cases where async context is preserved.
  const rootSpan = rootSpanForRequest.get(request);
  if (rootSpan) {
- updateSpanName(rootSpan, transactionName);
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
+ applyRouteToSpan(rootSpan);
  } else {
  const activeSpan = getActiveSpan();
  if (activeSpan) {
  const root = getRootSpan(activeSpan);
- updateSpanName(root, transactionName);
- root.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
+ applyRouteToSpan(root);
  }
  }
 

packages/elysia/test/withElysia.test.ts

@@ -1,3 +1,4 @@
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 import type { ErrorContext } from 'elysia';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
@@ -32,6 +33,12 @@ const mockGetIsolationScope = vi.fn(() => ({
 const mockGetClient = vi.fn(() => ({
  on: vi.fn(),
 }));
+const mockRootSpan = {
+ setAttributes: vi.fn(),
+ updateName: vi.fn(),
+};
+const mockGetActiveSpan = vi.fn();
+const mockGetRootSpan = vi.fn(() => mockRootSpan);
 const mockGetTraceData = vi.fn(() => ({
  'sentry-trace': 'abc123-def456-1',
  baggage: 'sentry-environment=test,sentry-trace_id=abc123',
@@ -43,8 +50,10 @@ vi.mock('@sentry/core', async importActual => {
  return {
  ...actual,
  captureException: (...args: unknown[]) => mockCaptureException(...args),
+ getActiveSpan: () => mockGetActiveSpan(),
  getIsolationScope: () => mockGetIsolationScope(),
  getClient: () => mockGetClient(),
+ getRootSpan: () => mockGetRootSpan(),
  getTraceData: () => mockGetTraceData(),
  };
 });
@@ -88,6 +97,23 @@ describe('withElysia', () => {
  expect(headers['baggage']).toBe('sentry-environment=test,sentry-trace_id=abc123');
  });
 
+ it('sets the matched route on the root span', () => {
+ mockGetActiveSpan.mockReturnValueOnce(mockRootSpan);
+ // @ts-expect-error - mock app
+ withElysia(mockApp);
+
+ onAfterHandleHandler({
+ route: '/users/:id',
+ request: new Request('https://example.com/users/42', { method: 'GET' }),
+ set: { headers: {} },
+ });
+
+ expect(mockRootSpan.setAttributes).toHaveBeenCalledWith({
+ 'sentry.source': 'route',
+ [HTTP_ROUTE]: '/users/:id',
+ });
+ });
+
  it('does not set headers when trace data is empty', () => {
  mockGetTraceData.mockReturnValueOnce({});
  // @ts-expect-error - mock app

packages/hono/package.json

@@ -73,7 +73,8 @@
  },
  "dependencies": {
  "@opentelemetry/api": "^1.9.1",
- "@sentry/core": "10.67.0"
+ "@sentry/core": "10.67.0",
+ "@sentry/conventions": "^0.16.0"
  },
  "peerDependencies": {
  "@cloudflare/workers-types": "^4.x",

packages/hono/src/shared/middlewareHandlers.ts

@@ -15,6 +15,7 @@ import { defaultShouldHandleError } from './defaultShouldHandleError';
 import { resolveRouteName } from './resolveRouteName';
 import { type SentryHonoMiddlewareOptions } from '../shared/types';
 import { type GetConnInfo } from 'hono/conninfo';
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 
 /**
  * Request handler for Hono framework
@@ -99,7 +100,8 @@ export function responseHandler(
 }
 
 function updateSpanRouteName(isolationScope: Scope, context: Context): void {
- const routeName = `${context.req.method} ${resolveRouteName(context)}`;
+ const route = resolveRouteName(context);
+ const routeName = `${context.req.method} ${route}`;
  const activeSpan = getActiveSpan();
 
  if (activeSpan) {
@@ -108,7 +110,10 @@ function updateSpanRouteName(isolationScope: Scope, context: Context): void {
 
  const rootSpan = getRootSpan(activeSpan);
  updateSpanName(rootSpan, routeName);
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
+ rootSpan.setAttributes({
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [HTTP_ROUTE]: route,
+ });
  }
 
  isolationScope.setTransactionName(routeName);

packages/hono/test/shared/middlewareHandlers.test.ts

@@ -1,4 +1,5 @@
 import * as SentryCore from '@sentry/core';
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 import { requestHandler, responseHandler } from '../../src/shared/middlewareHandlers';
 
@@ -245,6 +246,18 @@ describe('responseHandler', () => {
 
  expect(mockSetTransactionName).toHaveBeenCalledWith('GET /test');
  });
+
+ it('sets http.route on the root span', () => {
+ getActiveSpanMock.mockReturnValue(mockRootSpan);
+
+ // oxlint-disable-next-line typescript/no-explicit-any
+ requestHandler(createMockContext(200) as any);
+
+ expect(mockRootSpan.setAttributes).toHaveBeenCalledWith({
+ 'sentry.source': 'route',
+ [HTTP_ROUTE]: '/test',
+ });
+ });
  });
 });
 

packages/nextjs/src/common/pages-router-instrumentation/wrapApiHandlerWithSentry.ts

@@ -18,7 +18,7 @@ import type { NextApiRequest } from 'next';
 import type { AugmentedNextApiResponse, NextApiHandler } from '../types';
 import { flushSafelyWithTimeout, waitUntil } from '../utils/responseEnd';
 import { dropNextjsRootContext, escapeNextjsTracing } from '../utils/tracingUtils';
-import { SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 
 export type AugmentedNextApiRequest = NextApiRequest & {
  __withSentry_applied__?: boolean;
@@ -95,6 +95,7 @@ export function wrapApiHandlerWithSentry(apiHandler: NextApiHandler, parameteriz
  [SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.http.nextjs',
  [URL_FULL]: urlObject && !isURLObjectRelative(urlObject) ? urlObject.href : undefined,
  [URL_PATH]: urlObject?.pathname,
+ [HTTP_ROUTE]: parameterizedRoute,
  },
  },
  async span => {

packages/nextjs/src/common/wrapRouteHandlerWithSentry.ts

@@ -20,6 +20,7 @@ import { isNotFoundNavigationError, isRedirectNavigationError } from './nextNavi
 import type { RouteHandlerContext } from './types';
 import { flushSafelyWithTimeout, waitUntil } from './utils/responseEnd';
 import { commonObjectToIsolationScope } from './utils/tracingUtils';
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 
 /**
  * Wraps a Next.js App Router Route handler with Sentry error and performance instrumentation.
@@ -47,8 +48,11 @@ export function wrapRouteHandlerWithSentry<F extends (...args: any[]) => any>(
  edgeRuntimeIsolationScopeOverride = isolationScope;
 
  rootSpan.updateName(`${method} ${parameterizedRoute}`);
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_OP, 'http.server');
+ rootSpan.setAttributes({
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [SEMANTIC_ATTRIBUTE_SENTRY_OP]: 'http.server',
+ [HTTP_ROUTE]: parameterizedRoute,
+ });
  }
 
  return withIsolationScope(

packages/nextjs/src/edge/wrapApiHandlerWithSentry.ts

@@ -18,7 +18,7 @@ import {
 import { addHeadersAsAttributes } from '../common/utils/addHeadersAsAttributes';
 import { flushSafelyWithTimeout, waitUntil } from '../common/utils/responseEnd';
 import type { EdgeRouteHandler } from './types';
-import { SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 
 /**
  * Wraps a Next.js edge route handler with Sentry error and performance instrumentation.
@@ -75,6 +75,7 @@ export function wrapApiHandlerWithSentry<H extends EdgeRouteHandler>(
  [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
  [URL_FULL]: rootSpanAttributes[URL_FULL] ?? urlAttributes[URL_FULL],
  [URL_PATH]: rootSpanAttributes[URL_PATH] ?? urlAttributes[URL_PATH],
+ [HTTP_ROUTE]: parameterizedRoute,
  ...headerAttributes,
  });
  setCapturedScopesOnSpan(rootSpan, currentScope, isolationScope);
@@ -93,6 +94,7 @@ export function wrapApiHandlerWithSentry<H extends EdgeRouteHandler>(
  [SENTRY_KIND]: 'server',
  [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
  [SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.function.nextjs.wrap_api_handler',
+ [HTTP_ROUTE]: parameterizedRoute,
  ...urlAttributes,
  ...headerAttributes,
  },

packages/nextjs/src/server/enhanceHandleRequestRootSpan.ts

@@ -47,6 +47,7 @@ export function enhanceHandleRequestRootSpan(span: MutableRootSpan): void {
  const cleanRoute = route.replace(/\/route$/, '');
  span.setName(`${method} ${cleanRoute}`);
  attributes[SEMANTIC_ATTRIBUTE_SENTRY_SOURCE] = 'route';
+ attributes[HTTP_ROUTE] = cleanRoute;
  // Preserve next.route in case it did not get hoisted
  attributes[ATTR_NEXT_ROUTE] = cleanRoute;
  }
@@ -55,6 +56,7 @@ export function enhanceHandleRequestRootSpan(span: MutableRootSpan): void {
  const routeBackfill = attributes[TRANSACTION_ATTR_SENTRY_ROUTE_BACKFILL];
  if (typeof routeBackfill === 'string' && span.getName() !== 'GET /_app') {
  span.setName(`${typeof method === 'string' ? method : 'GET'} ${routeBackfill}`);
+ attributes[HTTP_ROUTE] = attributes[HTTP_ROUTE] ?? routeBackfill;
  }
 
  const middlewareMatch =

packages/nextjs/test/config/withSentry.test.ts

@@ -1,5 +1,5 @@
 import * as SentryCore from '@sentry/core';
-import { SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 import { SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE } from '@sentry/core';
 import type { NextApiRequest, NextApiResponse } from 'next';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
@@ -56,6 +56,7 @@ describe('withSentry', () => {
  [SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.http.nextjs',
  [URL_FULL]: 'https://dogs.are.great/api/dogs?good=true',
  [URL_PATH]: '/api/dogs',
+ [HTTP_ROUTE]: '/my-parameterized-route',
  },
  },
  expect.any(Function),

packages/nextjs/test/edge/withSentryAPI.test.ts

@@ -1,4 +1,7 @@
-import { afterAll, afterEach, describe, it, vi } from 'vitest';
+import * as SentryCore from '@sentry/core';
+import { HTTP_ROUTE, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { SEMANTIC_ATTRIBUTE_SENTRY_OP, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE } from '@sentry/core';
+import { afterAll, afterEach, describe, expect, it, vi } from 'vitest';
 import { wrapApiHandlerWithSentry } from '../../src/edge';
 
 const origRequest = global.Request;
@@ -30,7 +33,7 @@ afterAll(() => {
 });
 
 afterEach(() => {
- vi.clearAllMocks();
+ vi.restoreAllMocks();
 });
 
 describe('wrapApiHandlerWithSentry', () => {
@@ -41,4 +44,50 @@ describe('wrapApiHandlerWithSentry', () => {
 
  await wrappedFunction();
  });
+
+ it('adds normalized request URL and route attributes to the active root span', async () => {
+ const rootSpan = {
+ updateName: vi.fn(),
+ setAttributes: vi.fn(),
+ };
+ vi.spyOn(SentryCore, 'getActiveSpan').mockReturnValueOnce({} as any);
+ vi.spyOn(SentryCore, 'getRootSpan').mockReturnValueOnce(rootSpan as any);
+ vi.spyOn(SentryCore, 'spanToJSON').mockReturnValueOnce({ data: {} } as any);
+ const origFunction = vi.fn(() => new Response());
+ const parameterizedRoute = '/user/[userId]/post/[postId]';
+ const wrappedFunction = wrapApiHandlerWithSentry(origFunction, parameterizedRoute);
+
+ await wrappedFunction(new Request('https://dogs.are.great/user/123/post/456?good=true'));
+
+ expect(rootSpan.updateName).toHaveBeenCalledWith(`POST ${parameterizedRoute}`);
+ expect(rootSpan.setAttributes).toHaveBeenCalledWith({
+ [SEMANTIC_ATTRIBUTE_SENTRY_OP]: 'http.server',
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [URL_FULL]: 'https://dogs.are.great/user/123/post/456?good=true',
+ [URL_PATH]: '/user/123/post/456',
+ [HTTP_ROUTE]: parameterizedRoute,
+ });
+ });
+
+ it('replaces a concrete root span route with the parameterized route', async () => {
+ const rootSpan = {
+ updateName: vi.fn(),
+ setAttributes: vi.fn(),
+ };
+ vi.spyOn(SentryCore, 'getActiveSpan').mockReturnValueOnce({} as any);
+ vi.spyOn(SentryCore, 'getRootSpan').mockReturnValueOnce(rootSpan as any);
+ vi.spyOn(SentryCore, 'spanToJSON').mockReturnValueOnce({
+ data: { [HTTP_ROUTE]: '/user/123/post/456' },
+ } as any);
+ const parameterizedRoute = '/user/[userId]/post/[postId]';
+ const wrappedFunction = wrapApiHandlerWithSentry(() => new Response(), parameterizedRoute);
+
+ await wrappedFunction(new Request('https://dogs.are.great/user/123/post/456'));
+
+ expect(rootSpan.setAttributes).toHaveBeenCalledWith(
+ expect.objectContaining({
+ [HTTP_ROUTE]: parameterizedRoute,
+ }),
+ );
+ });
 });

packages/nextjs/test/server/enhanceHandleRequestRootSpan.test.ts

@@ -1,3 +1,4 @@
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 import { SEMANTIC_ATTRIBUTE_SENTRY_OP, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE } from '@sentry/core';
 import { describe, expect, it } from 'vitest';
 import { ATTR_NEXT_ROUTE, ATTR_NEXT_SPAN_NAME, ATTR_NEXT_SPAN_TYPE } from '../../src/common/nextSpanAttributes';
@@ -48,6 +49,7 @@ describe('enhanceHandleRequestRootSpan', () => {
  expect(getName()).toBe('GET /api/users/[id]');
  expect(span.attributes[SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]).toBe('route');
  expect(span.attributes[ATTR_NEXT_ROUTE]).toBe('/api/users/[id]');
+ expect(span.attributes[HTTP_ROUTE]).toBe('/api/users/[id]');
  });
 
  it('strips trailing /route from app router route handler routes', () => {
@@ -64,6 +66,7 @@ describe('enhanceHandleRequestRootSpan', () => {
 
  expect(getName()).toBe('POST /api/widgets');
  expect(span.attributes[ATTR_NEXT_ROUTE]).toBe('/api/widgets');
+ expect(span.attributes[HTTP_ROUTE]).toBe('/api/widgets');
  });
 
  it('strips URL query and fragment from the segment name', () => {
@@ -105,6 +108,7 @@ describe('enhanceHandleRequestRootSpan', () => {
  enhanceHandleRequestRootSpan(span);
 
  expect(getName()).toBe('GET /posts/[slug]');
+ expect(span.attributes[HTTP_ROUTE]).toBe('/posts/[slug]');
  });
 
  it('does not apply the backfill for the special GET /_app transaction', () => {

dev-packages/e2e-tests/test-applications/create-remix-app-express/tests/server-transactions.test.ts

@@ -14,6 +14,7 @@ test('Sends parameterized transaction name to Sentry', async ({ page }) => {
 
  expect(transaction).toBeDefined();
  expect(transaction.transaction).toBe('GET user/:id');
+ expect(transaction.contexts?.trace?.data?.['http.route']).toBe('user/:id');
 });
 
 test('Sends form data with action span', async ({ page }) => {
@@ -271,6 +272,7 @@ test('Sends two linked transactions (server & client) to Sentry', async ({ page
  const pageLoadParentSpanId = pageloadTransaction.contexts?.trace?.parent_span_id;
 
  expect(httpServerTransaction.transaction).toBe('GET http://localhost:3030/');
+ expect(httpServerTransaction.contexts?.trace?.data?.['http.route']).toBeUndefined();
  expect(pageloadTransaction.transaction).toBe('/');
 
  expect(httpServerTraceId).toBeDefined();

dev-packages/e2e-tests/test-applications/nextjs-orpc/tests/orpc-tracing.test.ts

@@ -42,7 +42,7 @@ test('should trace orpc server component', async ({ page }) => {
  'http.method': 'POST',
  'http.target': '/rpc/planet/list',
  'next.rsc': false,
- 'http.route': '/rpc/[[...rest]]/route',
+ 'http.route': '/rpc/[[...rest]]',
  'next.route': '/rpc/[[...rest]]',
  'http.status_code': 200,
  },
@@ -99,7 +99,7 @@ test('should trace orpc client component', async ({ page }) => {
  'http.method': 'POST',
  'http.target': '/rpc/planet/find',
  'next.rsc': false,
- 'http.route': '/rpc/[[...rest]]/route',
+ 'http.route': '/rpc/[[...rest]]',
  'next.route': '/rpc/[[...rest]]',
  'http.status_code': 200,
  },

packages/elysia/src/withElysia.ts

@@ -1,4 +1,4 @@
-import { URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 import type { Span } from '@sentry/core';
 import {
  captureException,
@@ -60,18 +60,24 @@ const instrumentedApps = new WeakSet<Elysia>();
 function updateRouteTransactionName(request: Request, method: string, route: string): void {
  const transactionName = `${method} ${route}`;
 
+ function applyRouteToSpan(span: Span): void {
+ updateSpanName(span, transactionName);
+ span.setAttributes({
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [HTTP_ROUTE]: route,
+ });
+ }
+
  // Try the stored root span first (reliable across async contexts),
  // then fall back to getActiveSpan() for cases where async context is preserved.
  const rootSpan = rootSpanForRequest.get(request);
  if (rootSpan) {
- updateSpanName(rootSpan, transactionName);
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
+ applyRouteToSpan(rootSpan);
  } else {
  const activeSpan = getActiveSpan();
  if (activeSpan) {
  const root = getRootSpan(activeSpan);
- updateSpanName(root, transactionName);
- root.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
+ applyRouteToSpan(root);
  }
  }
 

packages/elysia/test/withElysia.test.ts

@@ -1,3 +1,4 @@
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 import type { ErrorContext } from 'elysia';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
@@ -32,6 +33,12 @@ const mockGetIsolationScope = vi.fn(() => ({
 const mockGetClient = vi.fn(() => ({
  on: vi.fn(),
 }));
+const mockRootSpan = {
+ setAttributes: vi.fn(),
+ updateName: vi.fn(),
+};
+const mockGetActiveSpan = vi.fn();
+const mockGetRootSpan = vi.fn(() => mockRootSpan);
 const mockGetTraceData = vi.fn(() => ({
  'sentry-trace': 'abc123-def456-1',
  baggage: 'sentry-environment=test,sentry-trace_id=abc123',
@@ -43,8 +50,10 @@ vi.mock('@sentry/core', async importActual => {
  return {
  ...actual,
  captureException: (...args: unknown[]) => mockCaptureException(...args),
+ getActiveSpan: () => mockGetActiveSpan(),
  getIsolationScope: () => mockGetIsolationScope(),
  getClient: () => mockGetClient(),
+ getRootSpan: () => mockGetRootSpan(),
  getTraceData: () => mockGetTraceData(),
  };
 });
@@ -88,6 +97,23 @@ describe('withElysia', () => {
  expect(headers['baggage']).toBe('sentry-environment=test,sentry-trace_id=abc123');
  });
 
+ it('sets the matched route on the root span', () => {
+ mockGetActiveSpan.mockReturnValueOnce(mockRootSpan);
+ // @ts-expect-error - mock app
+ withElysia(mockApp);
+
+ onAfterHandleHandler({
+ route: '/users/:id',
+ request: new Request('https://example.com/users/42', { method: 'GET' }),
+ set: { headers: {} },
+ });
+
+ expect(mockRootSpan.setAttributes).toHaveBeenCalledWith({
+ 'sentry.source': 'route',
+ [HTTP_ROUTE]: '/users/:id',
+ });
+ });
+
  it('does not set headers when trace data is empty', () => {
  mockGetTraceData.mockReturnValueOnce({});
  // @ts-expect-error - mock app

packages/hono/package.json

@@ -73,7 +73,8 @@
  },
  "dependencies": {
  "@opentelemetry/api": "^1.9.1",
- "@sentry/core": "10.67.0"
+ "@sentry/core": "10.67.0",
+ "@sentry/conventions": "^0.16.0"
  },
  "peerDependencies": {
  "@cloudflare/workers-types": "^4.x",

packages/hono/src/shared/middlewareHandlers.ts

@@ -15,6 +15,7 @@ import { defaultShouldHandleError } from './defaultShouldHandleError';
 import { resolveRouteName } from './resolveRouteName';
 import { type SentryHonoMiddlewareOptions } from '../shared/types';
 import { type GetConnInfo } from 'hono/conninfo';
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 
 /**
  * Request handler for Hono framework
@@ -99,7 +100,8 @@ export function responseHandler(
 }
 
 function updateSpanRouteName(isolationScope: Scope, context: Context): void {
- const routeName = `${context.req.method} ${resolveRouteName(context)}`;
+ const route = resolveRouteName(context);
+ const routeName = `${context.req.method} ${route}`;
  const activeSpan = getActiveSpan();
 
  if (activeSpan) {
@@ -108,7 +110,10 @@ function updateSpanRouteName(isolationScope: Scope, context: Context): void {
 
  const rootSpan = getRootSpan(activeSpan);
  updateSpanName(rootSpan, routeName);
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
+ rootSpan.setAttributes({
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [HTTP_ROUTE]: route,
+ });
  }
 
  isolationScope.setTransactionName(routeName);

packages/hono/test/shared/middlewareHandlers.test.ts

@@ -1,4 +1,5 @@
 import * as SentryCore from '@sentry/core';
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 import { requestHandler, responseHandler } from '../../src/shared/middlewareHandlers';
 
@@ -245,6 +246,18 @@ describe('responseHandler', () => {
 
  expect(mockSetTransactionName).toHaveBeenCalledWith('GET /test');
  });
+
+ it('sets http.route on the root span', () => {
+ getActiveSpanMock.mockReturnValue(mockRootSpan);
+
+ // oxlint-disable-next-line typescript/no-explicit-any
+ requestHandler(createMockContext(200) as any);
+
+ expect(mockRootSpan.setAttributes).toHaveBeenCalledWith({
+ 'sentry.source': 'route',
+ [HTTP_ROUTE]: '/test',
+ });
+ });
  });
 });
 

packages/nextjs/src/common/pages-router-instrumentation/wrapApiHandlerWithSentry.ts

@@ -18,7 +18,7 @@ import type { NextApiRequest } from 'next';
 import type { AugmentedNextApiResponse, NextApiHandler } from '../types';
 import { flushSafelyWithTimeout, waitUntil } from '../utils/responseEnd';
 import { dropNextjsRootContext, escapeNextjsTracing } from '../utils/tracingUtils';
-import { SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 
 export type AugmentedNextApiRequest = NextApiRequest & {
  __withSentry_applied__?: boolean;
@@ -95,6 +95,7 @@ export function wrapApiHandlerWithSentry(apiHandler: NextApiHandler, parameteriz
  [SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.http.nextjs',
  [URL_FULL]: urlObject && !isURLObjectRelative(urlObject) ? urlObject.href : undefined,
  [URL_PATH]: urlObject?.pathname,
+ [HTTP_ROUTE]: parameterizedRoute,
  },
  },
  async span => {

packages/nextjs/src/common/wrapRouteHandlerWithSentry.ts

@@ -20,6 +20,7 @@ import { isNotFoundNavigationError, isRedirectNavigationError } from './nextNavi
 import type { RouteHandlerContext } from './types';
 import { flushSafelyWithTimeout, waitUntil } from './utils/responseEnd';
 import { commonObjectToIsolationScope } from './utils/tracingUtils';
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 
 /**
  * Wraps a Next.js App Router Route handler with Sentry error and performance instrumentation.
@@ -47,8 +48,11 @@ export function wrapRouteHandlerWithSentry<F extends (...args: any[]) => any>(
  edgeRuntimeIsolationScopeOverride = isolationScope;
 
  rootSpan.updateName(`${method} ${parameterizedRoute}`);
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_OP, 'http.server');
+ rootSpan.setAttributes({
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [SEMANTIC_ATTRIBUTE_SENTRY_OP]: 'http.server',
+ [HTTP_ROUTE]: parameterizedRoute,
+ });
  }
 
  return withIsolationScope(

packages/nextjs/src/edge/wrapApiHandlerWithSentry.ts

@@ -18,7 +18,7 @@ import {
 import { addHeadersAsAttributes } from '../common/utils/addHeadersAsAttributes';
 import { flushSafelyWithTimeout, waitUntil } from '../common/utils/responseEnd';
 import type { EdgeRouteHandler } from './types';
-import { SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 
 /**
  * Wraps a Next.js edge route handler with Sentry error and performance instrumentation.
@@ -75,6 +75,7 @@ export function wrapApiHandlerWithSentry<H extends EdgeRouteHandler>(
  [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
  [URL_FULL]: rootSpanAttributes[URL_FULL] ?? urlAttributes[URL_FULL],
  [URL_PATH]: rootSpanAttributes[URL_PATH] ?? urlAttributes[URL_PATH],
+ [HTTP_ROUTE]: parameterizedRoute,
  ...headerAttributes,
  });
  setCapturedScopesOnSpan(rootSpan, currentScope, isolationScope);
@@ -93,6 +94,7 @@ export function wrapApiHandlerWithSentry<H extends EdgeRouteHandler>(
  [SENTRY_KIND]: 'server',
  [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
  [SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.function.nextjs.wrap_api_handler',
+ [HTTP_ROUTE]: parameterizedRoute,
  ...urlAttributes,
  ...headerAttributes,
  },

packages/nextjs/src/server/enhanceHandleRequestRootSpan.ts

@@ -47,6 +47,7 @@ export function enhanceHandleRequestRootSpan(span: MutableRootSpan): void {
  const cleanRoute = route.replace(/\/route$/, '');
  span.setName(`${method} ${cleanRoute}`);
  attributes[SEMANTIC_ATTRIBUTE_SENTRY_SOURCE] = 'route';
+ attributes[HTTP_ROUTE] = cleanRoute;
  // Preserve next.route in case it did not get hoisted
  attributes[ATTR_NEXT_ROUTE] = cleanRoute;
  }
@@ -55,6 +56,7 @@ export function enhanceHandleRequestRootSpan(span: MutableRootSpan): void {
  const routeBackfill = attributes[TRANSACTION_ATTR_SENTRY_ROUTE_BACKFILL];
  if (typeof routeBackfill === 'string' && span.getName() !== 'GET /_app') {
  span.setName(`${typeof method === 'string' ? method : 'GET'} ${routeBackfill}`);
+ attributes[HTTP_ROUTE] = attributes[HTTP_ROUTE] ?? routeBackfill;
  }
 
  const middlewareMatch =

packages/nextjs/test/config/withSentry.test.ts

@@ -1,5 +1,5 @@
 import * as SentryCore from '@sentry/core';
-import { SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 import { SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE } from '@sentry/core';
 import type { NextApiRequest, NextApiResponse } from 'next';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
@@ -56,6 +56,7 @@ describe('withSentry', () => {
  [SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.http.nextjs',
  [URL_FULL]: 'https://dogs.are.great/api/dogs?good=true',
  [URL_PATH]: '/api/dogs',
+ [HTTP_ROUTE]: '/my-parameterized-route',
  },
  },
  expect.any(Function),

packages/nextjs/test/edge/withSentryAPI.test.ts

@@ -1,4 +1,7 @@
-import { afterAll, afterEach, describe, it, vi } from 'vitest';
+import * as SentryCore from '@sentry/core';
+import { HTTP_ROUTE, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { SEMANTIC_ATTRIBUTE_SENTRY_OP, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE } from '@sentry/core';
+import { afterAll, afterEach, describe, expect, it, vi } from 'vitest';
 import { wrapApiHandlerWithSentry } from '../../src/edge';
 
 const origRequest = global.Request;
@@ -30,7 +33,7 @@ afterAll(() => {
 });
 
 afterEach(() => {
- vi.clearAllMocks();
+ vi.restoreAllMocks();
 });
 
 describe('wrapApiHandlerWithSentry', () => {
@@ -41,4 +44,50 @@ describe('wrapApiHandlerWithSentry', () => {
 
  await wrappedFunction();
  });
+
+ it('adds normalized request URL and route attributes to the active root span', async () => {
+ const rootSpan = {
+ updateName: vi.fn(),
+ setAttributes: vi.fn(),
+ };
+ vi.spyOn(SentryCore, 'getActiveSpan').mockReturnValueOnce({} as any);
+ vi.spyOn(SentryCore, 'getRootSpan').mockReturnValueOnce(rootSpan as any);
+ vi.spyOn(SentryCore, 'spanToJSON').mockReturnValueOnce({ data: {} } as any);
+ const origFunction = vi.fn(() => new Response());
+ const parameterizedRoute = '/user/[userId]/post/[postId]';
+ const wrappedFunction = wrapApiHandlerWithSentry(origFunction, parameterizedRoute);
+
+ await wrappedFunction(new Request('https://dogs.are.great/user/123/post/456?good=true'));
+
+ expect(rootSpan.updateName).toHaveBeenCalledWith(`POST ${parameterizedRoute}`);
+ expect(rootSpan.setAttributes).toHaveBeenCalledWith({
+ [SEMANTIC_ATTRIBUTE_SENTRY_OP]: 'http.server',
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [URL_FULL]: 'https://dogs.are.great/user/123/post/456?good=true',
+ [URL_PATH]: '/user/123/post/456',
+ [HTTP_ROUTE]: parameterizedRoute,
+ });
+ });
+
+ it('replaces a concrete root span route with the parameterized route', async () => {
+ const rootSpan = {
+ updateName: vi.fn(),
+ setAttributes: vi.fn(),
+ };
+ vi.spyOn(SentryCore, 'getActiveSpan').mockReturnValueOnce({} as any);
+ vi.spyOn(SentryCore, 'getRootSpan').mockReturnValueOnce(rootSpan as any);
+ vi.spyOn(SentryCore, 'spanToJSON').mockReturnValueOnce({
+ data: { [HTTP_ROUTE]: '/user/123/post/456' },
+ } as any);
+ const parameterizedRoute = '/user/[userId]/post/[postId]';
+ const wrappedFunction = wrapApiHandlerWithSentry(() => new Response(), parameterizedRoute);
+
+ await wrappedFunction(new Request('https://dogs.are.great/user/123/post/456'));
+
+ expect(rootSpan.setAttributes).toHaveBeenCalledWith(
+ expect.objectContaining({
+ [HTTP_ROUTE]: parameterizedRoute,
+ }),
+ );
+ });
 });

packages/nextjs/test/server/enhanceHandleRequestRootSpan.test.ts

@@ -1,3 +1,4 @@
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 import { SEMANTIC_ATTRIBUTE_SENTRY_OP, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE } from '@sentry/core';
 import { describe, expect, it } from 'vitest';
 import { ATTR_NEXT_ROUTE, ATTR_NEXT_SPAN_NAME, ATTR_NEXT_SPAN_TYPE } from '../../src/common/nextSpanAttributes';
@@ -48,6 +49,7 @@ describe('enhanceHandleRequestRootSpan', () => {
  expect(getName()).toBe('GET /api/users/[id]');
  expect(span.attributes[SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]).toBe('route');
  expect(span.attributes[ATTR_NEXT_ROUTE]).toBe('/api/users/[id]');
+ expect(span.attributes[HTTP_ROUTE]).toBe('/api/users/[id]');
  });
 
  it('strips trailing /route from app router route handler routes', () => {
@@ -64,6 +66,7 @@ describe('enhanceHandleRequestRootSpan', () => {
 
  expect(getName()).toBe('POST /api/widgets');
  expect(span.attributes[ATTR_NEXT_ROUTE]).toBe('/api/widgets');
+ expect(span.attributes[HTTP_ROUTE]).toBe('/api/widgets');
  });
 
  it('strips URL query and fragment from the segment name', () => {
@@ -105,6 +108,7 @@ describe('enhanceHandleRequestRootSpan', () => {
  enhanceHandleRequestRootSpan(span);
 
  expect(getName()).toBe('GET /posts/[slug]');
+ expect(span.attributes[HTTP_ROUTE]).toBe('/posts/[slug]');
  });
 
  it('does not apply the backfill for the special GET /_app transaction', () => {

dev-packages/e2e-tests/test-applications/create-remix-app-express/tests/server-transactions.test.ts

@@ -14,6 +14,7 @@ test('Sends parameterized transaction name to Sentry', async ({ page }) => {
 
  expect(transaction).toBeDefined();
  expect(transaction.transaction).toBe('GET user/:id');
+ expect(transaction.contexts?.trace?.data?.['http.route']).toBe('user/:id');
 });
 
 test('Sends form data with action span', async ({ page }) => {
@@ -271,6 +272,7 @@ test('Sends two linked transactions (server & client) to Sentry', async ({ page
  const pageLoadParentSpanId = pageloadTransaction.contexts?.trace?.parent_span_id;
 
  expect(httpServerTransaction.transaction).toBe('GET http://localhost:3030/');
+ expect(httpServerTransaction.contexts?.trace?.data?.['http.route']).toBeUndefined();
  expect(pageloadTransaction.transaction).toBe('/');
 
  expect(httpServerTraceId).toBeDefined();

dev-packages/e2e-tests/test-applications/nextjs-orpc/tests/orpc-tracing.test.ts

@@ -42,7 +42,7 @@ test('should trace orpc server component', async ({ page }) => {
  'http.method': 'POST',
  'http.target': '/rpc/planet/list',
  'next.rsc': false,
- 'http.route': '/rpc/[[...rest]]/route',
+ 'http.route': '/rpc/[[...rest]]',
  'next.route': '/rpc/[[...rest]]',
  'http.status_code': 200,
  },
@@ -99,7 +99,7 @@ test('should trace orpc client component', async ({ page }) => {
  'http.method': 'POST',
  'http.target': '/rpc/planet/find',
  'next.rsc': false,
- 'http.route': '/rpc/[[...rest]]/route',
+ 'http.route': '/rpc/[[...rest]]',
  'next.route': '/rpc/[[...rest]]',
  'http.status_code': 200,
  },

packages/elysia/src/withElysia.ts

@@ -1,4 +1,4 @@
-import { URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 import type { Span } from '@sentry/core';
 import {
  captureException,
@@ -60,18 +60,24 @@ const instrumentedApps = new WeakSet<Elysia>();
 function updateRouteTransactionName(request: Request, method: string, route: string): void {
  const transactionName = `${method} ${route}`;
 
+ function applyRouteToSpan(span: Span): void {
+ updateSpanName(span, transactionName);
+ span.setAttributes({
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [HTTP_ROUTE]: route,
+ });
+ }
+
  // Try the stored root span first (reliable across async contexts),
  // then fall back to getActiveSpan() for cases where async context is preserved.
  const rootSpan = rootSpanForRequest.get(request);
  if (rootSpan) {
- updateSpanName(rootSpan, transactionName);
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
+ applyRouteToSpan(rootSpan);
  } else {
  const activeSpan = getActiveSpan();
  if (activeSpan) {
  const root = getRootSpan(activeSpan);
- updateSpanName(root, transactionName);
- root.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
+ applyRouteToSpan(root);
  }
  }
 

packages/elysia/test/withElysia.test.ts

@@ -1,3 +1,4 @@
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 import type { ErrorContext } from 'elysia';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
@@ -32,6 +33,12 @@ const mockGetIsolationScope = vi.fn(() => ({
 const mockGetClient = vi.fn(() => ({
  on: vi.fn(),
 }));
+const mockRootSpan = {
+ setAttributes: vi.fn(),
+ updateName: vi.fn(),
+};
+const mockGetActiveSpan = vi.fn();
+const mockGetRootSpan = vi.fn(() => mockRootSpan);
 const mockGetTraceData = vi.fn(() => ({
  'sentry-trace': 'abc123-def456-1',
  baggage: 'sentry-environment=test,sentry-trace_id=abc123',
@@ -43,8 +50,10 @@ vi.mock('@sentry/core', async importActual => {
  return {
  ...actual,
  captureException: (...args: unknown[]) => mockCaptureException(...args),
+ getActiveSpan: () => mockGetActiveSpan(),
  getIsolationScope: () => mockGetIsolationScope(),
  getClient: () => mockGetClient(),
+ getRootSpan: () => mockGetRootSpan(),
  getTraceData: () => mockGetTraceData(),
  };
 });
@@ -88,6 +97,23 @@ describe('withElysia', () => {
  expect(headers['baggage']).toBe('sentry-environment=test,sentry-trace_id=abc123');
  });
 
+ it('sets the matched route on the root span', () => {
+ mockGetActiveSpan.mockReturnValueOnce(mockRootSpan);
+ // @ts-expect-error - mock app
+ withElysia(mockApp);
+
+ onAfterHandleHandler({
+ route: '/users/:id',
+ request: new Request('https://example.com/users/42', { method: 'GET' }),
+ set: { headers: {} },
+ });
+
+ expect(mockRootSpan.setAttributes).toHaveBeenCalledWith({
+ 'sentry.source': 'route',
+ [HTTP_ROUTE]: '/users/:id',
+ });
+ });
+
  it('does not set headers when trace data is empty', () => {
  mockGetTraceData.mockReturnValueOnce({});
  // @ts-expect-error - mock app

packages/hono/package.json

@@ -73,7 +73,8 @@
  },
  "dependencies": {
  "@opentelemetry/api": "^1.9.1",
- "@sentry/core": "10.67.0"
+ "@sentry/core": "10.67.0",
+ "@sentry/conventions": "^0.16.0"
  },
  "peerDependencies": {
  "@cloudflare/workers-types": "^4.x",

packages/hono/src/shared/middlewareHandlers.ts

@@ -15,6 +15,7 @@ import { defaultShouldHandleError } from './defaultShouldHandleError';
 import { resolveRouteName } from './resolveRouteName';
 import { type SentryHonoMiddlewareOptions } from '../shared/types';
 import { type GetConnInfo } from 'hono/conninfo';
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 
 /**
  * Request handler for Hono framework
@@ -99,7 +100,8 @@ export function responseHandler(
 }
 
 function updateSpanRouteName(isolationScope: Scope, context: Context): void {
- const routeName = `${context.req.method} ${resolveRouteName(context)}`;
+ const route = resolveRouteName(context);
+ const routeName = `${context.req.method} ${route}`;
  const activeSpan = getActiveSpan();
 
  if (activeSpan) {
@@ -108,7 +110,10 @@ function updateSpanRouteName(isolationScope: Scope, context: Context): void {
 
  const rootSpan = getRootSpan(activeSpan);
  updateSpanName(rootSpan, routeName);
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
+ rootSpan.setAttributes({
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [HTTP_ROUTE]: route,
+ });
  }
 
  isolationScope.setTransactionName(routeName);

packages/hono/test/shared/middlewareHandlers.test.ts

@@ -1,4 +1,5 @@
 import * as SentryCore from '@sentry/core';
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 import { requestHandler, responseHandler } from '../../src/shared/middlewareHandlers';
 
@@ -245,6 +246,18 @@ describe('responseHandler', () => {
 
  expect(mockSetTransactionName).toHaveBeenCalledWith('GET /test');
  });
+
+ it('sets http.route on the root span', () => {
+ getActiveSpanMock.mockReturnValue(mockRootSpan);
+
+ // oxlint-disable-next-line typescript/no-explicit-any
+ requestHandler(createMockContext(200) as any);
+
+ expect(mockRootSpan.setAttributes).toHaveBeenCalledWith({
+ 'sentry.source': 'route',
+ [HTTP_ROUTE]: '/test',
+ });
+ });
  });
 });
 

packages/nextjs/src/common/pages-router-instrumentation/wrapApiHandlerWithSentry.ts

@@ -18,7 +18,7 @@ import type { NextApiRequest } from 'next';
 import type { AugmentedNextApiResponse, NextApiHandler } from '../types';
 import { flushSafelyWithTimeout, waitUntil } from '../utils/responseEnd';
 import { dropNextjsRootContext, escapeNextjsTracing } from '../utils/tracingUtils';
-import { SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 
 export type AugmentedNextApiRequest = NextApiRequest & {
  __withSentry_applied__?: boolean;
@@ -95,6 +95,7 @@ export function wrapApiHandlerWithSentry(apiHandler: NextApiHandler, parameteriz
  [SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.http.nextjs',
  [URL_FULL]: urlObject && !isURLObjectRelative(urlObject) ? urlObject.href : undefined,
  [URL_PATH]: urlObject?.pathname,
+ [HTTP_ROUTE]: parameterizedRoute,
  },
  },
  async span => {

packages/nextjs/src/common/wrapRouteHandlerWithSentry.ts

@@ -20,6 +20,7 @@ import { isNotFoundNavigationError, isRedirectNavigationError } from './nextNavi
 import type { RouteHandlerContext } from './types';
 import { flushSafelyWithTimeout, waitUntil } from './utils/responseEnd';
 import { commonObjectToIsolationScope } from './utils/tracingUtils';
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 
 /**
  * Wraps a Next.js App Router Route handler with Sentry error and performance instrumentation.
@@ -47,8 +48,11 @@ export function wrapRouteHandlerWithSentry<F extends (...args: any[]) => any>(
  edgeRuntimeIsolationScopeOverride = isolationScope;
 
  rootSpan.updateName(`${method} ${parameterizedRoute}`);
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_OP, 'http.server');
+ rootSpan.setAttributes({
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [SEMANTIC_ATTRIBUTE_SENTRY_OP]: 'http.server',
+ [HTTP_ROUTE]: parameterizedRoute,
+ });
  }
 
  return withIsolationScope(

packages/nextjs/src/edge/wrapApiHandlerWithSentry.ts

@@ -18,7 +18,7 @@ import {
 import { addHeadersAsAttributes } from '../common/utils/addHeadersAsAttributes';
 import { flushSafelyWithTimeout, waitUntil } from '../common/utils/responseEnd';
 import type { EdgeRouteHandler } from './types';
-import { SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 
 /**
  * Wraps a Next.js edge route handler with Sentry error and performance instrumentation.
@@ -75,6 +75,7 @@ export function wrapApiHandlerWithSentry<H extends EdgeRouteHandler>(
  [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
  [URL_FULL]: rootSpanAttributes[URL_FULL] ?? urlAttributes[URL_FULL],
  [URL_PATH]: rootSpanAttributes[URL_PATH] ?? urlAttributes[URL_PATH],
+ [HTTP_ROUTE]: parameterizedRoute,
  ...headerAttributes,
  });
  setCapturedScopesOnSpan(rootSpan, currentScope, isolationScope);
@@ -93,6 +94,7 @@ export function wrapApiHandlerWithSentry<H extends EdgeRouteHandler>(
  [SENTRY_KIND]: 'server',
  [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
  [SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.function.nextjs.wrap_api_handler',
+ [HTTP_ROUTE]: parameterizedRoute,
  ...urlAttributes,
  ...headerAttributes,
  },

packages/nextjs/src/server/enhanceHandleRequestRootSpan.ts

@@ -47,6 +47,7 @@ export function enhanceHandleRequestRootSpan(span: MutableRootSpan): void {
  const cleanRoute = route.replace(/\/route$/, '');
  span.setName(`${method} ${cleanRoute}`);
  attributes[SEMANTIC_ATTRIBUTE_SENTRY_SOURCE] = 'route';
+ attributes[HTTP_ROUTE] = cleanRoute;
  // Preserve next.route in case it did not get hoisted
  attributes[ATTR_NEXT_ROUTE] = cleanRoute;
  }
@@ -55,6 +56,7 @@ export function enhanceHandleRequestRootSpan(span: MutableRootSpan): void {
  const routeBackfill = attributes[TRANSACTION_ATTR_SENTRY_ROUTE_BACKFILL];
  if (typeof routeBackfill === 'string' && span.getName() !== 'GET /_app') {
  span.setName(`${typeof method === 'string' ? method : 'GET'} ${routeBackfill}`);
+ attributes[HTTP_ROUTE] = attributes[HTTP_ROUTE] ?? routeBackfill;
  }
 
  const middlewareMatch =

packages/nextjs/test/config/withSentry.test.ts

@@ -1,5 +1,5 @@
 import * as SentryCore from '@sentry/core';
-import { SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 import { SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE } from '@sentry/core';
 import type { NextApiRequest, NextApiResponse } from 'next';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
@@ -56,6 +56,7 @@ describe('withSentry', () => {
  [SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.http.nextjs',
  [URL_FULL]: 'https://dogs.are.great/api/dogs?good=true',
  [URL_PATH]: '/api/dogs',
+ [HTTP_ROUTE]: '/my-parameterized-route',
  },
  },
  expect.any(Function),

packages/nextjs/test/edge/withSentryAPI.test.ts

@@ -1,4 +1,7 @@
-import { afterAll, afterEach, describe, it, vi } from 'vitest';
+import * as SentryCore from '@sentry/core';
+import { HTTP_ROUTE, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { SEMANTIC_ATTRIBUTE_SENTRY_OP, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE } from '@sentry/core';
+import { afterAll, afterEach, describe, expect, it, vi } from 'vitest';
 import { wrapApiHandlerWithSentry } from '../../src/edge';
 
 const origRequest = global.Request;
@@ -30,7 +33,7 @@ afterAll(() => {
 });
 
 afterEach(() => {
- vi.clearAllMocks();
+ vi.restoreAllMocks();
 });
 
 describe('wrapApiHandlerWithSentry', () => {
@@ -41,4 +44,50 @@ describe('wrapApiHandlerWithSentry', () => {
 
  await wrappedFunction();
  });
+
+ it('adds normalized request URL and route attributes to the active root span', async () => {
+ const rootSpan = {
+ updateName: vi.fn(),
+ setAttributes: vi.fn(),
+ };
+ vi.spyOn(SentryCore, 'getActiveSpan').mockReturnValueOnce({} as any);
+ vi.spyOn(SentryCore, 'getRootSpan').mockReturnValueOnce(rootSpan as any);
+ vi.spyOn(SentryCore, 'spanToJSON').mockReturnValueOnce({ data: {} } as any);
+ const origFunction = vi.fn(() => new Response());
+ const parameterizedRoute = '/user/[userId]/post/[postId]';
+ const wrappedFunction = wrapApiHandlerWithSentry(origFunction, parameterizedRoute);
+
+ await wrappedFunction(new Request('https://dogs.are.great/user/123/post/456?good=true'));
+
+ expect(rootSpan.updateName).toHaveBeenCalledWith(`POST ${parameterizedRoute}`);
+ expect(rootSpan.setAttributes).toHaveBeenCalledWith({
+ [SEMANTIC_ATTRIBUTE_SENTRY_OP]: 'http.server',
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [URL_FULL]: 'https://dogs.are.great/user/123/post/456?good=true',
+ [URL_PATH]: '/user/123/post/456',
+ [HTTP_ROUTE]: parameterizedRoute,
+ });
+ });
+
+ it('replaces a concrete root span route with the parameterized route', async () => {
+ const rootSpan = {
+ updateName: vi.fn(),
+ setAttributes: vi.fn(),
+ };
+ vi.spyOn(SentryCore, 'getActiveSpan').mockReturnValueOnce({} as any);
+ vi.spyOn(SentryCore, 'getRootSpan').mockReturnValueOnce(rootSpan as any);
+ vi.spyOn(SentryCore, 'spanToJSON').mockReturnValueOnce({
+ data: { [HTTP_ROUTE]: '/user/123/post/456' },
+ } as any);
+ const parameterizedRoute = '/user/[userId]/post/[postId]';
+ const wrappedFunction = wrapApiHandlerWithSentry(() => new Response(), parameterizedRoute);
+
+ await wrappedFunction(new Request('https://dogs.are.great/user/123/post/456'));
+
+ expect(rootSpan.setAttributes).toHaveBeenCalledWith(
+ expect.objectContaining({
+ [HTTP_ROUTE]: parameterizedRoute,
+ }),
+ );
+ });
 });

packages/nextjs/test/server/enhanceHandleRequestRootSpan.test.ts

@@ -1,3 +1,4 @@
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 import { SEMANTIC_ATTRIBUTE_SENTRY_OP, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE } from '@sentry/core';
 import { describe, expect, it } from 'vitest';
 import { ATTR_NEXT_ROUTE, ATTR_NEXT_SPAN_NAME, ATTR_NEXT_SPAN_TYPE } from '../../src/common/nextSpanAttributes';
@@ -48,6 +49,7 @@ describe('enhanceHandleRequestRootSpan', () => {
  expect(getName()).toBe('GET /api/users/[id]');
  expect(span.attributes[SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]).toBe('route');
  expect(span.attributes[ATTR_NEXT_ROUTE]).toBe('/api/users/[id]');
+ expect(span.attributes[HTTP_ROUTE]).toBe('/api/users/[id]');
  });
 
  it('strips trailing /route from app router route handler routes', () => {
@@ -64,6 +66,7 @@ describe('enhanceHandleRequestRootSpan', () => {
 
  expect(getName()).toBe('POST /api/widgets');
  expect(span.attributes[ATTR_NEXT_ROUTE]).toBe('/api/widgets');
+ expect(span.attributes[HTTP_ROUTE]).toBe('/api/widgets');
  });
 
  it('strips URL query and fragment from the segment name', () => {
@@ -105,6 +108,7 @@ describe('enhanceHandleRequestRootSpan', () => {
  enhanceHandleRequestRootSpan(span);
 
  expect(getName()).toBe('GET /posts/[slug]');
+ expect(span.attributes[HTTP_ROUTE]).toBe('/posts/[slug]');
  });
 
  it('does not apply the backfill for the special GET /_app transaction', () => {

dev-packages/e2e-tests/test-applications/create-remix-app-express/tests/server-transactions.test.ts

@@ -14,6 +14,7 @@ test('Sends parameterized transaction name to Sentry', async ({ page }) => {
 
  expect(transaction).toBeDefined();
  expect(transaction.transaction).toBe('GET user/:id');
+ expect(transaction.contexts?.trace?.data?.['http.route']).toBe('user/:id');
 });
 
 test('Sends form data with action span', async ({ page }) => {
@@ -271,6 +272,7 @@ test('Sends two linked transactions (server & client) to Sentry', async ({ page
  const pageLoadParentSpanId = pageloadTransaction.contexts?.trace?.parent_span_id;
 
  expect(httpServerTransaction.transaction).toBe('GET http://localhost:3030/');
+ expect(httpServerTransaction.contexts?.trace?.data?.['http.route']).toBeUndefined();
  expect(pageloadTransaction.transaction).toBe('/');
 
  expect(httpServerTraceId).toBeDefined();

dev-packages/e2e-tests/test-applications/nextjs-orpc/tests/orpc-tracing.test.ts

@@ -42,7 +42,7 @@ test('should trace orpc server component', async ({ page }) => {
  'http.method': 'POST',
  'http.target': '/rpc/planet/list',
  'next.rsc': false,
- 'http.route': '/rpc/[[...rest]]/route',
+ 'http.route': '/rpc/[[...rest]]',
  'next.route': '/rpc/[[...rest]]',
  'http.status_code': 200,
  },
@@ -99,7 +99,7 @@ test('should trace orpc client component', async ({ page }) => {
  'http.method': 'POST',
  'http.target': '/rpc/planet/find',
  'next.rsc': false,
- 'http.route': '/rpc/[[...rest]]/route',
+ 'http.route': '/rpc/[[...rest]]',
  'next.route': '/rpc/[[...rest]]',
  'http.status_code': 200,
  },

packages/elysia/src/withElysia.ts

@@ -1,4 +1,4 @@
-import { URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 import type { Span } from '@sentry/core';
 import {
  captureException,
@@ -60,18 +60,24 @@ const instrumentedApps = new WeakSet<Elysia>();
 function updateRouteTransactionName(request: Request, method: string, route: string): void {
  const transactionName = `${method} ${route}`;
 
+ function applyRouteToSpan(span: Span): void {
+ updateSpanName(span, transactionName);
+ span.setAttributes({
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [HTTP_ROUTE]: route,
+ });
+ }
+
  // Try the stored root span first (reliable across async contexts),
  // then fall back to getActiveSpan() for cases where async context is preserved.
  const rootSpan = rootSpanForRequest.get(request);
  if (rootSpan) {
- updateSpanName(rootSpan, transactionName);
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
+ applyRouteToSpan(rootSpan);
  } else {
  const activeSpan = getActiveSpan();
  if (activeSpan) {
  const root = getRootSpan(activeSpan);
- updateSpanName(root, transactionName);
- root.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
+ applyRouteToSpan(root);
  }
  }
 

packages/elysia/test/withElysia.test.ts

@@ -1,3 +1,4 @@
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 import type { ErrorContext } from 'elysia';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
@@ -32,6 +33,12 @@ const mockGetIsolationScope = vi.fn(() => ({
 const mockGetClient = vi.fn(() => ({
  on: vi.fn(),
 }));
+const mockRootSpan = {
+ setAttributes: vi.fn(),
+ updateName: vi.fn(),
+};
+const mockGetActiveSpan = vi.fn();
+const mockGetRootSpan = vi.fn(() => mockRootSpan);
 const mockGetTraceData = vi.fn(() => ({
  'sentry-trace': 'abc123-def456-1',
  baggage: 'sentry-environment=test,sentry-trace_id=abc123',
@@ -43,8 +50,10 @@ vi.mock('@sentry/core', async importActual => {
  return {
  ...actual,
  captureException: (...args: unknown[]) => mockCaptureException(...args),
+ getActiveSpan: () => mockGetActiveSpan(),
  getIsolationScope: () => mockGetIsolationScope(),
  getClient: () => mockGetClient(),
+ getRootSpan: () => mockGetRootSpan(),
  getTraceData: () => mockGetTraceData(),
  };
 });
@@ -88,6 +97,23 @@ describe('withElysia', () => {
  expect(headers['baggage']).toBe('sentry-environment=test,sentry-trace_id=abc123');
  });
 
+ it('sets the matched route on the root span', () => {
+ mockGetActiveSpan.mockReturnValueOnce(mockRootSpan);
+ // @ts-expect-error - mock app
+ withElysia(mockApp);
+
+ onAfterHandleHandler({
+ route: '/users/:id',
+ request: new Request('https://example.com/users/42', { method: 'GET' }),
+ set: { headers: {} },
+ });
+
+ expect(mockRootSpan.setAttributes).toHaveBeenCalledWith({
+ 'sentry.source': 'route',
+ [HTTP_ROUTE]: '/users/:id',
+ });
+ });
+
  it('does not set headers when trace data is empty', () => {
  mockGetTraceData.mockReturnValueOnce({});
  // @ts-expect-error - mock app

packages/hono/package.json

@@ -73,7 +73,8 @@
  },
  "dependencies": {
  "@opentelemetry/api": "^1.9.1",
- "@sentry/core": "10.67.0"
+ "@sentry/core": "10.67.0",
+ "@sentry/conventions": "^0.16.0"
  },
  "peerDependencies": {
  "@cloudflare/workers-types": "^4.x",

packages/hono/src/shared/middlewareHandlers.ts

@@ -15,6 +15,7 @@ import { defaultShouldHandleError } from './defaultShouldHandleError';
 import { resolveRouteName } from './resolveRouteName';
 import { type SentryHonoMiddlewareOptions } from '../shared/types';
 import { type GetConnInfo } from 'hono/conninfo';
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 
 /**
  * Request handler for Hono framework
@@ -99,7 +100,8 @@ export function responseHandler(
 }
 
 function updateSpanRouteName(isolationScope: Scope, context: Context): void {
- const routeName = `${context.req.method} ${resolveRouteName(context)}`;
+ const route = resolveRouteName(context);
+ const routeName = `${context.req.method} ${route}`;
  const activeSpan = getActiveSpan();
 
  if (activeSpan) {
@@ -108,7 +110,10 @@ function updateSpanRouteName(isolationScope: Scope, context: Context): void {
 
  const rootSpan = getRootSpan(activeSpan);
  updateSpanName(rootSpan, routeName);
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
+ rootSpan.setAttributes({
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [HTTP_ROUTE]: route,
+ });
  }
 
  isolationScope.setTransactionName(routeName);

packages/hono/test/shared/middlewareHandlers.test.ts

@@ -1,4 +1,5 @@
 import * as SentryCore from '@sentry/core';
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 import { requestHandler, responseHandler } from '../../src/shared/middlewareHandlers';
 
@@ -245,6 +246,18 @@ describe('responseHandler', () => {
 
  expect(mockSetTransactionName).toHaveBeenCalledWith('GET /test');
  });
+
+ it('sets http.route on the root span', () => {
+ getActiveSpanMock.mockReturnValue(mockRootSpan);
+
+ // oxlint-disable-next-line typescript/no-explicit-any
+ requestHandler(createMockContext(200) as any);
+
+ expect(mockRootSpan.setAttributes).toHaveBeenCalledWith({
+ 'sentry.source': 'route',
+ [HTTP_ROUTE]: '/test',
+ });
+ });
  });
 });
 

packages/nextjs/src/common/pages-router-instrumentation/wrapApiHandlerWithSentry.ts

@@ -18,7 +18,7 @@ import type { NextApiRequest } from 'next';
 import type { AugmentedNextApiResponse, NextApiHandler } from '../types';
 import { flushSafelyWithTimeout, waitUntil } from '../utils/responseEnd';
 import { dropNextjsRootContext, escapeNextjsTracing } from '../utils/tracingUtils';
-import { SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 
 export type AugmentedNextApiRequest = NextApiRequest & {
  __withSentry_applied__?: boolean;
@@ -95,6 +95,7 @@ export function wrapApiHandlerWithSentry(apiHandler: NextApiHandler, parameteriz
  [SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.http.nextjs',
  [URL_FULL]: urlObject && !isURLObjectRelative(urlObject) ? urlObject.href : undefined,
  [URL_PATH]: urlObject?.pathname,
+ [HTTP_ROUTE]: parameterizedRoute,
  },
  },
  async span => {

packages/nextjs/src/common/wrapRouteHandlerWithSentry.ts

@@ -20,6 +20,7 @@ import { isNotFoundNavigationError, isRedirectNavigationError } from './nextNavi
 import type { RouteHandlerContext } from './types';
 import { flushSafelyWithTimeout, waitUntil } from './utils/responseEnd';
 import { commonObjectToIsolationScope } from './utils/tracingUtils';
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 
 /**
  * Wraps a Next.js App Router Route handler with Sentry error and performance instrumentation.
@@ -47,8 +48,11 @@ export function wrapRouteHandlerWithSentry<F extends (...args: any[]) => any>(
  edgeRuntimeIsolationScopeOverride = isolationScope;
 
  rootSpan.updateName(`${method} ${parameterizedRoute}`);
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'route');
- rootSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_OP, 'http.server');
+ rootSpan.setAttributes({
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [SEMANTIC_ATTRIBUTE_SENTRY_OP]: 'http.server',
+ [HTTP_ROUTE]: parameterizedRoute,
+ });
  }
 
  return withIsolationScope(

packages/nextjs/src/edge/wrapApiHandlerWithSentry.ts

@@ -18,7 +18,7 @@ import {
 import { addHeadersAsAttributes } from '../common/utils/addHeadersAsAttributes';
 import { flushSafelyWithTimeout, waitUntil } from '../common/utils/responseEnd';
 import type { EdgeRouteHandler } from './types';
-import { SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 
 /**
  * Wraps a Next.js edge route handler with Sentry error and performance instrumentation.
@@ -75,6 +75,7 @@ export function wrapApiHandlerWithSentry<H extends EdgeRouteHandler>(
  [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
  [URL_FULL]: rootSpanAttributes[URL_FULL] ?? urlAttributes[URL_FULL],
  [URL_PATH]: rootSpanAttributes[URL_PATH] ?? urlAttributes[URL_PATH],
+ [HTTP_ROUTE]: parameterizedRoute,
  ...headerAttributes,
  });
  setCapturedScopesOnSpan(rootSpan, currentScope, isolationScope);
@@ -93,6 +94,7 @@ export function wrapApiHandlerWithSentry<H extends EdgeRouteHandler>(
  [SENTRY_KIND]: 'server',
  [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
  [SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.function.nextjs.wrap_api_handler',
+ [HTTP_ROUTE]: parameterizedRoute,
  ...urlAttributes,
  ...headerAttributes,
  },

packages/nextjs/src/server/enhanceHandleRequestRootSpan.ts

@@ -47,6 +47,7 @@ export function enhanceHandleRequestRootSpan(span: MutableRootSpan): void {
  const cleanRoute = route.replace(/\/route$/, '');
  span.setName(`${method} ${cleanRoute}`);
  attributes[SEMANTIC_ATTRIBUTE_SENTRY_SOURCE] = 'route';
+ attributes[HTTP_ROUTE] = cleanRoute;
  // Preserve next.route in case it did not get hoisted
  attributes[ATTR_NEXT_ROUTE] = cleanRoute;
  }
@@ -55,6 +56,7 @@ export function enhanceHandleRequestRootSpan(span: MutableRootSpan): void {
  const routeBackfill = attributes[TRANSACTION_ATTR_SENTRY_ROUTE_BACKFILL];
  if (typeof routeBackfill === 'string' && span.getName() !== 'GET /_app') {
  span.setName(`${typeof method === 'string' ? method : 'GET'} ${routeBackfill}`);
+ attributes[HTTP_ROUTE] = attributes[HTTP_ROUTE] ?? routeBackfill;
  }
 
  const middlewareMatch =

packages/nextjs/test/config/withSentry.test.ts

@@ -1,5 +1,5 @@
 import * as SentryCore from '@sentry/core';
-import { SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { HTTP_ROUTE, SENTRY_KIND, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
 import { SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE } from '@sentry/core';
 import type { NextApiRequest, NextApiResponse } from 'next';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
@@ -56,6 +56,7 @@ describe('withSentry', () => {
  [SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.http.nextjs',
  [URL_FULL]: 'https://dogs.are.great/api/dogs?good=true',
  [URL_PATH]: '/api/dogs',
+ [HTTP_ROUTE]: '/my-parameterized-route',
  },
  },
  expect.any(Function),

packages/nextjs/test/edge/withSentryAPI.test.ts

@@ -1,4 +1,7 @@
-import { afterAll, afterEach, describe, it, vi } from 'vitest';
+import * as SentryCore from '@sentry/core';
+import { HTTP_ROUTE, URL_FULL, URL_PATH } from '@sentry/conventions/attributes';
+import { SEMANTIC_ATTRIBUTE_SENTRY_OP, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE } from '@sentry/core';
+import { afterAll, afterEach, describe, expect, it, vi } from 'vitest';
 import { wrapApiHandlerWithSentry } from '../../src/edge';
 
 const origRequest = global.Request;
@@ -30,7 +33,7 @@ afterAll(() => {
 });
 
 afterEach(() => {
- vi.clearAllMocks();
+ vi.restoreAllMocks();
 });
 
 describe('wrapApiHandlerWithSentry', () => {
@@ -41,4 +44,50 @@ describe('wrapApiHandlerWithSentry', () => {
 
  await wrappedFunction();
  });
+
+ it('adds normalized request URL and route attributes to the active root span', async () => {
+ const rootSpan = {
+ updateName: vi.fn(),
+ setAttributes: vi.fn(),
+ };
+ vi.spyOn(SentryCore, 'getActiveSpan').mockReturnValueOnce({} as any);
+ vi.spyOn(SentryCore, 'getRootSpan').mockReturnValueOnce(rootSpan as any);
+ vi.spyOn(SentryCore, 'spanToJSON').mockReturnValueOnce({ data: {} } as any);
+ const origFunction = vi.fn(() => new Response());
+ const parameterizedRoute = '/user/[userId]/post/[postId]';
+ const wrappedFunction = wrapApiHandlerWithSentry(origFunction, parameterizedRoute);
+
+ await wrappedFunction(new Request('https://dogs.are.great/user/123/post/456?good=true'));
+
+ expect(rootSpan.updateName).toHaveBeenCalledWith(`POST ${parameterizedRoute}`);
+ expect(rootSpan.setAttributes).toHaveBeenCalledWith({
+ [SEMANTIC_ATTRIBUTE_SENTRY_OP]: 'http.server',
+ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route',
+ [URL_FULL]: 'https://dogs.are.great/user/123/post/456?good=true',
+ [URL_PATH]: '/user/123/post/456',
+ [HTTP_ROUTE]: parameterizedRoute,
+ });
+ });
+
+ it('replaces a concrete root span route with the parameterized route', async () => {
+ const rootSpan = {
+ updateName: vi.fn(),
+ setAttributes: vi.fn(),
+ };
+ vi.spyOn(SentryCore, 'getActiveSpan').mockReturnValueOnce({} as any);
+ vi.spyOn(SentryCore, 'getRootSpan').mockReturnValueOnce(rootSpan as any);
+ vi.spyOn(SentryCore, 'spanToJSON').mockReturnValueOnce({
+ data: { [HTTP_ROUTE]: '/user/123/post/456' },
+ } as any);
+ const parameterizedRoute = '/user/[userId]/post/[postId]';
+ const wrappedFunction = wrapApiHandlerWithSentry(() => new Response(), parameterizedRoute);
+
+ await wrappedFunction(new Request('https://dogs.are.great/user/123/post/456'));
+
+ expect(rootSpan.setAttributes).toHaveBeenCalledWith(
+ expect.objectContaining({
+ [HTTP_ROUTE]: parameterizedRoute,
+ }),
+ );
+ });
 });

packages/nextjs/test/server/enhanceHandleRequestRootSpan.test.ts

@@ -1,3 +1,4 @@
+import { HTTP_ROUTE } from '@sentry/conventions/attributes';
 import { SEMANTIC_ATTRIBUTE_SENTRY_OP, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE } from '@sentry/core';
 import { describe, expect, it } from 'vitest';
 import { ATTR_NEXT_ROUTE, ATTR_NEXT_SPAN_NAME, ATTR_NEXT_SPAN_TYPE } from '../../src/common/nextSpanAttributes';
@@ -48,6 +49,7 @@ describe('enhanceHandleRequestRootSpan', () => {
  expect(getName()).toBe('GET /api/users/[id]');
  expect(span.attributes[SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]).toBe('route');
  expect(span.attributes[ATTR_NEXT_ROUTE]).toBe('/api/users/[id]');
+ expect(span.attributes[HTTP_ROUTE]).toBe('/api/users/[id]');
  });
 
  it('strips trailing /route from app router route handler routes', () => {
@@ -64,6 +66,7 @@ describe('enhanceHandleRequestRootSpan', () => {
 
  expect(getName()).toBe('POST /api/widgets');
  expect(span.attributes[ATTR_NEXT_ROUTE]).toBe('/api/widgets');
+ expect(span.attributes[HTTP_ROUTE]).toBe('/api/widgets');
  });
 
  it('strips URL query and fragment from the segment name', () => {
@@ -105,6 +108,7 @@ describe('enhanceHandleRequestRootSpan', () => {
  enhanceHandleRequestRootSpan(span);
 
  expect(getName()).toBe('GET /posts/[slug]');
+ expect(span.attributes[HTTP_ROUTE]).toBe('/posts/[slug]');
  });
 
  it('does not apply the backfill for the special GET /_app transaction', () => {