Settings API - Service splitting schema table

  • Published Jun 30, 2025

Service splitting (builtin:service-splitting-rules)

Define rules to split services based on resource attributes defined in the Semantic Dictionary and custom attributes. Rules are evaluated in order and the first matching rule applies.

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

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
Enabled
enabled		boolean

If enabled, the rule will be evaluated.

required
Rule
rule		Rule-required
The Rule object
PropertyTypeDescriptionRequired
Rule name
ruleName		text-required
Description
description		text-optional
Matching condition
condition		text

Limits the scope of the service splitting rule using DQL matcher conditions on resource attributes.

A rule is applied only if the condition matches, otherwise the ruleset evaluation continues.

If empty, the condition will always match.

optional
Split services by resource attributes
serviceSplittingAttributes		Set<splitBy>

Define the entire set of resource attributes that should split your services in the matching scope.

Each attribute that exists will contribute to the final service ID.

required
The splitBy object
PropertyTypeDescriptionRequired
Attribute key
key		text-required