APM Filters

Enter a descriptive label for this filter / processor. 

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

This parameter is required. 

Review the following example: 

name: elastic_apm_trace_filter

Enter buffered-elastic-apm-processor.

This parameter is required. 

Review the following example: 

type: buffered-elastic-apm-processor

Configure how to display separated, new elastic APM logs from each other, such as:  

• <separator><metadata 1><trace 1-1>...<trace 1-x><separator><metadata 2><trace 2-1>...<trace 2-y>

This parameter is optional. 

Review the following example: 

payload_separator: "-----------------"

Enter a comma-separated list of approved trace types to ingest and process, such as: 

• "transaction", "span", "error" and "metricset"

Any ingested type that is not an enabled type will be discarded during tracing processing. 

transaction,span,error,metricset is the default value. 

This parameter is optional. 

Review the following example: 

enabled_types: "transaction,span,error,metricset"

Enter a comma-separated list of trace types to optimize, such as: 

• "transaction", "span", "error" and "metricset"

By default, optimized types are ignored, with the exception of success sampling, failure, and high latency conditions. 

transaction,span,error,metricset is the default value. 

This parameter is optional. 

Review the following example: 

optimize_types: "transaction,span"

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

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

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

The obtained value will be converted into a string. 

This parameter is optional. 

Review the following example: 

failure_path: "transaction.result"

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

This parameter is optional. 

Review the following example: 

failure_value_pattern: "HTTP (4|5)xx"

Enter a path to override the latency path for transactions.

transaction.duration is the default value. 

This parameter is optional. 

Review the following example: 

transaction_latency_path: "transaction.duration"

Enter a path to override the latency path for spans. 

span.duration is the default value. 

This parameter is optional. 

Review the following example: 

span_latency_path: "span.duration"

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: 35.5

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.2