Skip to content

Conversation

@mydea
Copy link
Member

@mydea mydea commented Nov 10, 2023

This adds docs for custom distributed tracing for Node & Browser JavaScript, including the new continueTrace method, which was added here: getsentry/sentry-javascript#9164.

We do not show this for Next, Remix, Sveltekit and Astro - not 100% sure if this is correct, or if there are other guides where we should/should not show this.

@mydea mydea requested review from a team, AbhiPrasad, Lms24 and lforst November 10, 2023 09:19
@mydea mydea self-assigned this Nov 10, 2023
@vercel
Copy link

vercel bot commented Nov 10, 2023

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 Nov 14, 2023 9:45am

Copy link
Contributor

@lforst lforst left a comment

Choose a reason for hiding this comment

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

Sorry for big review. I wanted to use the opportunity to clean this up in general.

- Inject tracing information to the outgoing request when sending outgoing requests.

To learn more, see our <PlatformLink to="/distributed-tracing/">Distributed Tracing</PlatformLink> docs.
To learn more, see our <PlatformLink to="/usage/distributed-tracing/">Distributed Tracing</PlatformLink> docs.
Copy link
Contributor

Choose a reason for hiding this comment

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

I feel conflicted about having these two pages 🤔 Or rather about linking back to that page here. People are here for manual instrumentation. Why should we link back to auto-instrumentation. I think we should either delete this line or link to the auto-instrumentation all the way at the top of this page in-case people got lost.

Copy link
Member Author

Choose a reason for hiding this comment

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

I think the idea of this is that on that page we describe distributed tracing as a concept, generally 🤔 (I copied this from other existing pages for custom instrumentation, FWIW)

Copy link
Contributor

Choose a reason for hiding this comment

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

@mydea - I agree that's the point of the link. Ideally, conceptual information and how-to information should be separate, which would make this less confusing. As it is, I think the link is ok though.


## Enabling Distributed Tracing without `Http` Integration

If you do not want to use the `Http` integration in conjuction with `tracing: true`, you can manually extract and inject tracing information into your application. For this, you must:
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
If you do not want to use the `Http` integration in conjuction with `tracing: true`, you can manually extract and inject tracing information into your application. For this, you must:
If you do not want to use the `Http` or `Undici` integrations, you can manually trace your application. For this, you must:

mydea and others added 2 commits November 10, 2023 12:21
Co-authored-by: Luca Forstner <luca.forstner@sentry.io>
Copy link
Contributor

@shanamatthews shanamatthews left a comment

Choose a reason for hiding this comment

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

Ok from my end, once you fix the formatting issues I commented on.

Co-authored-by: Shana Matthews <shana.l.matthews@gmail.com>
Copy link
Member

@Lms24 Lms24 left a comment

Choose a reason for hiding this comment

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

LGTM!

Co-authored-by: Lukas Stracke <lukas.stracke@sentry.io>
@mydea mydea merged commit acf929c into master Nov 14, 2023
@mydea mydea deleted the fn/continueTrace branch November 14, 2023 14:07
@github-actions github-actions bot locked and limited conversation to collaborators Nov 30, 2023
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.

5 participants