• Home
  • Dynatrace API
  • Configuration
  • RUM
  • Web application configuration
  • Error rules
  • GET error rules

Web application configuration API - GET error rules

Get the configuration of error rules in the specified application.

The request produces an application/json payload.

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

ParameterTypeDescriptionInRequired
idstring

The ID of the required web application.

pathrequired

Response

Response codes

CodeTypeDescription
200ApplicationErrorRules

Success

Response body objects

The ApplicationErrorRules object

Configuration of error rules in the web application.

ElementTypeDescription
ignoreJavaScriptErrorsInApdexCalculationboolean

Exclude (true) or include (false) JavaScript errors in Apdex calculation.

ignoreHttpErrorsInApdexCalculationboolean

Exclude (true) or include (false) HTTP errors listed in httpErrorRules in Apdex calculation.

ignoreCustomErrorsInApdexCalculationboolean

Exclude (true) or include (false) custom errors listed in customErrorRules in Apdex calculation.

httpErrorRulesHttpErrorRule[]

An ordered list of HTTP errors.

Rules are evaluated from top to bottom; the first matching rule applies.

customErrorRulesCustomErrorRule[]

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.

ElementTypeDescription
considerUnknownErrorCodeboolean

If true, match by errors that have unknown HTTP status code.

considerBlockedRequestsboolean

If true, match by errors that have CSP Rule violations.

errorCodesstring

The HTTP status code or status code range to match by.

This field is required if considerUnknownErrorCode AND considerBlockedRequests are both set to false.

filterByUrlboolean

If true, filter errors by URL.

filterstring

The matching rule for the URL.

The element can hold these values
  • BEGINS_WITH
  • CONTAINS
  • ENDS_WITH
  • EQUALS
urlstring

The URL to look for.

captureboolean

Capture (true) or ignore (false) the error.

impactApdexboolean

Include (true) or exclude (false) the error in Apdex calculation.

considerForAiboolean

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.

ElementTypeDescription
keyPatternstring

The key of the error to look for.

keyMatcherstring

The matching operation for the keyPattern.

The element can hold these values
  • BEGINS_WITH
  • CONTAINS
  • ENDS_WITH
  • EQUALS
valuePatternstring

The value of the error to look for.

valueMatcherstring

The matching operation for the valuePattern.

The element can hold these values
  • BEGINS_WITH
  • CONTAINS
  • ENDS_WITH
  • EQUALS
captureboolean

Capture (true) or ignore (false) the error.

impactApdexboolean

Include (true) or exclude (false) the error in Apdex calculation.

customAlertingboolean

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 } ] }
Related topics
  • Configure error detection for web applications

    Configure your application to capture or ignore request, custom, and JavaScript errors.