• Home
  • Dynatrace API
  • Environment
  • Settings
  • Schemas
  • Simple detection rules

Settings 2.0 - Simple detection rules schema

Simple detection rules (builtin:process-group.simple-detection-rule)

Simple process group detection rules enable you to adapt the default process-group detection logic for deep monitored processes via environment variables or Java system properties. More about custom process-group detection

Note: Detection rules change the composition, makeup, and identity of a process group, not just the name. If you only need to change default name use the naming rules instead.

Process-group detection rules only affect processes that are deep monitored by the Dynatrace OneAgent and require a restart of your processes to affect how processes are identified and grouped.

Schema IDSchema groupsScope
builtin:process-group.simple-detection-rule
  • group:processes-and-containers.processes
  • group:processes-and-containers
environment
Retrieve schema via Settings API
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:process-group.simple-detection-rule
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:process-group.simple-detection-rule
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:process-group.simple-detection-rule

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

PropertyLabelTypeDescriptionRequired
enabledEnabledboolean-required
ruleTypeProperty sourceenum

Source to use to separate processes into multiple process groups.

required
groupIdentifierGroup identifiertext

If Dynatrace detects this property at startup of a process, it will use its value to identify process groups more granular.

required
instanceIdentifierInstance identifiertext

Use a variable to identify instances within a process group.

The type of variable is the same as selected in 'Property source'.

required
processTypeRestrict this rule to specific process typestext

Note: Not all types can be detected at startup.

optional