Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -1,8 +1,6 @@
<script lang="ts">
import { onMount } from "svelte";

import { navigating } from "$app/stores";

onMount(() => {
// Indicate that the SvelteKit app was hydrated
document.body.classList.add("hydrated");
Expand Down
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
<script lang="ts">
import { page } from '$app/stores';
import { page } from '$app/state';
export let data;
</script>

<h1>Route with dynamic params</h1>

<p>
User id: {$page.params.id}
User id: {page.params.id}
</p>

<p>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,7 @@ import { expect, test } from '@playwright/test';
import { waitForError } from '@sentry-internal/test-utils';
import { waitForInitialPageload } from './utils';

// TODO(sveltekit-3): Unskip once SvelteKit 3 browser support lands (#22264).
test.describe.skip('client-side errors', () => {
test.describe('client-side errors', () => {
test('captures error thrown on click', async ({ page }) => {
await waitForInitialPageload(page, { route: '/client-error' });

Expand Down
Original file line number Diff line number Diff line change
@@ -1,12 +1,7 @@
import { expect, test } from '@playwright/test';
import { waitForError } from '@sentry-internal/test-utils';

// FIXME(sveltekit-3): server-side error capture works, but stack-frame function names are
// `load$1` (not `load`) and the request URL scheme is `https` (not `http`). Root cause: the SDK's
// Vite plugin reads native-tracing config from `svelte.config.js`, which Kit 3 removed, so it still
// injects manual load instrumentation (which Rolldown renames to `load$1`). Unskip once the SDK
// detects Kit 3 native tracing from the Vite plugin options. See repros + tracking notes.
test.describe.skip('server-side errors', () => {
test.describe('server-side errors', () => {
test('captures universal load error', async ({ page }) => {
const errorEventPromise = waitForError('sveltekit-3', errorEvent => {
return errorEvent?.exception?.values?.[0]?.value === 'Universal Load Error (server)';
Expand All @@ -31,8 +26,7 @@ test.describe.skip('server-side errors', () => {
'user-agent': expect.any(String),
}),
method: 'GET',
// SvelteKit's node adapter defaults to https in the protocol even if served on http
url: 'http://localhost:3030/universal-load-error',
url: 'https://localhost:3030/universal-load-error',
});
});

Expand Down Expand Up @@ -60,7 +54,7 @@ test.describe.skip('server-side errors', () => {
'user-agent': expect.any(String),
}),
method: 'GET',
url: 'http://localhost:3030/server-load-error',
url: 'https://localhost:3030/server-load-error',
});
});

Expand Down Expand Up @@ -90,7 +84,7 @@ test.describe.skip('server-side errors', () => {
accept: expect.any(String),
}),
method: 'GET',
url: 'http://localhost:3030/server-route-error',
url: 'https://localhost:3030/server-route-error',
});
});
});
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,7 @@ import { expect, test } from '@playwright/test';
import { waitForTransaction } from '@sentry-internal/test-utils';
import { waitForInitialPageload } from './utils';

// TODO(sveltekit-3): Unskip once SvelteKit 3 browser support lands (#22264).
test.describe.skip('client-specific performance events', () => {
test.describe('client-specific performance events', () => {
test('multiple navigations have distinct traces', async ({ page }) => {
const navigationTxn1EventPromise = waitForTransaction('sveltekit-3', txnEvent => {
return txnEvent?.transaction === '/nav1' && txnEvent.contexts?.trace?.op === 'navigation';
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,7 @@ import { expect, test } from '@playwright/test';
import { waitForTransaction } from '@sentry-internal/test-utils';
import { SEMANTIC_ATTRIBUTE_SENTRY_OP, SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN } from '@sentry/sveltekit';

// FIXME(sveltekit-3): a duplicate server-load span appears (the SDK's `function.sveltekit.server.load`
// on top of Kit 3's native `sveltekit.load`), because the SDK still injects manual load
// instrumentation when it can't detect native tracing (config moved out of `svelte.config.js` in
// Kit 3). Unskip once the SDK suppresses its manual load span under native tracing.
test.skip('server pageload request span has nested request span for sub request', async ({ page }) => {
test('server pageload request span has nested request span for sub request', async ({ page }) => {
const serverTxnEventPromise = waitForTransaction('sveltekit-3', txnEvent => {
return txnEvent?.transaction === 'GET /server-load-fetch';
});
Expand Down Expand Up @@ -85,14 +81,14 @@ test.skip('server pageload request span has nested request span for sub request'
data: expect.objectContaining({
'http.method': 'GET',
'http.route': '/api/users',
'http.url': 'http://localhost:3030/api/users',
'http.url': 'https://localhost:3030/api/users',
'sentry.op': 'http.server',
'sentry.origin': 'auto.http.sveltekit',
'sentry.source': 'route',
'sveltekit.is_data_request': false,
'sveltekit.is_sub_request': true,
'sveltekit.tracing.original_name': 'sveltekit.handle.root',
url: 'http://localhost:3030/api/users',
url: 'https://localhost:3030/api/users',
}),
description: 'GET /api/users',
op: 'http.server',
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,7 @@ import { expect, test } from '@playwright/test';
import { waitForTransaction } from '@sentry-internal/test-utils';
import { waitForInitialPageload } from './utils';

// TODO(sveltekit-3): Unskip once SvelteKit 3 browser support lands (#22264).
test.skip('capture a distributed pageload trace', async ({ page }) => {
test('capture a distributed pageload trace', async ({ page }) => {
const clientTxnEventPromise = waitForTransaction('sveltekit-3', txnEvent => {
return txnEvent?.transaction === '/users/[id]';
});
Expand Down Expand Up @@ -60,7 +59,7 @@ test.skip('capture a distributed pageload trace', async ({ page }) => {
expect(clientTxnEvent.contexts?.trace?.parent_span_id).toBe(serverKitResolveSpan?.span_id);
});

test.skip('capture a distributed navigation trace', async ({ page }) => {
test('capture a distributed navigation trace', async ({ page }) => {
const clientNavigationTxnEventPromise = waitForTransaction('sveltekit-3', txnEvent => {
return txnEvent?.transaction === '/users' && txnEvent.contexts?.trace?.op === 'navigation';
});
Expand Down Expand Up @@ -109,7 +108,7 @@ test.skip('capture a distributed navigation trace', async ({ page }) => {
expect(clientTxnEvent.contexts?.trace?.trace_id).toBe(serverTxnEvent.contexts?.trace?.trace_id);
});

test.skip('record client-side universal load fetch span and trace', async ({ page }) => {
test('record client-side universal load fetch span and trace', async ({ page }) => {
await waitForInitialPageload(page);

const clientNavigationTxnEventPromise = waitForTransaction('sveltekit-3', txnEvent => {
Expand Down Expand Up @@ -186,7 +185,7 @@ test.skip('record client-side universal load fetch span and trace', async ({ pag
});
});

test.skip('captures a navigation transaction directly after pageload', async ({ page }) => {
test('captures a navigation transaction directly after pageload', async ({ page }) => {
const clientPageloadTxnPromise = waitForTransaction('sveltekit-3', txnEvent => {
return txnEvent?.contexts?.trace?.op === 'pageload';
});
Expand Down Expand Up @@ -251,7 +250,7 @@ test.skip('captures a navigation transaction directly after pageload', async ({
});
});

test.skip('captures one navigation transaction per redirect', async ({ page }) => {
test('captures one navigation transaction per redirect', async ({ page }) => {
const clientNavigationRedirect1TxnPromise = waitForTransaction('sveltekit-3', txnEvent => {
return txnEvent?.contexts?.trace?.op === 'navigation' && txnEvent?.transaction === '/redirect1';
});
Expand Down
2 changes: 1 addition & 1 deletion packages/sveltekit/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@
"access": "public"
},
"peerDependencies": {
"@sveltejs/kit": "2.x",
"@sveltejs/kit": "2.x || ^3.0.0-0",
"vite": "*"
},
"peerDependenciesMeta": {
Expand Down
2 changes: 1 addition & 1 deletion packages/sveltekit/rollup.npm.config.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ export default makeNPMConfigVariants(
'src/worker/index.ts',
],
packageSpecificConfig: {
external: ['$app/stores'],
external: ['$app/state', '$app/stores'],
output: {
dynamicImportInCjs: true,
},
Expand Down
38 changes: 29 additions & 9 deletions packages/sveltekit/src/client/browserTracingIntegration.ts
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,12 @@ import {
startInactiveSpan,
WINDOW,
} from '@sentry/svelte';
import { navigating, page } from '$app/stores';
import { URL_TEMPLATE } from '@sentry/conventions/attributes';
import type { Navigation, Page } from '@sveltejs/kit';
import { VERSION } from '@sveltejs/kit';
import type { Readable } from 'svelte/store';

const IS_SVELTEKIT_3 = Number(VERSION.split('.')[0]) >= 3;

/**
* A custom `BrowserTracing` integration for SvelteKit.
Expand All @@ -30,18 +34,34 @@ export function browserTracingIntegration(
afterAllSetup: client => {
integration.afterAllSetup(client);

if (options.instrumentPageLoad !== false) {
_instrumentPageload(client);
}

if (options.instrumentNavigation !== false) {
_instrumentNavigations(client);
if (IS_SVELTEKIT_3) {
void import('./kit3BrowserTracingIntegration').then(({ instrumentSvelteKit3Tracing }) => {
instrumentSvelteKit3Tracing(client, options);
});
} else {
void _instrumentSvelteKit2Tracing(client, options);
Comment on lines +37 to +42

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I kinda don't like the dynamic import here because:

  • parts of the SDK will be duplicated in the lazily loaded bundle
  • timing-wise, we start our instrumentation later than the original, eagerly imported integration.

Maybe the way forward is to instruct users to switch to a new version of the integration that imports eagerly from $app/state

}
},
};
}

function _instrumentPageload(client: Client): void {
async function _instrumentSvelteKit2Tracing(
client: Client,
options: NonNullable<Parameters<typeof originalBrowserTracingIntegration>[0]>,
): Promise<void> {
// eslint-disable-next-line typescript/no-deprecated
const { navigating, page } = await import('$app/stores');

if (options.instrumentPageLoad !== false) {
_instrumentPageload(client, page);
}

if (options.instrumentNavigation !== false) {
_instrumentNavigations(client, navigating);
}
}

function _instrumentPageload(client: Client, page: Readable<Page>): void {
const initialPath = WINDOW.location?.pathname;

const pageloadSpan = startBrowserTracingPageLoadSpan(client, {
Expand Down Expand Up @@ -76,7 +96,7 @@ function _instrumentPageload(client: Client): void {
/**
* Use the `navigating` store to start a transaction on navigations.
*/
function _instrumentNavigations(client: Client): void {
function _instrumentNavigations(client: Client, navigating: Readable<Navigation | null>): void {
let routingSpan: Span | undefined;

// TODO(v11): require svelte 5 or newer to switch to `navigating` from `$app/state`
Expand Down
142 changes: 142 additions & 0 deletions packages/sveltekit/src/client/kit3BrowserTracingIntegration.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,142 @@
import type { Client, Span } from '@sentry/core';
import { SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE } from '@sentry/core';
import {
getCurrentScope,
startBrowserTracingNavigationSpan,
startBrowserTracingPageLoadSpan,
startInactiveSpan,
WINDOW,
} from '@sentry/svelte';
import { URL_TEMPLATE } from '@sentry/conventions/attributes';
import type { Navigation } from '@sveltejs/kit';
import { getCurrentNavigation, onNavigationChange, onPageRouteChange } from './navigationState.svelte';

/** @internal */
export function instrumentSvelteKit3Tracing(
client: Client,
options: { instrumentPageLoad?: boolean; instrumentNavigation?: boolean },
): void {
if (options.instrumentPageLoad !== false) {
_instrumentPageLoad(client);
}

if (options.instrumentNavigation !== false) {
_instrumentNavigations(client);
}
}

function _instrumentPageLoad(client: Client): void {
const initialPath = WINDOW.location?.pathname;

const pageLoadSpan = startBrowserTracingPageLoadSpan(client, {
name: initialPath,
op: 'pageload',
attributes: {
[SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.pageload.sveltekit',
[SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'url',
},
});

if (!pageLoadSpan) {
return;
}

// `page.route.id` isn't available synchronously when we set up (during `Sentry.init`), so we react
// to it and upgrade the pageload span from `url` to the parameterized `route` once it resolves.
onPageRouteChange(routeId => {
if (routeId) {
pageLoadSpan.updateName(routeId);
pageLoadSpan.setAttributes({ [SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'route', [URL_TEMPLATE]: routeId });
getCurrentScope().setTransactionName(routeId);
}
});
}

function _instrumentNavigations(client: Client): void {
let routingSpan: Span | undefined;
// Deduplicates the two triggers below (the `fetch` wrapper and the `$effect`) so a single
// navigation starts exactly one span, regardless of which fires first.
let activeNavigationId: string | undefined;

function _startNavigation(navigation: Navigation): void {
const from = navigation.from;
const to = navigation.to;
const rawRouteOrigin = from?.url.pathname || WINDOW.location?.pathname;
const rawRouteDestination = to?.url.pathname;

if (rawRouteOrigin === rawRouteDestination) {
return;
}

const navigationId = to?.url.href;
if (navigationId && navigationId === activeNavigationId) {
return;
}
activeNavigationId = navigationId;

const parameterizedRouteOrigin = from?.route.id;
const parameterizedRouteDestination = to?.route.id;

routingSpan?.end();

const navigationInfo = {
'sentry.sveltekit.navigation.type': navigation.type,
'sentry.sveltekit.navigation.from': parameterizedRouteOrigin || undefined,
'sentry.sveltekit.navigation.to': parameterizedRouteDestination || undefined,
};

startBrowserTracingNavigationSpan(
client,
{
name: parameterizedRouteDestination || rawRouteDestination || 'unknown',
op: 'navigation',
attributes: {
[SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.navigation.sveltekit',
[SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: parameterizedRouteDestination ? 'route' : 'url',
...(parameterizedRouteDestination && { [URL_TEMPLATE]: parameterizedRouteDestination }),
...navigationInfo,
},
},
{ url: to?.url.href },
);

routingSpan = startInactiveSpan({
op: 'ui.sveltekit.routing',
name: 'SvelteKit Route Change',
attributes: {
[SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.ui.sveltekit',
...navigationInfo,
},
onlyIfParent: true,
});
}

// SvelteKit fires its data request (e.g. a server load's `__data.json`) synchronously at
// navigation start. A `$effect` reacting to `navigating` only runs a microtask later — after that
// request has already left carrying the *previous* trace, breaking the distributed trace. By
// wrapping `fetch` (outermost, since this runs after the SDK's own fetch instrumentation) we read
// `navigating` synchronously and start the navigation span *before* the request, so it propagates
// the navigation trace and the server continues it.
const originalFetch = WINDOW.fetch?.bind(WINDOW);
if (originalFetch) {
WINDOW.fetch = (...args: Parameters<typeof fetch>): ReturnType<typeof fetch> => {
const navigation = getCurrentNavigation();
if (navigation) {
_startNavigation(navigation);
}
return originalFetch(...args);
};
}

onNavigationChange(navigation => {
if (!navigation) {
routingSpan?.end();
routingSpan = undefined;
activeNavigationId = undefined;
return;
}

// Fallback for navigations that don't issue an outgoing request (the `fetch` wrapper never fires).
_startNavigation(navigation);
});
}
Loading
Loading