Settings API - Span link attributes schema table

Published Sep 25, 2025

Span link attributes (`builtin:span-link-attribute)`

While Dynatrace automatically captures all OpenTracing and OpenTelemetry span link attributes, it only stores span link attribute values when the related keys are specified in the allow-list below. By omitting personal data you can meet your organization's privacy requirements and control the amount of stored monitoring data.

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

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

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 Type Description Required

Property	Type	Description	Required
Key `key`	text	Key of the span link attribute to store	required
Masking `masking`	enum	If this attribute contains confidential data, turn on masking to conceal its value from users Introduce more granular control over the visibility of attribute values. Choose Do not mask to allow every user to see the actual value and use it in defining other configurations. Choose Mask entire value to hide the whole value of this attribute from everyone who does not have 'View sensitive request data' permission. These attributes can't be used to define other configurations. Choose Mask only confidential data to apply automatic masking strategies to your data. These strategies include, for example, credit card numbers, IBAN, IPs, email-addresses, etc. It may not be possible to recognize all sensitive data so please always make sure to verify that sensitive data is actually masked. If sensitive data is not recognized, please use Mask entire value instead. Users with 'View sensitive request data' permission will be able to see the entire value, others only the non-sensitive parts. These attributes can't be used to define other configurations. `NOT_MASKED` `MASK_ONLY_CONFIDENTIAL_DATA` `MASK_ENTIRE_VALUE`	required

Key
key

text

Key of the span link attribute to store

required

Masking
masking

enum

If this attribute contains confidential data, turn on masking to conceal its value from users

Introduce more granular control over the visibility of attribute values.
Choose Do not mask to allow every user to see the actual value and use it in defining other configurations.
Choose Mask entire value to hide the whole value of this attribute from everyone who does not have 'View sensitive request data' permission. These attributes can't be used to define other configurations. Choose Mask only confidential data to apply automatic masking strategies to your data. These strategies include, for example, credit card numbers, IBAN, IPs, email-addresses, etc. It may not be possible to recognize all sensitive data so please always make sure to verify that sensitive data is actually masked. If sensitive data is not recognized, please use Mask entire value instead. Users with 'View sensitive request data' permission will be able to see the entire value, others only the non-sensitive parts. These attributes can't be used to define other configurations.

NOT_MASKED
MASK_ONLY_CONFIDENTIAL_DATA
MASK_ENTIRE_VALUE

required

Settings API - Span link attributes schema table

Span link attributes (builtin:span-link-attribute)

Authentication

Parameters

Span link attributes (`builtin:span-link-attribute)`