Skip to content
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

fix(core): Set sentry.source attribute to custom when calling span.updateName on SentrySpan #14251

Merged
merged 5 commits into from
Nov 14, 2024

Conversation

Lms24
Copy link
Member

@Lms24 Lms24 commented Nov 13, 2024

This PR fixes a "regression" introduced in v8 where we no longer updated the source of the span when calling span.updateName. We had this behaviour in our v7 Transaction class (IIRC via transaction.setName(name, source) but most likely forgot to port it to the Span class as the event.transaction_info.source field is only relevant for transactions (i.e. root spans in today's SDK lingo).

The PR also adds and improves some unit and browser integration tests so that we check against the default source as well as that updating the name updates the source.

Important: While this is a fix in the core package it has no effect on spans created in the Node SDK, since these are created from OpenTelemetry. I'll open a second PR for Node, as the changes there are more involved. This fix only addresses the behaviour of our SentrySpan class, which is used in browser SDKs (and none-Otel SDKs if any others use tracing)

The issue addressed in this PR shouldn't be a major issue because it does not concern manually created root spans. Probably the only relevant scenario where this behaviour had user impact is something like:

  1. SDK starts pageload/navigation span with source url (likely via browserTracingIntegration from @sentry/browser)
  2. User updates the span name but doesn't set source explicitly
  3. SDK sends transaction envelope with transaction_info.source: "url"
  4. Relay applies clustering because the "url" source is low quality
  5. Custom name is lost or modified by clustering.

Which again is unlikely an issue in framework SDKs because most of our routing instrumentations update the span name and set the source to "route". The described example would for example happen in @sentry/browser with the default browserTracingIntegration enabled and users running their own enhancement for e.g. a yet unsupported router.

@Lms24 Lms24 self-assigned this Nov 13, 2024
Copy link
Contributor

github-actions bot commented Nov 13, 2024

size-limit report 📦

Path Size % Change Change
@sentry/browser 22.77 KB - -
@sentry/browser - with treeshaking flags 21.53 KB - -
@sentry/browser (incl. Tracing) 35.27 KB +0.03% +9 B 🔺
@sentry/browser (incl. Tracing, Replay) 71.99 KB +0.02% +9 B 🔺
@sentry/browser (incl. Tracing, Replay) - with treeshaking flags 62.37 KB +0.03% +17 B 🔺
@sentry/browser (incl. Tracing, Replay with Canvas) 76.32 KB +0.02% +8 B 🔺
@sentry/browser (incl. Tracing, Replay, Feedback) 89.15 KB +0.01% +9 B 🔺
@sentry/browser (incl. Feedback) 39.93 KB - -
@sentry/browser (incl. sendFeedback) 27.42 KB - -
@sentry/browser (incl. FeedbackAsync) 32.23 KB - -
@sentry/react 25.52 KB - -
@sentry/react (incl. Tracing) 38.23 KB +0.03% +8 B 🔺
@sentry/vue 26.92 KB +0.06% +15 B 🔺
@sentry/vue (incl. Tracing) 37.11 KB +0.03% +10 B 🔺
@sentry/svelte 22.91 KB - -
CDN Bundle 24.13 KB - -
CDN Bundle (incl. Tracing) 37.05 KB +0.04% +13 B 🔺
CDN Bundle (incl. Tracing, Replay) 71.71 KB +0.02% +11 B 🔺
CDN Bundle (incl. Tracing, Replay, Feedback) 77.06 KB +0.02% +11 B 🔺
CDN Bundle - uncompressed 70.73 KB - -
CDN Bundle (incl. Tracing) - uncompressed 109.93 KB +0.03% +31 B 🔺
CDN Bundle (incl. Tracing, Replay) - uncompressed 222.45 KB +0.02% +31 B 🔺
CDN Bundle (incl. Tracing, Replay, Feedback) - uncompressed 235.67 KB +0.02% +31 B 🔺
@sentry/nextjs (client) 38.35 KB +0.06% +20 B 🔺
@sentry/sveltekit (client) 35.85 KB +0.03% +9 B 🔺
@sentry/node 134.29 KB +0.01% +7 B 🔺
@sentry/node - without tracing 96.46 KB - -
@sentry/aws-serverless 106.72 KB - -

View base workflow run

Copy link

codecov bot commented Nov 13, 2024

❌ 1 Tests Failed:

Tests completed Failed Passed Skipped
652 1 651 25
View the top 1 failed tests by shortest run time
performance.client.test.ts updates the transaction when using the back button
Stack Traces | 2.27s run time
performance.client.test.ts:49:1 updates the transaction when using the back button

To view more test analytics, go to the Test Analytics Dashboard
Got feedback? Let us know on Github

@Lms24 Lms24 force-pushed the lms/fix-core-source-custom-span-updatename branch from 14aa37c to ddbf336 Compare November 13, 2024 10:25
@Lms24 Lms24 changed the title fix(core): Set sentry.source attribute to custom when calling span.updateName fix(core): Set sentry.source attribute to custom when calling span.updateName on SentrySpan Nov 13, 2024
@Lms24 Lms24 force-pushed the lms/fix-core-source-custom-span-updatename branch from 08a8882 to 0f12ced Compare November 13, 2024 12:31
expect(transaction.transaction).toBe('parent_span');
expect(transaction.spans).toBeDefined();
});
sentryTest(
Copy link
Member Author

Choose a reason for hiding this comment

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

adjusted this test to check that we by default start a span with source "custom"

import { sentryTest } from '../../../../utils/fixtures';
import { getFirstSentryEnvelopeRequest, shouldSkipTracingTest } from '../../../../utils/helpers';

sentryTest('should create a pageload transaction', async ({ getLocalTestPath, page }) => {
sentryTest('creates a pageload transaction with url as source', async ({ getLocalTestPath, page }) => {
Copy link
Member Author

Choose a reason for hiding this comment

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

no behaviour change here, just to explicitly check that our default browserTracingIntegration starts spans with source "url"

@Lms24 Lms24 force-pushed the lms/fix-core-source-custom-span-updatename branch from bbbca89 to ab779bb Compare November 13, 2024 15:36
@@ -193,6 +193,7 @@ export class SentrySpan implements Span {
*/
public updateName(name: string): this {
this._name = name;
this.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, 'custom');
Copy link
Member

Choose a reason for hiding this comment

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

l: Wondering if we would want to mention this in the jsdoc?

Copy link
Member Author

Choose a reason for hiding this comment

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

Good point, let me add a note

Copy link
Member Author

Choose a reason for hiding this comment

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

On second thought, I'll add this but only in #14280 (which is the PR to fix this and a couple of depending things in Node). Since we always pass the Span interface, I need to upadet the JSDoc of the interface which we should only do once the behaviour is adjusted everywhere.

@Lms24 Lms24 merged commit 5b77377 into develop Nov 14, 2024
149 checks passed
@Lms24 Lms24 deleted the lms/fix-core-source-custom-span-updatename branch November 14, 2024 14:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants