Web application configuration API - GET error rules

Get the configuration of error rules in the specified application.

The request produces an application/json payload.

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

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 ID of the required web application.	path	required

Response

Response codes

Code	Type	Description
200	ApplicationErrorRules	Success

Response body objects

The `ApplicationErrorRules` object

Configuration of error rules in the web application.

Element	Type	Description
ignoreJavaScriptErrorsInApdexCalculation	boolean	Exclude (`true`) or include (`false`) JavaScript errors in Apdex calculation.
ignoreHttpErrorsInApdexCalculation	boolean	Exclude (`true`) or include (`false`) HTTP errors listed in httpErrorRules in Apdex calculation.
ignoreCustomErrorsInApdexCalculation	boolean	Exclude (`true`) or include (`false`) custom errors listed in customErrorRules in Apdex calculation.
httpErrorRules	HttpErrorRule[]	An ordered list of HTTP errors. Rules are evaluated from top to bottom; the first matching rule applies.
customErrorRules	CustomErrorRule[]	An ordered list of custom errors. Rules are evaluated from top to bottom; the first matching rule applies.

The `HttpErrorRule` object

Configuration of the HTTP error in the web application.

Element	Type	Description
considerUnknownErrorCode	boolean	If `true`, match by errors that have unknown HTTP status code.
considerBlockedRequests	boolean	If `true`, match by errors that have CSP Rule violations.
errorCodes	string	The HTTP status code or status code range to match by. This field is required if considerUnknownErrorCode AND considerBlockedRequests are both set to `false`.
filterByUrl	boolean	If `true`, filter errors by URL.
filter	string	The matching rule for the URL. The element can hold these values `BEGINS_WITH` `CONTAINS` `ENDS_WITH` `EQUALS`
url	string	The URL to look for.
capture	boolean	Capture (`true`) or ignore (`false`) the error.
impactApdex	boolean	Include (`true`) or exclude (`false`) the error in Apdex calculation.
considerForAi	boolean	Include (`true`) or exclude (`false`) the error in Davis AI problem detection and analysis.

The `CustomErrorRule` object

Configuration of the custom error in the web application.

Element	Type	Description
keyPattern	string	The key of the error to look for.
keyMatcher	string	The matching operation for the keyPattern. The element can hold these values `BEGINS_WITH` `CONTAINS` `ENDS_WITH` `EQUALS`
valuePattern	string	The value of the error to look for.
valueMatcher	string	The matching operation for the valuePattern. The element can hold these values `BEGINS_WITH` `CONTAINS` `ENDS_WITH` `EQUALS`
capture	boolean	Capture (`true`) or ignore (`false`) the error.
impactApdex	boolean	Include (`true`) or exclude (`false`) the error in Apdex calculation.
customAlerting	boolean	Include (`true`) or exclude (`false`) the error in Davis AI problem detection and analysis.

Response body JSON model

json
{
  "ignoreJavaScriptErrorsInApdexCalculation": true,
  "ignoreHttpErrorsInApdexCalculation": true,
  "ignoreCustomErrorsInApdexCalculation": true,
  "httpErrorRules": [
    {
      "considerUnknownErrorCode": true,
      "considerBlockedRequests": true,
      "errorCodes": "400",
      "filterByUrl": true,
      "filter": "BEGINS_WITH",
      "url": "string",
      "capture": true,
      "impactApdex": true,
      "considerForAi": true
    }
  ],
  "customErrorRules": [
    {
      "keyPattern": "string",
      "keyMatcher": "BEGINS_WITH",
      "valuePattern": "string",
      "valueMatcher": "BEGINS_WITH",
      "capture": true,
      "impactApdex": true,
      "customAlerting": true
    }
  ]
}