OTLP (Open Telemetry) Filters

George Alpizar
George Alpizar
  • Updated

Overview

This filter type can be used to process OTLP (Open Telemetry) traces. 

This filter type samples failed and high-latency traces with successful traces and a sampling probability. 

This filter supports OTel traces.


Review Parameters

Review the following parameters that you can configure in the Edge Delta App:

YAML Description
name

Enter a descriptive label for this filter / processor. 

When you create a workflow, you will use this label to enter your filter into the workflow.

This parameter is required. 

Review the following example: 

name: opentelemetry_trace_filter
type

Enter buffered-otlp-trace-processor.

This parameter is required. 

Review the following example: 

type: buffered-otlp-trace-processor
trace_deadline

Enter a deadline to wait for the last event of a trace. 

When a deadline is reached, the filter will be applied to the events of the trace. 

30s is the default value. 

This parameter is optional. 

Review the following example: 

trace_deadline: 1m
should_filter_traces

Enter true or false to filter traces based on failures, high-latencies, and sampling rate. 

This parameter is optional. 

Review the following example: 

should_filter_traces: true
failure_path

Enter the path where the failure information will be obtained from. 

The obtained value will be converted into a string. 

You can enter a name or attribute.

This parameter is optional. 

Review the following example: 

failure_path: "attributes.result_code"
failure_value_pattern

Enter a pattern to match against the obtain value from failure_path.

This parameter is optional. 

Review the following example: 

failure_value_pattern: "(4|5)xx"
latency_threshold

Enter a threshold value for latency. 

If a high-latency trace exceeds the entered value, then that trace will pass the filter. 

This parameter is optional. 

Review the following example: 

latency_threshold: 2500.0
success_sample_rate

Enter a floating number between 0 and 1. 

0.0 is the default value. 

This parameter is optional. 

Review the following example: 

success_sample_rate: 0.1

Review Sample Configuration

Review the following sample configuration:

  - name: opentelemetry_trace_filter
    type: buffered-otlp-trace-processor
    trace_deadline: 1m
    should_filter_traces: true
    failure_path: "attributes.result_code"
    failure_value_pattern: "(4|5)xx"
    latency_threshold: 2500.0
    success_sample_rate: 0.1

 

Share this document