Skip to content

feat(axum): provide docs for Axum #13822

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

Open
wants to merge 5 commits into
base: master
Choose a base branch
from
Open

feat(axum): provide docs for Axum #13822

wants to merge 5 commits into from

Conversation

lcian
Copy link
Member

@lcian lcian commented May 23, 2025

DESCRIBE YOUR PR

Provides getting started docs for Axum.
The structure is very similar to the one used in #13821, only the code snippets are different.

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

Copy link

vercel bot commented May 23, 2025

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 Jun 3, 2025 9:42am
2 Skipped Deployments
Name Status Preview Comments Updated (UTC)
changelog ⬜️ Ignored (Inspect) Visit Preview Jun 3, 2025 9:42am
develop-docs ⬜️ Ignored (Inspect) Visit Preview Jun 3, 2025 9:42am

@codeowner-assignment codeowner-assignment bot requested a review from a team May 23, 2025 15:54
Copy link

codecov bot commented May 23, 2025

Bundle Report

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

Detailed changes
Bundle name Size Change
sentry-docs-server-cjs 11.21MB 7.44kB (0.07%) ⬆️
sentry-docs-client-array-push 9.52MB 13.07kB (0.14%) ⬆️

Affected Assets, Files, and Routes:

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 158 bytes 585.26kB 0.03%
../app/[[...path]]/page.js.nft.json 113 bytes 398.34kB 0.03%
../app/platform-redirect/page.js.nft.json 113 bytes 398.25kB 0.03%
../app/sitemap.xml/route.js.nft.json 113 bytes 396.23kB 0.03%
1379.js (New) 192.39kB 192.39kB 100.0% 🚀
9273.js 155 bytes 83.26kB 0.19%
../app/platform-redirect/page.js 160 bytes 31.52kB 0.51%
../../static/media/tokio.*.svg (New) 3.0kB 3.0kB 100.0% 🚀
../../static/media/tokio.*.svg (New) 3.01kB 3.01kB 100.0% 🚀
3913.js (Deleted) -191.76kB 0 bytes -100.0% 🗑️

Files in 9273.js:

  • ./src/components/platformIcon.tsx → Total Size: 36.64kB

  • ./src/components/platformIcon.tsx → Total Size: 36.64kB

App Routes Affected:

App Route Size Change Total Size Change (%)
/[[...path]] 158 bytes 3.13MB 0.01%
/platform-redirect 160 bytes 2.58MB 0.01%
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%
server/app/_not-*.js 1.3kB 259.77kB 0.5%
server/app/[[...path]]/page_client-*.js 1.3kB 259.74kB 0.5%
server/app/platform-*.js 1.2kB 245.18kB 0.49%
static/chunks/4459-*.js (New) 120.58kB 120.58kB 100.0% 🚀
static/chunks/app/[[...path]]/page-*.js 80 bytes 79.81kB 0.1%
static/chunks/404-*.js 78 bytes 43.68kB 0.18%
static/media/cd914ecf9c9071d5-*.p.woff2 (New) 36.44kB 36.44kB 100.0% 🚀
static/media/0a86735c6520d94f-*.p.woff2 (New) 35.32kB 35.32kB 100.0% 🚀
static/media/4fca85807f6c09f6-*.woff2 (New) 32.6kB 32.6kB 100.0% 🚀
static/media/d695df15e3ff125c-*.woff2 (New) 32.58kB 32.58kB 100.0% 🚀
static/media/acdf4f392b58827a-*.woff2 (New) 21.13kB 21.13kB 100.0% 🚀
static/media/501d9eeee6e2b0cc-*.woff2 (New) 19.41kB 19.41kB 100.0% 🚀
static/media/e136059a869f199b-*.woff2 (New) 16.46kB 16.46kB 100.0% 🚀
static/media/c1b11e140b58cf5a-*.woff2 (New) 15.11kB 15.11kB 100.0% 🚀
static/media/434c0c74b95acb46-*.woff2 (New) 13.66kB 13.66kB 100.0% 🚀
static/chunks/app/platform-*.js 80 bytes 13.18kB 0.61%
static/media/60181e10ad16e354-*.woff2 (New) 12.29kB 12.29kB 100.0% 🚀
static/media/a72efd2c2476ebb2-*.woff2 (New) 9.7kB 9.7kB 100.0% 🚀
static/media/9d7436bc73437f75-*.woff2 (New) 9.36kB 9.36kB 100.0% 🚀
server/middleware-*.js 5.55kB 6.55kB 555.3% ⚠️
server/middleware-*.js -5.55kB 1.0kB -84.74%
/static/media/tokio.*.svg (New) 3.0kB 3.0kB 100.0% 🚀
/static/media/tokio.*.svg (New) 3.01kB 3.01kB 100.0% 🚀
static/Hmo7XAxvVahVwSDzA9myJ/_buildManifest.js (New) 578 bytes 578 bytes 100.0% 🚀
static/Hmo7XAxvVahVwSDzA9myJ/_ssgManifest.js (New) 77 bytes 77 bytes 100.0% 🚀
static/chunks/1754-*.js (Deleted) -120.27kB 0 bytes -100.0% 🗑️
static/media/b9378c7268e717c1-*.p.woff2 (Deleted) -36.52kB 0 bytes -100.0% 🗑️
static/media/c22ccc5eb58b83e1-*.p.woff2 (Deleted) -35.32kB 0 bytes -100.0% 🗑️
static/media/f1fcc5ff05fc0d5e-*.woff2 (Deleted) -32.42kB 0 bytes -100.0% 🗑️
static/media/356abdd51b933898-*.woff2 (Deleted) -32.26kB 0 bytes -100.0% 🗑️
static/media/8be5568353d67f1e-*.woff2 (Deleted) -20.82kB 0 bytes -100.0% 🗑️
static/media/0596140cb8d9223a-*.woff2 (Deleted) -19.09kB 0 bytes -100.0% 🗑️
static/media/6551d72ebeeac6a7-*.woff2 (Deleted) -16.3kB 0 bytes -100.0% 🗑️
static/media/341baa6ce7a16e81-*.woff2 (Deleted) -15.08kB 0 bytes -100.0% 🗑️
static/media/2a54da80dbfac484-*.woff2 (Deleted) -13.62kB 0 bytes -100.0% 🗑️
static/media/1a4dd1d7cd3232ea-*.woff2 (Deleted) -12.29kB 0 bytes -100.0% 🗑️
static/media/ee8ee7e184152fe5-*.woff2 (Deleted) -8.94kB 0 bytes -100.0% 🗑️
static/media/d70c23d6fe66d464-*.woff2 (Deleted) -8.69kB 0 bytes -100.0% 🗑️
static/5MUmrhDsPjZaH4Nue2mIt/_buildManifest.js (Deleted) -578 bytes 0 bytes -100.0% 🗑️
static/5MUmrhDsPjZaH4Nue2mIt/_ssgManifest.js (Deleted) -77 bytes 0 bytes -100.0% 🗑️

