OpenTelemetryTraceCondition¶

An OpenTelemetryTraceCondition object represents a condition to trigger generating OpenTelemetry Traces. These conditions con be configured in a settings file (see logging.opentelemetry_trace_conditions) or manipulated at runtime using the REST API calls listed in OpenTelemetryTraceConditions endpoint.

json OpenTelemetryTraceCondition : object¶

OpenTelemetryTraceCondition

Optional members:¶

acl : string¶

The subnet of the entry. Note that the YAML settings file allows multiple subnets for convenience. This object does not allow multiple subnets to be specified.

type : string¶

set to “OpenTelemetryTraceCondition”

edns_option_required : boolean = false¶

Whether or not the incoming query has an EDNS TRACEPARENT option specifying the TraceID.

qid : integer¶

A specific query id required to start tracing

qnames : array of string¶

suffixmatch with the incoming qname is done against this list

qtypes : array of string¶

List of qtypes to trigger tracing on

traceid_only : boolean = false¶

Whether or not to pick up the TraceID from EDNS data (if present) and placed into the protobuf openTelemetryTraceID field; no detailed openTelemetryData is produced

Example:

{
  "acl": "192.0.2.1/32",
  "edns_option_required": false,
  "qid": 1,
  "qnames": ["example.com.", "example.net."],
  "qtypes": ["AAAA", "A"],
  "traceid_only": false
  "type": "OpenTelemetryTraceCondition"
}