Skip to content

fix(angular): Ensure navigations always create a transaction #10646

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Feb 14, 2024
Merged
Show file tree
Hide file tree
Changes from 1 commit
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
14 changes: 11 additions & 3 deletions dev-packages/e2e-tests/test-applications/angular-17/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,8 @@
"scripts": {
"ng": "ng",
"dev": "ng serve",
"preview": "http-server dist/angular-17/browser",
"proxy": "ts-node-script start-event-proxy.ts",
"preview": "http-server dist/angular-17/browser --port 8080",
"build": "ng build",
"watch": "ng build --watch --configuration development",
"test": "playwright test",
Expand All @@ -22,6 +23,7 @@
"@angular/platform-browser": "^17.1.0",
"@angular/platform-browser-dynamic": "^17.1.0",
"@angular/router": "^17.1.0",
"@sentry/angular-ivy": "* || latest",
"rxjs": "~7.8.0",
"tslib": "^2.3.0",
"zone.js": "~0.14.3"
Expand All @@ -31,7 +33,6 @@
"@angular/cli": "^17.1.1",
"@angular/compiler-cli": "^17.1.0",
"@playwright/test": "^1.41.1",
"@sentry/angular-ivy": "latest || *",
"@types/jasmine": "~5.1.0",
"http-server": "^14.1.1",
"jasmine-core": "~5.1.0",
Expand All @@ -40,11 +41,18 @@
"karma-coverage": "~2.2.0",
"karma-jasmine": "~5.1.0",
"karma-jasmine-html-reporter": "~2.1.0",
"typescript": "~5.3.2",
"ts-node": "10.9.1",
"typescript": "~5.3.2",
"wait-port": "1.0.4"
},
"volta": {
"extends": "../../package.json"
},
"pnpm": {
"overrides": {
"@sentry/browser": "latest || *",
"@sentry/core": "latest || *",
"@sentry/utils": "latest || *"
}
Comment on lines +52 to +56
Copy link
Member Author

Choose a reason for hiding this comment

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

Noticed that this seems to be required to ensure the local/verdaccio version of the dependencies of @sentry/angular-ivy are taken instead of the ones uploaded to NPM.

}
}
Original file line number Diff line number Diff line change
Expand Up @@ -29,8 +29,8 @@ const config: PlaywrightTestConfig = {
*/
timeout: 10000,
},
/* Run tests in files in parallel */
fullyParallel: true,
fullyParallel: false,
workers: 1,
/* Fail the build on CI if you accidentally left test.only in the source code. */
Comment on lines +32 to 34
Copy link
Member Author

Choose a reason for hiding this comment

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

Just to avoid bleeds of events due to the proxy. 5 tests shouldn't make much difference here.

forbidOnly: !!process.env.CI,
/* `next dev` is incredibly buggy with the app dir */
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,18 @@ export const routes: Routes = [
path: 'home',
component: HomeComponent,
},
{
path: 'redirect1',
redirectTo: '/redirect2',
},
{
path: 'redirect2',
redirectTo: '/redirect3',
},
{
path: 'redirect3',
redirectTo: '/users/456',
},
Comment on lines +14 to +25
Copy link
Member Author

Choose a reason for hiding this comment

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

Although these are 3 redirects, we'll only get one navigation root span and one routing span for them. I think this is fine (3 routing spans would have been nice to have but whatever)

{
path: '**',
redirectTo: 'home',
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ import { RouterLink } from '@angular/router';
<h1>Welcome to Sentry's Angular 17 E2E test app</h1>
<ul>
<li> <a id="navLink" [routerLink]="['/users', '123']">Visit User 123</a> </li>
<li> <a id="redirectLink" [routerLink]="['/redirect1']">Redirect</a> </li>
</ul>
<button id="errorBtn" (click)="throwError()">Throw error</button>
</main>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -52,3 +52,77 @@ test('sends a navigation transaction with a parameterized URL', async ({ page })
},
});
});

