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 | Application | Success |
Response body objects
The ApplicationErrorRules
object
Configuration of error rules in the web application.
Element | Type | Description |
---|---|---|
ignoreJavaScriptErrorsInApdexCalculation | boolean | Exclude ( |
ignoreHttpErrorsInApdexCalculation | boolean | Exclude ( |
ignoreCustomErrorsInApdexCalculation | boolean | Exclude ( |
httpErrorRules | Http | An ordered list of HTTP errors. Rules are evaluated from top to bottom; the first matching rule applies. |
customErrorRules | Custom | 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 |
considerBlockedRequests | boolean | If |
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 |
filterByUrl | boolean | If |
filter | string | The matching rule for the URL. |
url | string | The URL to look for. |
capture | boolean | Capture ( |
impactApdex | boolean | Include ( |
considerForAi | boolean | Include ( |
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 ( |
impactApdex | boolean | Include ( |
customAlerting | boolean | Include ( |
Response body JSON model
{
"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
}
]
}