builtin:failure-detection.environment.parameters)Failure detection parameters that determine whether a service call is considered successful or failed. Use failure detection rules (<your-dynatrace-url>//ui/settings/builtin:failure-detection.environment.rules) to configure which services these parameters apply to.
These settings are not applied to Unified services.
| Schema ID | Schema groups | Scope |
|---|---|---|
builtin:failure-detection.environment.parameters |
| environment |
| GET | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:failure-detection.environment.parameters |
| SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:failure-detection.environment.parameters | |
| Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:failure-detection.environment.parameters |
To execute this request, you need an access token with Read settings (settings.read) scope. To learn how to obtain and use it, see Tokens and authentication.
| Property | Type | Description | Required |
|---|---|---|---|
Namename | text | - | required |
Descriptiondescription | text | - | optional |
HTTP response codeshttpResponseCodes | httpResponseCodes | - | required |
HTTP 404 (broken links)brokenLinks | brokenLinks | HTTP 404 response codes are thrown when a web server can't find a certain page. 404s are classified as broken links on the client side and therefore aren't considered to be service failures. By enabling this setting, you can have 404s treated as server-side service failures. | required |
Customize failure detection for specific exceptions and errorsexceptionRules | exceptionRules | - | required |
httpResponseCodes object| Property | Type | Description | Required |
|---|---|---|---|
HTTP response codes which indicate an error on the server sideserverSideErrors | text | - | required |
Treat missing HTTP response code as server side errorsfailOnMissingResponseCodeServerSide | boolean | - | required |
HTTP response codes which indicate client side errorsclientSideErrors | text | - | required |
Treat missing HTTP response code as client side errorfailOnMissingResponseCodeClientSide | boolean | - | required |
brokenLinks object| Property | Type | Description | Required |
|---|---|---|---|
Consider 404 HTTP response codes as failureshttp404NotFoundFailures | boolean | - | required |
Rules for broken links to related domainsbrokenLinkDomains | set | If your application relies on other hosts at other domains, add the associated domain names here. Once configured, Dynatrace will consider 404s thrown by hosts at these domains to be service failures related to your application. | required |
exceptionRules object| Property | Type | Description | Required |
|---|---|---|---|
Ignore all exceptionsignoreAllExceptions | boolean | - | required |
Success forcing exceptionssuccessForcingExceptions | Set<exception> | Define exceptions which indicate that an entire service call should not be considered as failed. E.g. an exception indicating that the client aborted the operation. If an exception matching any of the defined patterns occurs on the entry node of the service, it will be considered successful. Compared to ignored exceptions, the request will be considered successful even if other exceptions occur in the same request. | required |
Ignored exceptionsignoredExceptions | Set<exception> | Some exceptions that are thrown by legacy or 3rd-party code indicate a specific response, not an error. Use this setting to instruct Dynatrace to treat such exceptions as non-failed requests. If an exception matching any of the defined patterns occurs on the entry node of the service, it will not be considered as a failure. Other exceptions occurring at the same request might still mark the request as failed. | required |
Custom handled exceptionscustomHandledExceptions | Set<exception> | There may be situations where your application code handles exceptions gracefully in a manner that these failures aren't detected by Dynatrace. Use this setting to define specific gracefully-handled exceptions that should be treated as service failures. | required |
Custom error rulescustomErrorRules | Set<customErrorRule> | Some custom error situations are only detectable via a return value or other means. To support such cases, define a request attribute that captures the required data. Then define a custom error rule that determines if the request has failed based on the value of the request attribute. | required |
Ignore span failure detectionignoreSpanFailureDetection | boolean | - | required |
exception object| Property | Type | Description | Required |
|---|---|---|---|
Class patternclassPattern | text | The pattern will match if it is contained within the actual class name. | optional |
Exception message patternmessagePattern | text | Optionally, define an exception message pattern. The pattern will match if the actual exception message contains the pattern. | optional |
customErrorRule object| Property | Type | Description | Required |
|---|---|---|---|
Request attributerequestAttribute | text | - | required |
Request attribute conditioncondition | compareOperation | - | required |
compareOperation object| Property | Type | Description | Required |
|---|---|---|---|
Apply this comparisoncompareOperationType | text | - | required |
ValuetextValue | text | - | required |
Case sensitivecaseSensitive | boolean | - | required |
ValueintValue | integer | - | required |
ValuedoubleValue | float | - | required |