Settings API - Span capturing schema table

Span capturing (`builtin:span-capturing`)

OpenTelemetry/OpenTracing spans are captured by default. Define rules to exclude specific spans.

Note: This config does not apply to Trace ingest.

Schema ID	Schema groups	Scope
`builtin:span-capturing`	`group:service-monitoring` `group:service-monitoring.spans`	`environment`

Retrieve schema via Settings API

GET	Managed	`https://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:span-capturing`
	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:span-capturing`
	Environment ActiveGate	`https://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:span-capturing`

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

Property	Label	Type	Description	Required
spanCaptureRule	Span Capture Rule	SpanCaptureRule	-	required

Request body objects

The `SpanMatcher` object

Property	Label	Type	Description	Required
source	Source	enum	-	required
sourceKey	Key	text	-	required
type	Comparison Type	enum	affects value	required
value	Value	text	evaluated at span start	required
spanKindValue	Value	enum	-	required
caseSensitive	Case sensitive	boolean	affects value and key	required

The `SpanCaptureRule` object

Property	Label	Type	Description	Required
ruleName	Rule name	text	-	required
ruleAction	Rule action	enum	-	required
matchers	Matchers	list	-	required