Skip to content

Commit 4092b56

Browse files
committed
fix(dynamic-sampling): improved overview and description of dynamic sampling settings
1 parent 714bbef commit 4092b56

File tree

1 file changed

+10
-10
lines changed

1 file changed

+10
-10
lines changed
Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,24 @@
11
---
22
title: Dynamic Sampling
33
sidebar_order: 30
4-
description: "Dynamic Sampling allows users make the most of their quota by dynamically determine a target sample rate from the given volumes of the projects."
4+
description: "Dynamic Sampling allows users make the most of their quota by dynamically sample events from the overall volume."
55
---
66

7-
87
## Overview
98

10-
Dynamic Sampling provides a benefit to organizations with project of varying event volumes. It aims to provide a representative set of samples for events. High volume projects are sampled at a lower rate, while low volume projects are sampled at a higher rate, so that each has a similar set of significant events to investigate.
11-
12-
## Sampling mode
13-
14-
The sampling mode can be set at the organization level. This will apply to all projects within the organization. The available options are:
9+
When you are dealing with projects that generate high volumes of events, your quotas might be consumed quickly. Additionally, high volume projects will eat up a bigger portion of it, leaving less for other projects.
1510

16-
* **`organization`**: This is the default setting. It means that the sample rate is determined automatically at the organization level. This mode is also called "automatic", as the individual project sample rates are calculated by the volume of events in the project.
11+
Many events may be redundant or not useful for debugging. Dynamic Sampling allows you to make the most of your quota by dynamically determining a target sample rate from the given volumes of the projects.
1712

18-
When set to this mode, the project specific sample rates are continuously recalibrated, depending on the relative volumes of the projects.
13+
When you use Dynamic Sampling, your projects within an organization are sampled according to their event volumes of the past period. Higher volume projects are sampled at a lower rate, while lower volume projects are sampled at a higher rate or not sampled at all. This way, each project has a similar set of significant events to investigate, granting more visibility to the spans that actually matter.
1914

20-
* **`project`**: This means that the sample rate is configured at the project level. This is useful if you want to have specific sample rates for different projects.
15+
A sample rate is a percentage from 0% (no events are passed on) to 100% (all events are passed on).
2116

17+
## Modes
2218

19+
When you are using Dynamic Sampling for a specific organization, you can set the mode in which it operates. You can either choose the manual mode or the automatic mode:
2320

21+
* **`automatic`**: This is the default setting and it means that the sample rate for each project in the organization determined automatically. When you chose this mode, the project sample rates are calculated according to the relative volumes of the projects so that the projected sampled events fill organization quota, boosting low volume projects. This recalibration happens in regular intervals.
22+
When you set the mode to `automatic`, any manually set project sample rates are overridden.
2423

24+
* **`manual`**: In this mode, you can specifically set the sample rate for each project in the organization. This mode is useful when you want to have exact control over the sample rates of your projects. In this mode, no automatic recalibration happens.

0 commit comments

Comments
 (0)