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
  • Managed 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

Authentication

To execute this request, you need the Read configuration (ReadConfig) permission assigned to your API token. 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 Description
200

Success

Response body

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 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.

valuePattern string

The value of the error to look for.

valueMatcher string

The matching operation for the valuePattern.

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.

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.

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.