--- title: "Performance Issues" description: "Learn more about which performance issues Sentry detects and how to use the Issue Details page to debug them." url: https://docs.sentry.io/product/issues/issue-details/performance-issues/ --- # Performance Issues A *performance issue* is a grouping of transaction events that are performing poorly. If your application is configured for tracing, that data can be used in [pre-built Sentry Dashboards](https://docs.sentry.io/product/dashboards/sentry-dashboards.md), Sentry will detect common performance problems, and group them into issues. We group similar transaction events into issues based on a fingerprint. For performance issues, a fingerprint is primarily based on the problem type and the spans involved in the problem. The **Issue Details** page helps you to gain further insight into the source of a performance issue and the impact it has on your application's users. The top panel of the page displays high-level information about the issue and an event graph, showing a distribution of events and errors. Use the "Previous Event" and "Next Event" buttons to navigate between the events of an issue. The main area of the page displays information about a specific event that's part of an issue, as well as a breakdown of the tags, span evidence, and breadcrumbs if they are available: ## [Filter Performance Issues](https://docs.sentry.io/product/issues/issue-details/performance-issues.md#filter-performance-issues) To filter performance issues in **Issues** and **Dashboards**: * Use `issue.category:[db_query,http_client,frontend,mobile]` for frontend, HTTP client, database query, and mobile performance issues. * Use `issue.category:metric` for function and endpoint regression issues. ## [How Performance Issues Work](https://docs.sentry.io/product/issues/issue-details/performance-issues.md#how-performance-issues-work) Sentry detects performance issues by scanning incoming transaction events. First we check various properties of the transaction (span durations, span arrangement, span types, and so on) to detect likely problems. We then check these properties against corresponding thresholds to determine whether a performance issue exists. Lastly, we generate a unique problem fingerprint based on the problem type and location in the application, and use that fingerprint to create a performance issue. ## [Span Evidence](https://docs.sentry.io/product/issues/issue-details/performance-issues.md#span-evidence) Span evidence is information that explains the performance problem in the context of the current event. It may include details like the specific database queries that cause the problem, the spans that contain the problem, and the slow spans that have an impact on performance. This section also has a span tree which shows how the problematic spans relate to the rest of the event. Different performance problems will have slightly different kinds of evidence. ## [Event Grouping Information](https://docs.sentry.io/product/issues/issue-details/performance-issues.md#event-grouping-information) The "Event Grouping Information" section provides details of how Sentry fingerprinted the event into the group. You can see which parts of the span evidence contributed to the fingerprint. ## [Configuration](https://docs.sentry.io/product/issues/issue-details/performance-issues.md#configuration) As a Project Admin, you can also manage individual settings for each performance issue detector in **Project Settings > Performance**. Here, you can raise or lower the thresholds for what Sentry considers a performance issue for each project, or disable detection altogether. ## [Issue Types](https://docs.sentry.io/product/issues/issue-details/performance-issues.md#issue-types) Performance issues can be filtered by the following `issue.category` values: | `issue.category` | Issue Types | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `frontend` | * [Large Render Blocking Asset](https://docs.sentry.io/product/issues/issue-details/performance-issues/large-render-blocking-asset.md) * [Uncompressed Asset](https://docs.sentry.io/product/issues/issue-details/performance-issues/uncompressed-asset.md) * [Web Vitals](https://docs.sentry.io/product/issues/issue-details/performance-issues/web-vitals.md) | | `http_client` | - [Consecutive HTTP](https://docs.sentry.io/product/issues/issue-details/performance-issues/consecutive-http.md) - [Large HTTP Payload](https://docs.sentry.io/product/issues/issue-details/performance-issues/large-http-payload.md) - [N+1 API Calls](https://docs.sentry.io/product/issues/issue-details/performance-issues/n-one-api-calls.md) - [HTTP/1.1 Overhead](https://docs.sentry.io/product/issues/issue-details/performance-issues/http-overhead.md) | | `db_query` | * [Consecutive DB Queries](https://docs.sentry.io/product/issues/issue-details/performance-issues/consecutive-db-queries.md) * [N+1 Queries](https://docs.sentry.io/product/issues/issue-details/performance-issues/n-one-queries.md) * [Slow DB Queries](https://docs.sentry.io/product/issues/issue-details/performance-issues/slow-db-queries.md) | | `mobile` | - [File I/O on Main Thread](https://docs.sentry.io/product/issues/issue-details/performance-issues/file-main-thread-io.md) - [Database on Main Thread](https://docs.sentry.io/product/issues/issue-details/performance-issues/db-main-thread-io.md) - [JSON Decoding on Main Thread](https://docs.sentry.io/product/issues/issue-details/performance-issues/json-decoding-main-thread.md) - [Image Decoding on Main Thread](https://docs.sentry.io/product/issues/issue-details/performance-issues/image-decoding-main-thread.md) - [Regex on Main Thread](https://docs.sentry.io/product/issues/issue-details/performance-issues/regex-main-thread.md) - [Frame Drop](https://docs.sentry.io/product/issues/issue-details/performance-issues/frame-drop.md) | | `metric` | * [Function Regressions](https://docs.sentry.io/product/issues/issue-details/performance-issues/function-regressions.md) * [Endpoint Regressions](https://docs.sentry.io/product/issues/issue-details/performance-issues/endpoint-regressions.md) | ## [Limitations](https://docs.sentry.io/product/issues/issue-details/performance-issues.md#limitations) Performance issues currently have the following limitations: * Performance issues cannot be merged * Custom fingerprinting and grouping can't be applied to performance issues ## Pages in this section - [N+1 Queries](https://docs.sentry.io/product/issues/issue-details/performance-issues/n-one-queries.md) - [N+1 API Calls](https://docs.sentry.io/product/issues/issue-details/performance-issues/n-one-api-calls.md) - [Database on Main Thread](https://docs.sentry.io/product/issues/issue-details/performance-issues/db-main-thread-io.md) - [File I/O on Main Thread](https://docs.sentry.io/product/issues/issue-details/performance-issues/file-main-thread-io.md) - [Consecutive DB Queries](https://docs.sentry.io/product/issues/issue-details/performance-issues/consecutive-db-queries.md) - [Consecutive HTTP](https://docs.sentry.io/product/issues/issue-details/performance-issues/consecutive-http.md) - [Frame Drop](https://docs.sentry.io/product/issues/issue-details/performance-issues/frame-drop.md) - [HTTP/1.1 Overhead](https://docs.sentry.io/product/issues/issue-details/performance-issues/http-overhead.md) - [Image Decoding on Main Thread](https://docs.sentry.io/product/issues/issue-details/performance-issues/image-decoding-main-thread.md) - [JSON Decoding on Main Thread](https://docs.sentry.io/product/issues/issue-details/performance-issues/json-decoding-main-thread.md) - [Large HTTP Payload](https://docs.sentry.io/product/issues/issue-details/performance-issues/large-http-payload.md) - [Large Render Blocking Asset](https://docs.sentry.io/product/issues/issue-details/performance-issues/large-render-blocking-asset.md) - [Regex on Main Thread](https://docs.sentry.io/product/issues/issue-details/performance-issues/regex-main-thread.md) - [Slow DB Queries](https://docs.sentry.io/product/issues/issue-details/performance-issues/slow-db-queries.md) - [Uncompressed Asset](https://docs.sentry.io/product/issues/issue-details/performance-issues/uncompressed-asset.md) - [Web Vitals](https://docs.sentry.io/product/issues/issue-details/performance-issues/web-vitals.md) - [Function Regression](https://docs.sentry.io/product/issues/issue-details/performance-issues/function-regressions.md) - [Endpoint Regression](https://docs.sentry.io/product/issues/issue-details/performance-issues/endpoint-regressions.md)