Skip to content

Conversation

@sentrivana
Copy link
Contributor

@sentrivana sentrivana commented Nov 27, 2025

Preview: https://develop-docs-git-ivana-add-py-example-to-spans-v2-api.sentry.dev/sdk/telemetry/spans/span-api/

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

  • Urgent deadline (GA date, etc.):
  • Other deadline:
  • None: Not urgent, can wait up to 1 week+

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it.
    Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

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

LEGAL BOILERPLATE

Look, I get it. The entity doing business as "Sentry" was incorporated in the State of Delaware in 2015 as Functional Software, Inc. and is gonna need some rights from me in order to utilize my contributions in this here PR. So here's the deal: I retain all rights, title and interest in and to my contributions, and by keeping this boilerplate intact I confirm that Sentry can use, modify, copy, and redistribute my contributions, under Sentry's choice of terms.

EXTRA RESOURCES

@vercel
Copy link

vercel bot commented Nov 27, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
develop-docs Ready Ready Preview Comment Dec 2, 2025 11:56am
1 Skipped Deployment
Project Deployment Preview Comments Updated (UTC)
sentry-docs Ignored Ignored Preview Dec 2, 2025 11:56am

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.

Thanks for adding this! good reminder for me to document the actual JS API as well and move the current example to pseudocode or some kind of ideal blueprint example.


```Python {tabTitle:Python}

with sentry_sdk.start_span(name="checkout", attributes={"user.id": "123"}) as checkout_span:
Copy link
Member

@Lms24 Lms24 Dec 1, 2025

Choose a reason for hiding this comment

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

Q: Can sentry_sdk.start_span be used without a with statement?

If so, could we write down an example for this? I think it's fully okay to support with (or callbacks or whatever the platform prefers) but ideally we can also document the most simple case which is that start_span returns an active span which users end manually.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Ty, added in 33bad41.

@sentrivana sentrivana enabled auto-merge (squash) December 2, 2025 11:51
@sentrivana sentrivana merged commit 443744f into master Dec 2, 2025
14 checks passed
@sentrivana sentrivana deleted the ivana/add-py-example-to-spans-v2-api branch December 2, 2025 11:56
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.

3 participants