Settings API - Custom process monitoring rules schema table

Custom process monitoring rules (`builtin:process.custom-process-monitoring-rule`)

Dynatrace OneAgent automatically monitors all process groups detected in your environment (processes running during OneAgent installation must be restarted to initiate monitoring).

OneAgent additionally provides deep monitoring for all processes that it can monitor at the request- and PurePath levels. Define process monitoring rules below if you don’t want to monitor all your processes automatically, or if you need to define an exception for specific processes.

Schema ID	Schema groups	Scope
`builtin:process.custom-process-monitoring-rule`	`group:processes-and-containers.processes` `group:processes-and-containers`	`HOST_GROUP` - Host Group `environment`

Retrieve schema via Settings API

GET	Managed	`https://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:process.custom-process-monitoring-rule`
	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:process.custom-process-monitoring-rule`
	Environment ActiveGate	`https://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:process.custom-process-monitoring-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

Property	Label	Type	Description	Required
enabled	Enabled	boolean	-	required
mode	Mode	enum	-	required
condition	Condition	Condition	-	required

Request body objects

The `Condition` object

Property	Label	Type	Description	Required
item	Condition target	enum	-	required
envVar	Environment variable key	text	supported only with OneAgent 1.167+	required
operator	Condition operator	enum	-	required
value	Condition value	text	-	required