From 362e4be1690a47a041a9840bd70b462adda622ad Mon Sep 17 00:00:00 2001 From: Liza Mock Date: Thu, 31 Oct 2024 11:36:00 -0700 Subject: [PATCH] Add real-world scenarios to tracing docs (#11688) * Add real-world scenarios to tracing docs * Update docs/product/tracing/index.mdx Co-authored-by: Alex Krawiec --------- Co-authored-by: Alex Krawiec --- docs/product/tracing/index.mdx | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/docs/product/tracing/index.mdx b/docs/product/tracing/index.mdx index b33e0828b15cb..3074aeaeeede2 100644 --- a/docs/product/tracing/index.mdx +++ b/docs/product/tracing/index.mdx @@ -50,3 +50,20 @@ Alternatively, you can use the search bar to look for spans by name, project, or Depending on the size and volume of your app, you may have a lot of traces to sort through. The [Performance](https://sentry.io/orgredirect/organizations/:orgslug/performance/) page in Sentry is a good place to get a high-level, aggregated view of your application's performance and focus in on the traces you care about. You'll see a list of transactions for specific pages, endpoints and parts of your application. Clicking on the transaction ID will take you to the Trace View page for that transaction. Learn more about using Sentry's [Performance Monitoring](/product/performance/). ![An overview of the Performance page in Sentry.](./img/Performance-page.png) + +## How Tracing Can Help You Debug + +Sentry’s tracing lets you follow each request across various services, databases, and functions. This makes it easier to find exactly where an error occured or a performance bottleneck started. Below, you'll find some real-world scenarios where tracing saved the day. + +### Debug Slowdowns Across Your Integrations + +When debugging integrations or a microservice architecture, you'll likely run into issues where the root cause is tricky to discover, especially when it's a performance issue. At Sentry, we make sure to add spans whenever we’re working with external services, like Slack. Because of this, when our users started experiencing a 4-second delay in receiving Sentry alerts via Slack, we were able to go to the [Trace View](/concepts/key-terms/tracing/trace-view/) and quickly narrow down which task was causing the slowdown and deploy a fix quickly. Read more about the details of [debugging Sentry’s Slack Integration](https://blog.sentry.io/debugging-a-slack-integration-with-sentrys-trace-view/). + +### Improve Core Web Vitals + +While everyone is sharing Lighthouse scores, we all know that the true determination of healthy web vitals is when your actual users are using your application in their authentic environments. Sentry offers real insights and analysis of your application in the real world, and while tracing can be leveraged to reactively solve issues, you can also use it to proactively discover opportunities to improve your application performance. In fact, this blog post describes [how you can improve performance before your web page even loads](https://blog.sentry.io/how-to-make-your-web-page-faster-before-it-even-loads/). + +### Debug New Code Bases Faster + +Tracing can even give you the power to debug unfamiliar codebases. Although this benefit is not often discussed, a lot of time can be saved when debugging applications instrumented with Tracing, even if the codebase is completely new to you. Being able to trace actual user journeys throughout your application and see what happens across your entire stack contextualizes issues without even needing to recreate the issue locally. Read more about other ways [tracing helps developers debug](https://blog.sentry.io/everyone-needs-to-know-how-to-trace/) various issues here. +