Files in static/chunks/404-*.js:

  • ./src/components/platformIcon.tsx → Total Size: 36.71kB

@lcian lcian requested a review from a team May 23, 2025 15:55
@sfanahata
Copy link
Contributor

@lcian Looks like the build deploys were canceled. I can't seem to try to deploy or redeploy them. Can you? Or can you force push to this branch so we can have those builds run?

@vercel vercel bot temporarily deployed to Preview – changelog June 3, 2025 09:24 Inactive
@lcian
Copy link
Member Author

lcian commented Jun 3, 2025

@lcian Looks like the build deploys were canceled. I can't seem to try to deploy or redeploy them. Can you? Or can you force push to this branch so we can have those builds run?

Now it's working!

description: "Learn about monitoring your axum application with Sentry."
---

The Sentry SDK offers a middleware for the [`axum`](https://github.com/tokio-rs/axum) framework that supports:
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
The Sentry SDK offers a middleware for the [`axum`](https://github.com/tokio-rs/axum) framework that supports:
The Sentry SDK offers a middleware for the [axum](https://github.com/tokio-rs/axum) framework that supports:

This is looking a bit strange as code and a link. I suggest just keeping it as a hyperlink.

The Sentry SDK offers a middleware for the [`axum`](https://github.com/tokio-rs/axum) framework that supports:

- Reporting errors and panics with the correct request correlation.
- Starting a [transaction](https://docs.sentry.io/concepts/key-terms/tracing/) for each request-response cycle.
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
- Starting a [transaction](https://docs.sentry.io/concepts/key-terms/tracing/) for each request-response cycle.
- Starting a <PlatformLink to="/concepts/key-terms/tracing/">transaction</PlatformLink> for each request-response cycle.

We try to do platform links when linking to other parts of our own documentation site.

- Reporting errors and panics with the correct request correlation.
- Starting a [transaction](https://docs.sentry.io/concepts/key-terms/tracing/) for each request-response cycle.

The integration actually supports any crate based on [`tower`](https://github.com/tower-rs/tower), not just `axum`.
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
The integration actually supports any crate based on [`tower`](https://github.com/tower-rs/tower), not just `axum`.
The integration actually supports any crate based on [tower](https://github.com/tower-rs/tower), not just `axum`.

Code + hyperlink looks a little strange.

Comment on lines +83 to +87
## Verify

The snippet above sets up a service that always panics, so you can test that everything is working as soon as you set it up.

Send a request to the application. The panic will be captured by Sentry.
Copy link
Contributor

Choose a reason for hiding this comment

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

This should be moved up above the snippet. We want to make sure that we're explaining things before demoing them. Change it to say "the following snippet sets up...".


</Alert>

To view and resolve the recorded error, log into [sentry.io](https://sentry.io) and select your project. Clicking on the error's title will open a page where you can see detailed information and mark it as resolved.
Copy link
Contributor

Choose a reason for hiding this comment

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

Would that error now be found under issues > errors & outages in our new nav? It would be helpful to be specific about where to find the error to select.

Copy link
Contributor

@sfanahata sfanahata left a comment

Choose a reason for hiding this comment

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

@lcian - a few things should be cleaned up before we merge. It's close though! Let me know if you need any help.

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