Skip to content

Commit 306af92

Browse files
authored
ref(insights): move performance docs under insights (#12720)
* move performance docs under insights * fix * remove retention priorties * Update docs/product/insights/overview/index.mdx * code review * remove setup page * fix
1 parent 5fb4a30 commit 306af92

File tree

129 files changed

+293
-369
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

129 files changed

+293
-369
lines changed

.github/CODEOWNERS

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@
3434
# /src/wizard/rust/ @getsentry/owners-native
3535

3636
# /src/docs/product/discover-queries/ @getsentry/visibility
37-
# /src/docs/product/performance/ @getsentry/visibility
37+
# /src/docs/product/insights/ @getsentry/insights
3838

3939
# /src/docs/cli/dif.mdx @getsentry/owners-native
4040

develop-docs/application-architecture/sentry-vs-getsentry.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ sidebar_order: 20
55

66
You'll find numerous references to both `sentry` and `getsentry` in our documentation. Both are [Django](https://www.djangoproject.com/) apps, but `sentry` [is open](https://github.com/getsentry/sentry) and `getsentry` is closed. What's in which?
77

8-
The main thing to emphasize is that all of our product features—[Issues](https://docs.sentry.io/product/issues/), [Performance](https://docs.sentry.io/product/performance/), [Dashboards](https://docs.sentry.io/product/dashboards/), and [such](https://docs.sentry.io/product/)—are implemented and available in `sentry`, the open component. It's really important to us that we're not an "open core" company that hides key functionality behind a paywall. [Sentry is as open-source as we can make it](https://open.sentry.io/licensing/).
8+
The main thing to emphasize is that all of our product features—[Issues](https://docs.sentry.io/product/issues/), [Insights](https://docs.sentry.io/product/insights/), [Dashboards](https://docs.sentry.io/product/dashboards/), and [such](https://docs.sentry.io/product/)—are implemented and available in `sentry`, the open component. It's really important to us that we're not an "open core" company that hides key functionality behind a paywall. [Sentry is as open-source as we can make it](https://open.sentry.io/licensing/).
99

1010
So what's in `getsentry`, then? It implements billing and account management features for [our SaaS, sentry.io](https://sentry.io/). `getsentry` is the Django app we deploy to production. It imports the `sentry` Django app, adds some routes and models, and re-exports it.
1111

develop-docs/backend/application-domains/transaction-clustering/index.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ In terms of technical implementation, it is similar to [Data Scrubbing](/backend
1111

1212
## The Problem
1313

14-
In our [Performance](https://docs.sentry.io/product/performance/) product, transactions are grouped by their name
14+
In our [Insights](https://docs.sentry.io/product/insights/overview/) product, transactions are grouped by their name
1515
(the [`event.transaction`](/sdk/data-model/event-payloads/#optional-attributes) field).
1616
This works well as long as the cardinality of distinct transaction names that the SDK sends is low, for example
1717
by using the [route of a web framework](https://docs.sentry.io/platforms/javascript/guides/react/configuration/integrations/react-router/) as the transaction name.
@@ -22,7 +22,7 @@ and it falls back to the raw URL (or rather,
2222
[its path component](https://en.wikipedia.org/wiki/Uniform_Resource_Identifier#Syntax)).
2323

2424
This makes it harder for the user to extract insights from [Performance
25-
metrics](https://docs.sentry.io/product/performance/metrics/), because instead of presenting averages, percentiles and distributions of groups of transactions that logically
25+
metrics](https://docs.sentry.io/product/insights/overview/metrics/), because instead of presenting averages, percentiles and distributions of groups of transactions that logically
2626
belong together, we end up with a bunch of one-off transaction groups.
2727

2828
```URLs

develop-docs/sdk/telemetry/traces/opentelemetry.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ This page is under active development. Specifications are not final and subject
1010

1111
</Alert>
1212

13-
This document details Sentry's work in integrating and supporting [OpenTelemetry](https://opentelemetry.io/), the open standard for metrics, traces and logs. In particular, it focuses on the integration between [Sentry's performance monitoring product](https://docs.sentry.io/product/performance/) and [OpenTelemetry's tracing spec](https://opentelemetry.io/docs/concepts/signals/traces/).
13+
This document details Sentry's work in integrating and supporting [OpenTelemetry](https://opentelemetry.io/), the open standard for metrics, traces and logs. In particular, it focuses on the integration between [Sentry's performance monitoring product](https://docs.sentry.io/product/insights/overview/) and [OpenTelemetry's tracing spec](https://opentelemetry.io/docs/concepts/signals/traces/).
1414

1515
## Background
1616

develop-docs/self-hosted/experimental/errors-only.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ This is our default version of self-hosted Sentry. It includes most of the featu
3030
3. [Replays](https://docs.sentry.io/product/explore/session-replay/)
3131
4. [Insights](https://docs.sentry.io/product/insights/) (Requests, Queries, Assets, etc)
3232
5. [User Feedback](https://docs.sentry.io/product/user-feedback/)
33-
6. [Performance](https://docs.sentry.io/product/performance/)
33+
6. [Insights](https://docs.sentry.io/product/insights/)
3434
7. [Crons](https://docs.sentry.io/product/crons/)
3535
8. [Metrics](https://docs.sentry.io/product/explore/metrics/)
3636

docs/concepts/key-terms/key-terms.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ Each of these key features have their own page (or set of pages) in the [sentry.
5858

5959
- **Insights** - Sentry surfaces insights that can help you identify opportunities at the service-level to improve various parts of your app's performance, including requests, assets, caches, queues, and more. Modules living under the Insights heading provide an overview of how your project is performing in that category, as well as the ability to review sample events and their traces to help you diagnose potential problems.
6060

61-
- **Performance** - The main view in [sentry.io](http://sentry.io) where you can search or browse for transaction 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. Learn more in the full [performance monitoring documentation](/product/performance/).
61+
- **Insights Overview** - The main view in [sentry.io](http://sentry.io) where you can search or browse for transaction 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. Learn more in the full [performance monitoring documentation](/product/insights/overview/).
6262

6363
- **Alerts** - Where you can create new alert rules and manage existing ones. Learn more in the full [Alerts documentation](/product/alerts/).
6464

docs/concepts/key-terms/tracing/distributed-tracing.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ sidebar_order: 10
44
description: With distributed tracing, you can track software performance and measure throughput & latency, while seeing the impact of errors across multiple systems.
55
---
66

7-
Distributed tracing provides a connected view of your application from frontend to backend. It helps track software performance, measure [metrics](/product/performance/metrics/) like throughput and latency, and display the impact of errors across multiple systems. This makes Sentry a more complete [performance monitoring](/product/performance/) solution, aiding in diagnosing problems and measuring your application's overall health.
7+
Distributed tracing provides a connected view of your application from frontend to backend. It helps track software performance, measure [metrics](/product/insights/overview/metrics/) like throughput and latency, and display the impact of errors across multiple systems. This makes Sentry a more complete [performance monitoring](/product/insights/overview/) solution, aiding in diagnosing problems and measuring your application's overall health.
88

99
[Tracing](/concepts/key-terms/tracing/distributed-tracing/) in Sentry provides insights such as:
1010

@@ -76,7 +76,7 @@ Distributed tracing allows you to follow a request from the [frontend](/product/
7676

7777
A **trace** represents the record of the entire operation you want to measure or track, like page load or a user action. When a trace includes work in multiple services, it's called a **distributed trace**.
7878

79-
Each trace consists of one or more tree-like structures called [**transactions**](/product/performance/transaction-summary/), with nodes called **spans**. Each transaction represents a single instance of a service being called, and each span represents a single unit of work. Here's an example trace, broken down into transactions and spans:
79+
Each trace consists of one or more tree-like structures called [**transactions**](/product/insights/overview/transaction-summary/), with nodes called **spans**. Each transaction represents a single instance of a service being called, and each span represents a single unit of work. Here's an example trace, broken down into transactions and spans:
8080

8181
![Diagram illustrating how a trace is composed of multiple transactions, and each transaction is composed of multiple spans.](./img/diagram-transaction-trace.png)
8282

@@ -227,4 +227,4 @@ Dynamic sampling ensures complete traces by retaining all transactions associate
227227

228228
Use the [Trace Explorer](/product/explore/traces/) to search for traces containing spans that meet your specific query conditions. This helps you find distributed traces that give you a connected view of your application and can help you debug and optimize your code.
229229

230-
Through [Performance](/product/performance/) and [Discover](/product/explore/discover-queries/), you can also view trace data in the [Trace View](/concepts/key-terms/tracing/trace-view/) page.
230+
Through [Performance](/product/insights/overview/) and [Discover](/product/explore/discover-queries/), you can also view trace data in the [Trace View](/concepts/key-terms/tracing/trace-view/) page.

docs/concepts/search/index.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ Here are some examples of valid comparison operator searches:
5454

5555
<Alert>
5656

57-
`OR` and `AND` search conditions are only available for [Discover](/product/explore/discover-queries/), [Performance](/product/performance/), and [Metric Alerts](/product/alerts-notifications/metric-alerts/).
57+
`OR` and `AND` search conditions are only available for [Discover](/product/explore/discover-queries/), [Insights Overview](/product/insights/overview/), and [Metric Alerts](/product/alerts-notifications/metric-alerts/).
5858

5959
</Alert>
6060

docs/concepts/search/searchable-properties/events.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ Below is a list of keys and tokens that can be used in the event search.
3030

3131
### `apdex(threshold)`
3232

33-
Returns results with the [Apdex score](/product/performance/metrics/#apdex) that you entered. Values must be between `0` and `1`. Higher apdex values indicate higher user satisfaction.
33+
Returns results with the [Apdex score](/product/insights/overview/metrics/#apdex) that you entered. Values must be between `0` and `1`. Higher apdex values indicate higher user satisfaction.
3434

3535
- **Type:** number
3636

@@ -685,7 +685,7 @@ Span ID of the root span of the root transaction in the event.
685685

686686
### `transaction`
687687

688-
For [transactions](/product/performance/transaction-summary/#what-is-a-transaction), the name of the transaction. For errors, the name of the associated transaction.
688+
For [transactions](/product/insights/overview/transaction-summary/#what-is-a-transaction), the name of the transaction. For errors, the name of the associated transaction.
689689

690690
- **Type:** string
691691

@@ -715,7 +715,7 @@ The [Unreal Crash Context Type](https://docs.unrealengine.com/4.27/en-US/API/Run
715715

716716
### `user_misery(number)`
717717

718-
Returns transactions with the defined user misery value. [User Misery](/product/performance/metrics/#user-misery) is a user-weighted performance metric that counts the number of unique users who were frustrated; "frustration" is measured as a response time four times the satisfactory response time threshold (in milliseconds). It highlights transactions that have the highest impact on users.
718+
Returns transactions with the defined user misery value. [User Misery](/product/insights/overview/metrics/#user-misery) is a user-weighted performance metric that counts the number of unique users who were frustrated; "frustration" is measured as a response time four times the satisfactory response time threshold (in milliseconds). It highlights transactions that have the highest impact on users.
719719

720720
- **Type:** number
721721

docs/concepts/search/searchable-properties/issues.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -426,7 +426,7 @@ A trace represents the record of the entire operation you want to measure or tra
426426

427427
### `transaction`
428428

429-
For [transactions](/product/performance/transaction-summary/#what-is-a-transaction), the name of the transaction. For errors, the name of the associated transaction.
429+
For [transactions](/product/insights/overview/transaction-summary/#what-is-a-transaction), the name of the transaction. For errors, the name of the associated transaction.
430430

431431
- **Type:** string
432432

0 commit comments

Comments
 (0)