fix(dynamic-sampling): renaming retention policies to (dynamic) sampling policies

constantinius · constantinius · commit 3a07833dd2ab · 2024-11-14T13:43:12.000+01:00
diff --git a/docs/concepts/key-terms/tracing/trace-view.mdx b/docs/concepts/key-terms/tracing/trace-view.mdx
@@ -84,7 +84,7 @@ Also, in these cases you can click "Open In Discover" to see all the events in t
 
 Broken subtraces may be caused by:
 
-- SDK sampling. Setting a sample rate that's too low may prevent the SDK from sending a transaction. We recommend [sending us all of your transaction data](/product/performance/retention-priorities/#deciding-on-your-sdk-sample-rate).
+- SDK sampling. Setting a sample rate that's too low may prevent the SDK from sending a transaction. We recommend [sending us all of your transaction data](/organization/dynamic-sampling/#deciding-on-your-sdk-sample-rate).
 - [Ad blockers](/platforms/javascript/troubleshooting/#dealing-with-ad-blockers) may prevent transactions in browsers being sent, but HTTP requests to backend projects will still create child transactions
 - [Rate-limiting](/product/accounts/quotas/#limiting-events) on a project may cause only some events to be sent to Sentry
 - [Project permissions](/product/accounts/membership/#restricting-access) may mean you do not have access to transactions in another project
diff --git a/docs/organization/dynamic-sampling/index.mdx b/docs/organization/dynamic-sampling/index.mdx
@@ -38,19 +38,17 @@ Dynamic Sampling is different from the sampling that you can configure in the Se
 
 Also in contrast to the Dynamic Sampling, the SDK sample rate is never dynamically adjusted.
 
-## Retention Priorities
-
-
+## Dynamic Sampling Priorities
 
 <Note>
 
-Retention priorities are only available on the latest version of our plans, starting from 1M reserved transactions. Anyone in your org with owner or billing-level permissions can update your plan by going to Settings > Subscription, and clicking the "Manage Subscription" button.
+Dynamic Sampling priorities are only available on the latest version of our plans, starting from 1M reserved transactions. Anyone in your org with owner or billing-level permissions can update your plan by going to Settings > Subscription, and clicking the "Manage Subscription" button.
 
 </Note>
 
-While storing all your data makes sense at relatively low volumes, as your application scales, storing a raw copy of all your data has diminishing returns. When data reaches high volumes, Sentry begins to automatically prioritize retaining certain transactions over others with server-side data retention strategies called retention priorities.
+While storing all your data makes sense at relatively low volumes, as your application scales, storing a raw copy of all your data has diminishing returns. When data reaches high volumes, Sentry begins to automatically prioritize retaining certain transactions over others with server-side data sampling strategies called dynamic sampling priorities.
 
-It's important to note that even when we begin to only store the most valuable data based on retention priorities, the [performance metrics](/product/performance/metrics/) you see are still based on **all** the events you send to Sentry. This ensures that you get a full and complete view of your application's health.
+It's important to note that even when we begin to only store the most valuable data based on dynamic sampling priorities, the [performance metrics](/product/performance/metrics/) you see are still based on **all** the events you send to Sentry. This ensures that you get a full and complete view of your application's health.
 
 ## Prerequisites
 
@@ -70,8 +68,6 @@ It's important to note that even when we begin to only store the most valuable d
   - .NET: 3.22.0 or later
   - Go: 0.16.0 or later
 
-## Retention Priorities
-
 Below is a list of the transactions we prioritize and deprioritize. They are enabled by default, but can be updated on a per-project basis to better fit your organization's needs.
 
 ### Prioritized Transactions
@@ -80,7 +76,7 @@ Sentry automatically prioritizes and retains the following types of transactions
 
 #### Latest Release
 
-Latest releases are a retention priority because when you create a new release, we assume you'll want to have more visibility during the early adoption phase, which improves your ability to catch new issues as your release is gaining traction.
+Latest releases are a dynamic sampling priority because when you create a new release, we assume you'll want to have more visibility during the early adoption phase, which improves your ability to catch new issues as your release is gaining traction.
 Because you may want to deploy the same release in different environments, we'll also take your environment into account and prioritize those transactions.
 
 #### Dev Environments
@@ -97,7 +93,7 @@ Since dev environments usually generate a small number of transactions as compar
 
 <Note>
 
-You won't be able to disable the Low Volume Projects retention priority because it's set on an organization-wide level, not on a per-project basis.
+You won't be able to disable the Low Volume Projects dynamic sampling priority because it's set on an organization-wide level, not on a per-project basis.
 
 </Note>
 
@@ -110,7 +106,7 @@ We prioritize low-volume transactions for the same reason we prioritize low-volu
 
 ### Investigation Mode
 
-Our automated retention priorities work well in a generic manner to collect a baseline of samples because they prioritize retaining data that is valuable for any customer at any given time. However, there are certain scenarios, such as investigating a particular issue, when very specific data becomes temporarily more important. In such cases, sometimes the automated sampling priorities do not provide enough samples, so you may want to create investigation rules.
+Our automated dynamic sampling priorities work well in a generic manner to collect a baseline of samples because they prioritize retaining data that is valuable for any customer at any given time. However, there are certain scenarios, such as investigating a particular issue, when very specific data becomes temporarily more important. In such cases, sometimes the automated sampling priorities do not provide enough samples, so you may want to create investigation rules.
 
 Investigation rules are sampling rules that can be created through the Sentry UI to temporarily boost the number of transactions collected for a particular scenario (for example, transactions with specific tag values). These rules can be created to retain more samples when too few (less than 5) are available. Once created, a rule will be active for up to 48 hours or until 100 samples are collected. You'll be notified via email when enough transactions have been collected.
 
@@ -158,9 +154,9 @@ We deprioritize health check type transactions because while they're important f
 - `*/readyz`
 - `*/ping`
 
-### How to Change Retention Priorities
+### How to Change Dynamic Sampling Priorities
 
-To make changes to a project's retention priorities in Sentry, go to **Settings > Projects**, select the project you're interested in, then scroll down to "Performance" in the "PROCESSING" section and make any updates under "RETENTION PRIORITIES" using the toggles. Each of your projects can have an individual set of retention priorities.
+To make changes to a project's dynamic sampling priorities in Sentry, go to **Settings > Projects**, select the project you're interested in, then scroll down to "Performance" in the "PROCESSING" section and make any updates under "DYNAMIC SAMPLING PRIORITIES" using the toggles. Each of your projects can have an individual set of dynamic sampling priorities.
 
 <Arcade src="https://demo.arcade.software/bEv0SO2UEmqbVJVok99o?embed" />
 
diff --git a/docs/organization/early-adopter-features/index.mdx b/docs/organization/early-adopter-features/index.mdx
@@ -20,6 +20,6 @@ Limitations:
 - [Issue Views](/product/issues/issue-views/)
 - [Issue Status](/product/issues/states-triage/) tags
 - [Span Summary](/product/performance/transaction-summary/#span-summary)
-- [Investigation Mode](/product/performance/retention-priorities/#investigation-mode) for retention priorities in Tracing
+- [Investigation Mode](/organization/dynamic-sampling/#investigation-mode) for sampling priorities in Tracing
 - [Uptime Monitoring](/product/alerts/uptime-monitoring/)
 - [Dynamic Alerts](/product/alerts/create-alerts/metric-alert-config/#dynamic-alerts)
diff --git a/docs/product/explore/discover-queries/query-builder.mdx b/docs/product/explore/discover-queries/query-builder.mdx
@@ -64,7 +64,7 @@ Click on any of these sections to further refine your search. For example, click
 
 When performing searches on transaction events, based on your search criteria
 and sample rate, the events available may be limited because Discover uses
-sampled data only. Learn more by reading about [our retention priorities](/product/performance/retention-priorities/).
+sampled data only. Learn more by reading about [our sampling priorities](/organization/dynamic-sampling/).
 
 </Note>
 
diff --git a/docs/product/explore/traces/index.mdx b/docs/product/explore/traces/index.mdx
@@ -45,7 +45,7 @@ For a list of built-in key fields used in Sentry, check out our [Searchable Prop
 
 <Note>
 
-Trace Explorer uses sampled data. Your search results may be limited based on sampling rates and retention policies. Learn more about [retention priorities](/product/performance/retention-priorities/).
+Trace Explorer uses sampled data. Your search results may be limited based on sampling rates and retention policies. Learn more about [sampling priorities](/organization/dynamic-sampling/).
 
 </Note> 
 
