• Home
  • Dynatrace API
  • Configuration
  • Anomaly detection
  • Process groups
  • GET configuration

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.

GETManagedDynatrace for Governmenthttps://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/processGroups/{id}
SaaShttps://{your-environment-id}.live.dynatrace.com/api/config/v1/anomalyDetection/processGroups/{id}
Environment ActiveGatehttps://{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

ParameterTypeDescriptionInRequired
idstring

The Dynatrace entity ID of the required process group.

pathrequired

Response

Response codes

CodeTypeDescription
200AnomalyDetectionPG

Success

400ErrorEnvelope

Failed. The input is invalid.

404ErrorEnvelope

Process group doesn't exist

Response body objects

The AnomalyDetectionPG object

Configuration of anomaly detection for the process group.

ElementTypeDescription
availabilityMonitoringAvailabilityMonitoringPG

Configuration of the availability monitoring for the process group.

The AvailabilityMonitoringPG object

Configuration of the availability monitoring for the process group.

ElementTypeDescription
methodstring

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
minimumThresholdinteger

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:

GET anomaly detection config - process group

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

Related topics
  • Prediction-based anomaly detection

    Read how Dynatrace automatically learns each applications’ unique traffic patterns and is thereby able to forecast the application’s traffic.

  • Davis® AI

    Get familiar with the capabilities of Davis AI.

  • Process groups

    Analyze process groups and customize process group naming, detection, and monitoring.