Settings API - Global trace ingest rate control schema table

  • Published Dec 15, 2025

Global trace ingest rate control (builtin:global.trace.ingest.control)

Configure the global trace ingest rate.

Schema IDSchema groupsScope
builtin:global.trace.ingest.control
  • group:service-monitoring
  • group:preferences
environment
Retrieve schema via Settings API
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:global.trace.ingest.control
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:global.trace.ingest.control
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:global.trace.ingest.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

PropertyTypeDescriptionRequired
Usable adaptive volume
usableAdaptiveVolume		integer

Percentage of the maximum paid volume that should be used for adaptive sampling, between 1-100

A value of 80% would mean that 20% of the paid volume are reserved for fixed rate sampling.

Required