Settings API - Relative capture rate control for traces schema table

Published Oct 13, 2025

Relative capture rate control for traces (`builtin:traces.capture.rate.control)`

Configure the relative capture rate control for traces.

Schema ID	Schema groups	Scope
`builtin:traces.capture.rate.control`	-	`PROCESS_GROUP_INSTANCE` - Process `PROCESS_GROUP` - Process Group `CLOUD_APPLICATION` - Kubernetes workload `CLOUD_APPLICATION_NAMESPACE` - Kubernetes namespace `KUBERNETES_CLUSTER` - Kubernetes cluster `HOST_GROUP` - Host Group `environment`

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

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
Adaptive Sampling `adaptiveSamplingSwitch`	boolean	-	required
Adaptive Capture Rate `adaptiveCaptureRate`	float	Increase/Decrease relative trace capture frequency between 0.01-100	required
Fixed target capture rate `fixedCaptureRate`	integer	Set fixed target capture rate, allowed value between: 0-100%	required