Settings API - Service Detection v2 for OneAgent schema table

  • Published Sep 25, 2025

Service Detection v2 for OneAgent (builtin:service-detection-v2-for-oneagent)

Enabling SDv2 for OneAgent will use the same attribute-based rules as OpenTelemetry for detecting services, endpoints, and failures. Refer to the SDv2 documentation for more information.

This is a Public Preview feature. You must complete the access request form and agree to preview terms before enabling.

Important

The services matching your conditions will get new metric keys, breaking existing API queries, dashboards, and service names. Custom, opaque, third party, database, and message queue services are detected differently in SDv2. Analysis views for service to database and message queue operations will be announced in upcoming releases.

Schema IDSchema groupsScope
builtin:service-detection-v2-for-oneagent
  • group:service-detection
CLOUD_APPLICATION_NAMESPACE - Kubernetes namespace
KUBERNETES_CLUSTER - Kubernetes cluster
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:service-detection-v2-for-oneagent
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:service-detection-v2-for-oneagent
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:service-detection-v2-for-oneagent

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
Enable Service detection v2
enableServiceDetectionV2
boolean-required
Matching condition
condition
text

Limits the opt-in’s scope by filtering with DQL matcher conditions on a selected set of attributes.

Service detection v2 is only applied if this condition matches. Allowed attributes: dt.agent.module.type, k8s.cluster.name, k8s.namespace.name, k8s.workload.name, dt.host_group.id If empty, the condition will always match.

required