Process groups anomaly detection API - GET configuration

Gets the configuration of anomaly detection for the specified process group.

The request produces an application/json payload.

GET	ManagedDynatrace for Government	`https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/processGroups/{id}`
	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/config/v1/anomalyDetection/processGroups/{id}`
	Environment ActiveGate	`https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/processGroups/{id}`

Authentication

To execute this request, you need an access token with ReadConfig scope.

To learn how to obtain and use it, see Tokens and authentication.

Parameters

Parameter	Type	Description	In	Required
id	string	The Dynatrace entity ID of the required process group.	path	required

Response

Response codes

Code	Type	Description
200	AnomalyDetectionPG	Success
400	ErrorEnvelope	Failed. The input is invalid.
404	ErrorEnvelope	Process group doesn't exist

Response body objects

The `AnomalyDetectionPG` object

Configuration of anomaly detection for the process group.

Element	Type	Description
availabilityMonitoring	AvailabilityMonitoringPG	Configuration of the availability monitoring for the process group.

The `AvailabilityMonitoringPG` object

Configuration of the availability monitoring for the process group.

Element Type Description

method

string

Element	Type	Description
method	string	How to monitor the availability of the process group: `PROCESS_IMPACT`: Alert if any process of the group becomes unavailable. `MINIMUM_THRESHOLD`: Alert if the number of active processes in the group falls below the specified threshold. `OFF`: Availability monitoring is disabled. The element can hold these values `MINIMUM_THRESHOLD` `OFF` `PROCESS_IMPACT`
minimumThreshold	integer	Alert if the number of active processes in the group is lower than this value.

How to monitor the availability of the process group:

PROCESS_IMPACT: Alert if any process of the group becomes unavailable.
MINIMUM_THRESHOLD: Alert if the number of active processes in the group falls below the specified threshold.
OFF: Availability monitoring is disabled.

The element can hold these values

MINIMUM_THRESHOLD
OFF
PROCESS_IMPACT

minimumThreshold

integer

Alert if the number of active processes in the group is lower than this value.

Response body JSON model

json
{
  "availabilityMonitoring": {
    "method": "MINIMUM_THRESHOLD",
    "minimumThreshold": 5
  }
}

Example

In this example, the request gets the configuration of anomaly detection for the process group with the ID of PROCESS_GROUP-52B42D0616D556F5.

The API token is passed in the Authorization header.

The configuration has the following settings:

Curl

bash
curl -L -X GET 'https://mySampleEnv.live.dynatrace.com/api/config/v1/anomalyDetection/processGroups/PROCESS_GROUP-52B42D0616D556F5' \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

Request URL

plaintext
https://mySampleEnv.live.dynatrace.com/api/config/v1/anomalyDetection/processGroups/PROCESS_GROUP-52B42D0616D556F5

Response body

json
{
  "availabilityMonitoring": {
    "method": "MINIMUM_THRESHOLD",
    "minimumThreshold": 10
  }
}

Response code

200