Settings API - Advanced detection rules schema table
Advanced detection rules (builtin:process-group.advanced-detection-rule)
Advanced process group detection rules enable you to adapt the detection logic for deep monitored processes by leveraging properties that are automatically detected by OneAgent during the startup of a process.
Advanced detection rules are capable to extract additional process group and instance identifier from processes to fine tune the automatic detection logic of OneAgent. 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 (<your-dynatrace-url>/#settings/pgnamingsettings "Visit Naming rules page") 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 ID | Schema groups | Scope |
|---|---|---|
builtin:process-group.advanced-detection-rule |
| environment |
Parameters
| Property | Label | Type | Description | Required |
|---|---|---|---|---|
| enabled | Enabled | boolean | - | required |
| processDetection | Process group detection | processGroupDetection | Apply this rule to processes where the selected property contains the specified string. | required |
| groupExtraction | Process group extraction | processGroupExtraction | You can define the properties that should be used to identify your process groups. | required |
| instanceExtraction | Process instance extraction | processInstanceExtraction | You can define the properties that should be used to identify your process instances. | required |
Request body objects
The delimiter object
| Property | Label | Type | Description | Required |
|---|---|---|---|---|
| from | Delimit from | text | - | required |
| to | Delimit to | text | - | required |
| removeIds | Ignore numbers | boolean | (e.g. versions, hex, dates, and build numbers) | required |
The processGroupDetection object
| Property | Label | Type | Description | Required |
|---|---|---|---|---|
| property | Property | text | - | required |
| containedString | Contained string | text | (case sensitive) | required |
| restrictToProcessType | Restrict this rule to specific process types. | text | Note: Not all types can be detected at startup. | optional |
The processGroupExtraction object
| Property | Label | Type | Description | Required |
|---|---|---|---|---|
| property | Property | text | - | required |
| delimiter | - | delimiter | Optionally delimit this property between From and To. | required |
| standaloneRule | Standalone rule | boolean | If this option is selected, the default Dynatrace behavior is disabled for these detected processes. Only this rule is used to separate the process group. If this option is not selected, this rule contributes to the default Dynatrace process group detection. | required |
The processInstanceExtraction object
| Property | Label | Type | Description | Required |
|---|---|---|---|---|
| property | Property | text | - | optional |
| delimiter | - | delimiter | Optionally delimit this property between From and To. | required |