You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
update(perf): Update performance landing and widget descriptions (#4500)
* update(perf): Update performance landing and widget descriptions
This mostly updates the docs to include widget descriptions for all the actionable widgets, since most of the mini-chart / simple visualizations are covered in metrics. The new page isn't strictly necessary, I've just added it for somewhere to put these definitions for now, since we may want to add more screenshots or explanations here in the future.
Finally, made a couple changes to the main performance landing docs.
* Fix vscode auto-format.
* Update src/docs/product/performance/filters-display.mdx
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
* Update src/docs/product/performance/filters-display.mdx
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
* Update src/docs/product/performance/widgets.mdx
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
* Update src/docs/product/performance/widgets.mdx
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
* Update src/docs/product/performance/widgets.mdx
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
* Update src/docs/product/performance/widgets.mdx
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
* Update src/docs/product/performance/widgets.mdx
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
* Update src/docs/product/performance/widgets.mdx
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
* Update src/docs/product/performance/widgets.mdx
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
* Update src/docs/product/performance/widgets.mdx
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
* Update src/docs/product/performance/widgets.mdx
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
* Update src/docs/product/performance/widgets.mdx
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
* Update src/docs/product/performance/widgets.mdx
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
* Update src/docs/product/performance/widgets.mdx
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
* Update src/docs/product/performance/widgets.mdx
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
* fixing capitalization
* wording edit
* created filters display folder and moved filters and widgets pages into it
* fixed link on performance index page and updated sidebar order on some pages
* updated images
* fixed image link
* fixed links
* removing Display dropdown reference
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
Co-authored-by: Isabel Matwawana <isabel@matwawana.com>
Copy file name to clipboardExpand all lines: src/docs/product/performance/filters-display/index.mdx
+33-24Lines changed: 33 additions & 24 deletions
Original file line number
Diff line number
Diff line change
@@ -16,60 +16,69 @@ The page displays a view of transactions, but you can click the “View Trends
16
16
17
17
Each tab in **Performance** displays an automatically selected set of [widgets](#widgets) and table columns based on the platform of your project. For example, a JavaScript project displays the "Web Vitals" tab by default. Each tab and its [metrics](/product/performance/metrics/) are explained below.
18
18
19
-
### All Transactions
19
+

20
20
21
-
When you select "All Transactions", the table includes all frontend and backend transactions.
[Web Vitals](/product/performance/web-vitals/) includes frontend pageload transactions. The transactions are automatically filtered to only include `transaction.op:pageload`. This generally corresponds to all browser page transitions that are the first load of a page. It also includes performance information from the beginning of the load itself, as well as the performance of the SPA frameworks being loaded, such as React or Vue (if available).
"Frontend" includes all frontend transactions, without a specific focus on Web Vitals. This generally corresponds to page transitions handled internally in SPA frameworks, such as React or Vue. Note that if you've selected a backend project, this mode also displays backend transactions.
34
32
35
33
### Backend
36
34
37
35
"Backend" puts an emphasis on duration, throughput, failure rate, and Apdex. Note that if you've selected a frontend project, this mode also displays all frontend transactions.
"Mobile" puts an emphasis on [Mobile Vitals](/product/performance/mobile-vitals/). Note that if you've selected a non-mobile project, this mode also displays all of those transactions.
The search bar operates similarly to the one in the Discover [Query Builder](/product/discover-queries/query-builder/#filter-by-search-conditions). For example, you can refine your transaction search to a specific release by using `release:` as a key field and assigning the version as a value.
50
44
51
-
##Graphs
45
+
## Widgets
46
+
47
+
[Widgets](/product/performance/filters-display/widgets/) offer visualizations that you can change to best match your workflow.
48
+
49
+

50
+
51
+
In the first row, there are time series and distribution graphs of common metrics for the selected project type (frontend or backend), such as User Misery or Failure Rate. You can compare these side-by-side to find any correlations.
52
+
53
+
In the second row, there are actionable widgets that can show you areas of concern in your application, such as Most Regressed Transactions or Most Recurring Issues. Below these widgets, there are lists of transactions, which you can click to see additional context. Transactions shown in these lists can be temporarily removed from the view by clicking the 'X' beside the transaction name.
52
54
53
-
Youcancomparegraphssidebysidetofindanyrelevantcorrelations.Forexample,ifanApdexscoredipssignificantlyduringagiventimeperiod,you'llbeabletovisualizewhetherthroughputspikedinthesametimeintervalina"Transactions per Minute"graph.Theglobalheaderandsearchconditionswillalsoallowyoutofurtherfilterthesegraphs:
55
+
Each widget has a menu in the top right where can you change the widget shown. Your changes will be persisted locally either for the session or until application storage is cleared. After that, the default set of widgets is displayed.
56
+
57
+
### Basic Widgets
54
58
55
59
-[Apdex](/product/performance/metrics/#apdex)
56
60
-[Transactions Per Minute (TPM)](/product/performance/metrics/#throughput-total-tpm-tps)
description: "Learn more about Sentry's Performance widgets such as, Most Related Issues, Most Regressed Transactions, Slow HTTP Ops, and how they can be used to surface performance insights in your applications."
5
+
---
6
+
7
+
Performance widgets offer visualizations that you can change to best match your workflow. They provide performance-specific views that allow you see and act on transaction data across your organization.
8
+
Depending on which **Performance** tab you've selected, different curated performance widgets will be available.
9
+
10
+
## Most Improved
11
+
12
+
Shows the most improved transactions and visualizes the improvement for the selected transaction in the list. Only trends of a specific significance and throughput are shown. Learn more in [Trends](/product/performance/trends).
13
+
14
+
## Most Regressed
15
+
16
+
Shows the most regressed transactions and visualizes the regression for the selected transaction in the list. Only trends of a specific significance and throughput are shown. Learn more in [Trends](/product/performance/trends).
17
+
18
+
## Most Related Issues
19
+
20
+
Shows the highest count of any issue group related to a transaction and visualizes the issue count over time.
21
+
22
+
## Most Slow Frames
23
+
24
+
Shows transactions with the most slow frames for mobile projects. Learn more in [Mobile Vitals](/product/performance/mobile-vitals).
25
+
26
+
## Most Frozen Frames
27
+
28
+
Shows transactions with the most frozen frames for mobile projects. Learn more in [Mobile Vitals](/product/performance/mobile-vitals).
29
+
30
+
## Worst LCP Vitals
31
+
32
+
Shows transactions with the highest count of poor LCP (Largest Contentful Paint) and visualizes the proportions of user experience for this vital. Learn more in [Web Vitals](/product/performance/web-vitals).
33
+
34
+
## Worst FCP Vitals
35
+
36
+
Shows transactions with the highest count of poor FCP (First Contentful Paint) and visualizes the proportions of user experience for this vital. Learn more in [Web Vitals](/product/performance/web-vitals).
37
+
38
+
## Worst FID Vitals
39
+
40
+
Shows transactions with the highest count of poor FID (First Input Delay) and visualizes the proportions of user experience for this vital. Learn more in [Web Vitals](/product/performance/web-vitals).
41
+
42
+
## Slow HTTP Ops
43
+
44
+
Shows transactions with slow cumulative HTTP spans. Slow HTTP ops are note shown for all projects and transactions as the transactions must contain HTTP spans. Check out the SDK documentation for the project in question for more information.
45
+
46
+
## Slow DB Ops
47
+
48
+
Shows transactions with slow cumulative DB spans. Slow DB ops are not shown for all projects and transactions as the transactions must contain DB spans. Check out the SDK documentation for the project in question for more information.
49
+
50
+
## Slow Browser Ops
51
+
52
+
Shows transactions with slow cumulative browser spans. These show frontend transactions with poor performing browser spans, such as DNS lookup, TLS/SSL, and so on.
53
+
54
+
## Slow Resource Ops
55
+
56
+
Shows transactions with slow cumulative resource spans. These show frontend transactions with poor performing resources spans, and show cumulative time spent loading scripts, CSS, and so on.
Copy file name to clipboardExpand all lines: src/docs/product/performance/index.mdx
+2-2Lines changed: 2 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -20,13 +20,13 @@ Learn more about traces in the [full Tracing documentation](/product/sentry-basi
20
20
21
21
The **Performance** page is the main view in [sentry.io](https://sentry.io) where you can search or browse for <SandboxLinkscenario="oneTransaction"projectSlug="react">transaction</SandboxLink> data. The page displays graphs that visualize transactions or trends, as well as a table where you can view relevant transactions and drill down to more information about them.
22
22
23
-

23
+

24
24
25
25
Using the information on this page, you can trace issues back through services (for instance, frontend to backend) to identify poorly performing code. This allows you to answer questions like whether your application performance is getting better or worse, if your last release is running more slowly than previous ones, or which specific services are slow. Then you can begin to address the code that’s degrading performance.
26
26
27
27
## Filter Performance Data
28
28
29
-
The <SandboxLinkscenario="performance"projectSlug="react">Performance</SandboxLink> page provides you with several filter and display options so that you can focus on the performance data you want. Search conditions help you find the <SandboxLinkscenario="oneTransaction"projectSlug="react">transactions</SandboxLink> you want to investigate. You can also control what kind of information is visualized in the [graphs](/product/performance/filters-display/#graphs) or which transactions appear first in the [transactions table](/product/performance/filters-display/#transaction-table).
29
+
The <SandboxLinkscenario="performance"projectSlug="react">Performance</SandboxLink> page provides you with several filter and display options so that you can focus on the performance data you want. Search conditions help you find the <SandboxLinkscenario="oneTransaction"projectSlug="react">transactions</SandboxLink> you want to investigate. You can also control what kind of information is visualized in the [widgets](/product/performance/filters-display/#widgets) or which transactions appear first in the [transactions table](/product/performance/filters-display/#transaction-table).
Copy file name to clipboardExpand all lines: src/docs/product/performance/mobile-vitals.mdx
+2-2Lines changed: 2 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -6,9 +6,9 @@ description: "Learn more about Mobile Vitals in Sentry, and how they give you a
6
6
7
7
Mobile Vitals are a set of metrics that measure how fast your app starts and the number of slow and frozen frames your users experience. Each metric provides insights into the overall performance of your mobile application and gives you the details you need to not only prioritize critical performance issues, but to trace issues down to the root cause to solve them faster.
8
8
9
-
Mobile Vitals are summarized in several graphs on the **Performance** page in [sentry.io](https://sentry.io)when you select "Mobile" in the "Display" dropdown.
9
+
Mobile Vitals are summarized in several graphs on the **Performance** page in [sentry.io](https://sentry.io) in the "Mobile" tab.
10
10
11
-

11
+

0 commit comments