Settings API - Span context propagation schema table

Span context propagation (builtin:span-context-propagation)

Context propagation enables you to connect PurePaths through OpenTelemetry. Define rules to enable context propagation for certain spans within OneAgent.

Note: This config does not apply to Trace ingest.

Schema IDSchema groupsScope
builtin:span-context-propagation
  • group:service-monitoring
  • group:service-monitoring.spans
environment
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:span-context-propagation
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:span-context-propagation
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:span-context-propagation

Authentication

To execute this request, you need an access token with Read settings (settings.read) scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

PropertyTypeDescriptionRequired
Context Propagation Rule
contextPropagationRule		SpanContextPropagationRule-required
The SpanContextPropagationRule object
PropertyTypeDescriptionRequired
Rule name
ruleName		text-required
Rule action
ruleAction		enum
  • PROPAGATE
  • DONT_PROPAGATE
required
Matchers
matchers		SpanMatcher[]-required
The SpanMatcher object
PropertyTypeDescriptionRequired
Source
source		enum
  • SPAN_NAME
  • SPAN_KIND
  • ATTRIBUTE
  • INSTRUMENTATION_SCOPE_NAME
  • INSTRUMENTATION_SCOPE_VERSION
required
Key
sourceKey		text-required
Comparison Type
type		enum

affects value

  • EQUALS
  • CONTAINS
  • STARTS_WITH
  • ENDS_WITH
  • DOES_NOT_EQUAL
  • DOES_NOT_CONTAIN
  • DOES_NOT_START_WITH
  • DOES_NOT_END_WITH
required
Value
value		text

evaluated at context injection

required
Value
spanKindValue		enum
  • INTERNAL
  • SERVER
  • CLIENT
  • PRODUCER
  • CONSUMER
required
Case sensitive
caseSensitive		boolean

affects value and key

required