Python tracing docs refresh

[sfanahata]

DESCRIBE YOUR PR

Closes issue: https://linear.app/getsentry/project/tracing-improvements-python-120f4a3d71f2/overview
improve the structure of the tracing docs to match the structure we built for the JavaScript ones.

• Add span metrics section

  • Example instrumentation

  • Sending performance metrics

• Reformat Python tracing section to mirror JS structure

  • trace propagation -> distributed tracing, review section docs

  • Add configure sampling doc

  • Review instrumentation section

     - Add new content to the index.mdx file to make more similar to the JS file  
    

  • Add troubleshooting doc

  • Delete performance-metrics.mdx file under instrumentation (was redundant to the span-netsed doc I created)

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

[vercel]

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

Name	Status	Preview	Comments	Updated (UTC)
changelog	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Apr 4, 2025 10:15pm
develop-docs	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Apr 4, 2025 10:15pm
sentry-docs	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Apr 4, 2025 10:15pm

[coolguyzone]

I'm not familiar enough with Python to know, but is there a way to illustrate what closing this code block would look like?

[sfanahata]

It looks like the with statement is used to automatically close the block, hence the comment, but I extended the block to demonstrate what it would look like within a larger set of code. LMK if that helps with what you were thinking!

[coolguyzone]

Great use of a table!

[codecov]

Bundle Report

Changes will increase total bundle size by 1.05kB (0.01%) ⬆️. This is within the configured threshold ✅

Detailed changes

Bundle name	Size	Change
sentry-docs-server-cjs	11.13MB	1.06kB (0.01%) ⬆️
sentry-docs-client-array-push	9.47MB	-6 bytes (-0.0%) ⬇️

Affected Assets, Files, and Routes:

view changes for bundle: sentry-docs-client-array-push

Assets Changed:

Asset Name	Size Change	Total Size	Change (%)
static/chunks/pages/_app-*.js	-3 bytes	868.7kB	-0.0%
static/chunks/8165-*.js	-3 bytes	410.1kB	-0.0%
static/a1vlX9JvnOnT3-*.js (New)	77 bytes	77 bytes	100.0% 🚀
static/a1vlX9JvnOnT3-*.js (New)	578 bytes	578 bytes	100.0% 🚀
static/5VjVU8szhtAqL5oYrnjhh/_buildManifest.js (Deleted)	-578 bytes	0 bytes	-100.0% 🗑️
static/5VjVU8szhtAqL5oYrnjhh/_ssgManifest.js (Deleted)	-77 bytes	0 bytes	-100.0% 🗑️

view changes for bundle: sentry-docs-server-cjs

Assets Changed:

Asset Name	Size Change	Total Size	Change (%)
1729.js	-3 bytes	1.75MB	-0.0%
../instrumentation.js	-3 bytes	1.08MB	-0.0%
9523.js	-3 bytes	1.05MB	-0.0%
../app/[[...path]]/page.js.nft.json	356 bytes	384.62kB	0.09%
../app/platform-redirect/page.js.nft.json	356 bytes	384.53kB	0.09%
../app/sitemap.xml/route.js.nft.json	356 bytes	382.5kB	0.09%

[sentrivana]

Suggested change

	| `start_time` | `datetime/float`| The start time of the span. |
	| `start_timestamp` | `datetime/float`| The start time of the span. |

[sentrivana]

@sfanahata Thanks for incorporating my feedback! And sorry for leaving that many comments (it's a big PR).

I've marked most threads resolved; there's still a handful open. If you prefer, happy to sync online -- I'm at a conference on Monday but available from Tuesday onwards. I don't want to block this though so if you want to merge it go ahead, just please have a look at the open stuff.

review addressed

[coolguyzone]

Looks good!