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(apple): Clarify trace propagation targets #9110

Merged
merged 3 commits into from
Feb 13, 2024

Conversation

philipphofmann
Copy link
Member

Pre-merge checklist

If you work at Sentry, you're able to merge your own PR without review, but please don't unless there's a good reason.

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs
  • PR was reviewed and approved by a member of the Sentry docs team

Description of changes

The trace propagation target code sample was in the section of distributed tracing without an explanation, making the distributed tracing docs for Apple confusing. This is fixed now by adding an explanation and moving the trace propagation target below the distributed tracing section.

The trace propagation target code sample was in the section of
distributed tracing without an explanation, making the distributed
tracing docs for Apple confusing. This is fixed now by adding an
explanation and moving the trace propagation target below the
distributed tracing section.
@philipphofmann philipphofmann requested a review from a team February 12, 2024 14:25
Copy link

vercel bot commented Feb 12, 2024

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
sentry-docs ✅ Ready (Inspect) Visit Preview 💬 Add feedback Feb 13, 2024 10:50am
1 Ignored Deployment
Name Status Preview Comments Updated (UTC)
sentry-docs-next ⬜️ Ignored (Inspect) Visit Preview Feb 13, 2024 10:50am

Copy link
Member

@kahest kahest left a comment

Choose a reason for hiding this comment

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

LGTM, just some small wording suggestions!

You can put string or regexes into the allowlist, and the SDK then only attaches the `sentry-trace` and `baggage`
headers to all outgoing requests whose destination contains a string in the list or matches a regex in the list.

**The `tracePropagationTargets` option matches the entire request URL, not just the domain. Using stricter regex to match certain parts of the URL ensures that requests don't unnecessarily have additional headers attached.**
Copy link
Member

@kahest kahest Feb 12, 2024

Choose a reason for hiding this comment

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

Suggested change
**The `tracePropagationTargets` option matches the entire request URL, not just the domain. Using stricter regex to match certain parts of the URL ensures that requests don't unnecessarily have additional headers attached.**
**Because the `tracePropagationTargets` option matches the entire request URL, not just the domain, you should use strict regexes that match specific parts of the URL to ensure that requests don't have unnecessary or unwanted headers attached.**

Copy link
Contributor

Choose a reason for hiding this comment

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

I think it would be good to turn this into a note rather than bolding it.

Copy link
Contributor

@lizokm lizokm left a comment

Choose a reason for hiding this comment

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

Made some language suggestions.

You can put string or regexes into the allowlist, and the SDK then only attaches the `sentry-trace` and `baggage`
headers to all outgoing requests whose destination contains a string in the list or matches a regex in the list.

**The `tracePropagationTargets` option matches the entire request URL, not just the domain. Using stricter regex to match certain parts of the URL ensures that requests don't unnecessarily have additional headers attached.**
Copy link
Contributor

Choose a reason for hiding this comment

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

I think it would be good to turn this into a note rather than bolding it.

@philipphofmann philipphofmann enabled auto-merge (squash) February 13, 2024 10:11
@philipphofmann philipphofmann merged commit 431e2f0 into master Feb 13, 2024
7 of 8 checks passed
@philipphofmann philipphofmann deleted the fix/apple-distributed-tracing branch February 13, 2024 10:31
@github-actions github-actions bot locked and limited conversation to collaborators Feb 29, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants