Deprecation Notice: This feature is deprecated and will be removed in version 1.0.180.
Considerations
Before enabling probabilistic sampler, please note the following:
- Currently supports only traces.
- The action will arbitrarily filter out traces regardless of their properties, potentially dropping important traces, even if they were sampled by other samplers.
- All spans in a trace will be either entirely dropped or entirely sampled.
- The action will be positioned after all other sampling actions in the pipeline.
Use Cases
Cost Reduction- Some vendors charge based on the amount of data ingested. For self hosted destinations, the cost is correlated to the use of cloud resources which grows with the based on the amount of data you process and store. By Reducing traces volumes, you can reduce the amount of data ingested and reduce costs.
- Performance Trend Analysis - In certain scenarios, users may seek to collect sufficient data to understand performance trends without overwhelming the system with excessive telemetry data. For example, track latency trend.
- Telemetry Volume Management - When experiencing a sudden influx of telemetry data, probabilistic sampling can temporarily reduce data volume sent to your data destination.
Configuration Options
The ProbabilisticSampler action is configured using theodigos.io/v1alpha1.Action
CRD with the samplers
configuration section.
actionName
actionName
actionName
string
: Allows you to attach a meaningful name to the action for convenience.- This field is optional
- Odigos does not use or assume any meaning from this field
notes
notes
notes
string
: Allows you to attach notes regarding the action for convenience.- This field is optional
- Odigos does not use or assume any meaning from this field
disabled
disabled
disabled
boolean
: Allows you to temporarily disable the action, but keep it saved for future use.- This field is optional, and defaults to
false
signals *
signals *
signals
string[]
: An array with the signals that the action will operate on.- This field is required
- Supported values:
TRACES
samplers *
samplers *
samplers
object
: Configuration for sampling actions.- This field is required for this action type
probabilisticSampler *
probabilisticSampler *
probabilisticSampler
object
: Configuration for the ProbabilisticSampler.- This field is required for this action type
sampling_percentage *
sampling_percentage *
sampling_percentage
string
: Percentage at which items are sampled.- This field is required
- 100 = all items, 0 = no items
Basic Example
The following example demonstrates how to add a sampler with a 15% sampling percentage using the new Action CRD.1
Create a YAML file with the following content:
probabilistic-sampler.yaml
2
Apply the action to the cluster: