The following telemetry is emitted by this component.
Count of bytes that were sampled or not per sampling policy
| Unit | Metric Type | Value Type | Monotonic | Stability |
|---|
| By | Sum | Int | true | Development |
| Name | Description | Values | Semantic Convention |
|---|
| policy | Name of the policy | Any Str | - |
| sampled | Whether the sampling decision was sampled or not, false can mean either not sampled or dropped | Any Bool | - |
| decision | The sampling decision | Str: sampled, not_sampled, dropped | - |
Count of spans that were sampled or not per sampling policy
| Unit | Metric Type | Value Type | Monotonic | Stability |
|---|
| {spans} | Sum | Int | true | Development |
| Name | Description | Values | Semantic Convention |
|---|
| policy | Name of the policy | Any Str | - |
| sampled | Whether the sampling decision was sampled or not, false can mean either not sampled or dropped | Any Bool | - |
| decision | The sampling decision | Str: sampled, not_sampled, dropped | - |
Count of spans skipped while rewriting the effective th because their tracestate could not be parsed
| Unit | Metric Type | Value Type | Monotonic | Stability |
|---|
| {spans} | Sum | Int | true | Development |
Count of traces that were sampled or not per sampling policy
| Unit | Metric Type | Value Type | Monotonic | Stability |
|---|
| {traces} | Sum | Int | true | Development |
| Name | Description | Values | Semantic Convention |
|---|
| policy | Name of the policy | Any Str | - |
| sampled | Whether the sampling decision was sampled or not, false can mean either not sampled or dropped | Any Bool | - |
| decision | The sampling decision | Str: sampled, not_sampled, dropped | - |
Number of spans that were able to be immediately released due to a decision cache hit.
| Unit | Metric Type | Value Type | Monotonic | Stability |
|---|
| {spans} | Sum | Int | true | Development |
| Name | Description | Values | Semantic Convention |
|---|
| sampled | Whether the sampling decision was sampled or not, false can mean either not sampled or dropped | Any Bool | - |
Global count of traces that were sampled or not by at least one policy
| Unit | Metric Type | Value Type | Monotonic | Stability |
|---|
| {traces} | Sum | Int | true | Development |
| Name | Description | Values | Semantic Convention |
|---|
| sampled | Whether the sampling decision was sampled or not, false can mean either not sampled or dropped | Any Bool | - |
| decision | The sampling decision | Str: sampled, not_sampled, dropped | - |
Counts the arrival of new traces
| Unit | Metric Type | Value Type | Monotonic | Stability |
|---|
| {traces} | Sum | Int | true | Development |
Latency (in milliseconds) of each run of the sampling decision timer
| Unit | Metric Type | Value Type | Stability |
|---|
| ms | Histogram | Int | Development |
Time (in seconds) from the sampling decision was taken and the arrival of a late span
| Unit | Metric Type | Value Type | Stability |
|---|
| s | Histogram | Int | Development |
Count of sampling policy evaluation errors
| Unit | Metric Type | Value Type | Monotonic | Stability |
|---|
| {errors} | Sum | Int | true | Development |
Total number of executions of a specific sampling policy
| Unit | Metric Type | Value Type | Monotonic | Stability |
|---|
| {executions} | Sum | Int | true | Development |
| Name | Description | Values | Semantic Convention |
|---|
| policy | Name of the policy | Any Str | - |
Total time spent (in microseconds) executing a specific sampling policy
| Unit | Metric Type | Value Type | Monotonic | Stability |
|---|
| us | Sum | Int | true | Development |
| Name | Description | Values | Semantic Convention |
|---|
| policy | Name of the policy | Any Str | - |
Count of traces that needed to be dropped before the configured wait time
| Unit | Metric Type | Value Type | Monotonic | Stability |
|---|
| {traces} | Sum | Int | true | Development |
Time (in seconds) from arrival of a new trace until its removal from memory
| Unit | Metric Type | Value Type | Stability |
|---|
| s | Histogram | Int | Development |
Tracks the number of traces current on memory
| Unit | Metric Type | Value Type | Stability |
|---|
| {traces} | Gauge | Int | Development |
Count of traces that were dropped because they were too large
| Unit | Metric Type | Value Type | Monotonic | Stability |
|---|
| {traces} | Sum | Int | true | Development |
This component has the following feature gates:
| Feature Gate | Stage | Description | From Version | To Version | Reference |
|---|
processor.tailsamplingprocessor.metricstatcountbytessampled | alpha | When enabled, a new metric stat_count_bytes_sampled will be available in the tail sampling processor. Differently from stat_count_traces_sampled, this metric will count the number of bytes sampled or not per sampling policy, where the original counts traces. | v0.152.0 | N/A | Link |
processor.tailsamplingprocessor.metricstatcountspanssampled | alpha | When enabled, a new metric stat_count_spans_sampled will be available in the tail sampling processor. Differently from stat_count_traces_sampled, this metric will count the number of spans sampled or not per sampling policy, where the original counts traces. | v0.95.0 | N/A | Link |
processor.tailsamplingprocessor.recordpolicy | alpha | When enabled, attaches the name of the policy (and if applicable, composite policy) responsible for sampling a trace in the 'tailsampling.policy', 'tailsampling.composite_policy', and tailsampling.cached_decision attributes. | v0.120.0 | N/A | Link |
processor.tailsamplingprocessor.tailstorageextension | alpha | When enabled, allows configuring tail_storage to use a tail storage extension implementation. | v0.150.0 | N/A | Link |
processor.tailsamplingprocessor.usetracestate | alpha | When enabled, sampling policies consult OpenTelemetry probability sampling information carried in W3C tracestate (the 'rv' and 'th' fields of the 'ot' section). The 'probabilistic' policy uses tracestate randomness for its sampling decision (falling back to the legacy FNV trace ID hash when no tracestate sampling info is present), and the processor rewrites the outgoing 'th' on sampled traces to the effective threshold across all matched policies. | v0.154.0 | N/A | Link |
For more information about feature gates, see the Feature Gates documentation.