test('sends a navigation transaction even if the pageload span is still active', async ({ page }) => {
const pageloadTxnPromise = waitForTransaction('angular-17', async transactionEvent => {
return !!transactionEvent?.transaction && transactionEvent.contexts?.trace?.op === 'pageload';
});

const navigationTxnPromise = waitForTransaction('angular-17', async transactionEvent => {
return !!transactionEvent?.transaction && transactionEvent.contexts?.trace?.op === 'navigation';
});

await page.goto(`/`);

// immediately navigate to a different route
const [_, pageloadTxn, navigationTxn] = await Promise.all([
page.locator('#navLink').click(),
pageloadTxnPromise,
navigationTxnPromise,
]);

expect(pageloadTxn).toMatchObject({
contexts: {
trace: {
op: 'pageload',
origin: 'auto.pageload.angular',
},
},
transaction: '/home/',
transaction_info: {
source: 'route',
},
});

expect(navigationTxn).toMatchObject({
contexts: {
trace: {
op: 'navigation',
origin: 'auto.navigation.angular',
},
},
transaction: '/users/:id/',
transaction_info: {
source: 'route',
},
});
});

test('groups redirects within one navigation root span', async ({ page }) => {
const navigationTxnPromise = waitForTransaction('angular-17', async transactionEvent => {
return !!transactionEvent?.transaction && transactionEvent.contexts?.trace?.op === 'navigation';
});

await page.goto(`/`);

// immediately navigate to a different route
const [_, navigationTxn] = await Promise.all([page.locator('#redirectLink').click(), navigationTxnPromise]);

expect(navigationTxn).toMatchObject({
contexts: {
trace: {
op: 'navigation',
origin: 'auto.navigation.angular',
},
},
transaction: '/users/:id/',
transaction_info: {
source: 'route',
},
});

const routingSpan = navigationTxn.spans?.find(span => span.op === 'ui.angular.routing');

expect(routingSpan).toBeDefined();
expect(routingSpan?.description).toBe('/redirect1');
});
37 changes: 24 additions & 13 deletions packages/angular/src/tracing.ts
Original file line number Diff line number Diff line change
Expand Up @@ -8,19 +8,14 @@ import type { ActivatedRouteSnapshot, Event, RouterState } from '@angular/router
import { NavigationCancel, NavigationError, Router } from '@angular/router';
import { NavigationEnd, NavigationStart, ResolveEnd } from '@angular/router';
import {
SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN,
SEMANTIC_ATTRIBUTE_SENTRY_SOURCE,
WINDOW,
browserTracingIntegration as originalBrowserTracingIntegration,
getCurrentScope,
startBrowserTracingNavigationSpan,
} from '@sentry/browser';
import {
SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN,
SEMANTIC_ATTRIBUTE_SENTRY_SOURCE,
getActiveSpan,
getClient,
spanToJSON,
startInactiveSpan,
} from '@sentry/core';
import { getClient, spanToJSON, startInactiveSpan } from '@sentry/core';
import type { Integration, Span, Transaction, TransactionContext } from '@sentry/types';
import { logger, stripUrlQueryAndFragment, timestampInSeconds } from '@sentry/utils';
import type { Observable } from 'rxjs';
Expand Down Expand Up @@ -126,24 +121,30 @@ export class TraceService implements OnDestroy {
const strippedUrl = stripUrlQueryAndFragment(navigationEvent.url);

if (client && hooksBasedInstrumentation) {
if (!getActiveSpan()) {
if (!this._pageloadOngoing) {
startBrowserTracingNavigationSpan(client, {
name: strippedUrl,
origin: 'auto.navigation.angular',
attributes: {
[SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.navigation.angular',
[SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'url',
},
});
} else {
// The first time we end up here, we set the pageload flag to false
// Subsequent navigations are going to get their own navigation root span
// even if the pageload root span is still ongoing.
this._pageloadOngoing = false;
}

// eslint-disable-next-line deprecation/deprecation
this._routingSpan =
startInactiveSpan({
name: `${navigationEvent.url}`,
op: ANGULAR_ROUTING_OP,
origin: 'auto.ui.angular',
attributes: {
[SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.ui.angular',
[SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]: 'url',
},
tags: {
'routing.instrumentation': '@sentry/angular',
url: strippedUrl,
...(navigationEvent.navigationTrigger && {
navigationTrigger: navigationEvent.navigationTrigger,
Expand Down Expand Up @@ -232,8 +233,18 @@ export class TraceService implements OnDestroy {

private _subscription: Subscription;

/**
* Flag used to determine if navigation events belong to the ongoing pageload.
* The first navigation event after pageload is considered the end of the pageload,
* meaning afterwards, every new navigation start event will create its own
* navigation root span.
*/
private _pageloadOngoing: boolean;

public constructor(private readonly _router: Router) {
this._routingSpan = null;
this._pageloadOngoing = true;

this._subscription = new Subscription();

this._subscription.add(this.navStart$.subscribe());
Expand Down