Settings API - Service detection rules for External Web Requests schema table

Service detection rules for External Web Requests (builtin:service-detection.external-web-request)

Rules are evaluated from top to bottom, and the first matching rule applies. Rule conditions are evaluated before Service Id Contributors are applied. Note that conditions do not modify attributes of requests. If conditions match, then Service Id Contributors are applied. All of the Contributors except for the port are always applied. You can exclude the port contribution by disabling the switch. You can enable the transformation of other Service Id Contributors values to manage which Services are created.
More extensive information on Service detection rules can be found here.

Schema ID
Schema groups
Scope
builtin:service-detection.external-web-request
  • group:service-detection
environment
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:service-detection.external-web-request
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:service-detection.external-web-request
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:service-detection.external-web-request

Authentication

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.

Parameters

Property
Type
Description
Required
Enabled
enabled
boolean
-
required
Rule name
name
text
-
required
Description
description
text
-
optional
Management zones
managementZones
set

Define a management zone of the process group for which this service detection rule should be created. Note: in case of external requests/services the PG might not always be known. See here

required
Service identifier contributors
idContributors

Contributors to the Service Identifier calculation. All of the Contributors except for the port are always applied. You can exclude the port contribution by disabling the switch.

required
Conditions
conditions

A list of conditions necessary for the rule to take effect. If multiple conditions are specified, they must all match a Request for the rule to apply. If there is no condition at all, the rule is always applied. Conditions are evaluated against attributes, but do not modify them.

required
The idContributorsType object
Property
Type
Description
Required
Application identifier
applicationId
-
required
URL context root
contextRoot
-
required
Public domain name
publicDomainName
-
required
Port
portForServiceId
boolean

Let the port contribute to the Service Id

required
The condition object
Property
Type
Description
Required
Take the value of this attribute
attribute
text
-
required
Apply this operation
compareOperationType
text
-
required
Values
textValues
set

If multiple values are specified, at least one of them must match for the condition to match

required
Values
tagValues
set

If multiple values are specified, at least one of them must match for the condition to match

required
Value
intValue
integer
-
required
Values
intValues
set
-
required
From
ipRangeFrom
text
-
required
To
ipRangeTo
text
-
required
Technology
framework
  • AXIS
  • CXF
  • HESSIAN
  • JAX_WS_RI
  • JBOSS
  • JERSEY
  • PROGRESS
  • RESTEASY
  • RESTLET
  • SPRING
  • TIBCO
  • WEBLOGIC
  • WEBMETHODS
  • WEBSPHERE
  • WINK
required
Ignore case
ignoreCase
boolean

Ignore case sensitivity for texts.

required
The serviceIdContributor object
Property
Type
Description
Required
Transform this value before letting it contribute to the Service Id
enableIdContributor
boolean
-
required
serviceIdContributor
-
required
The contextIdContributor object
Property
Type
Description
Required
Transform this value before letting it contribute to the Service Id
enableIdContributor
boolean
-
required
serviceIdContributor
-
required
The publicDomainIdContributor object
Property
Type
Description
Required
Transform this value before letting it contribute to the Service Id
enableIdContributor
boolean
-
required
serviceIdContributor
-
required
The transformationSet object
Property
Type
Description
Required
Contribution type
contributionType
enum

Defines whether the original value should be used or if a transformation set should be used to override a value or transform it.

  • OriginalValue
  • OverrideValue
  • TransformValue
required
Value override
valueOverride

The value to be used instead of the detected value.

required
Transformations
transformations

Choose how to transform a value before it contributes to the Service Id. Note that all of the Transformations are always applied. Transformations are applied in the order they are specified, and the output of the previous transformation is the input for the next one. The resulting value contributes to the Service Id and can be found on the Service overview page under Properties and tags.

required
The contextRoot object
Property
Type
Description
Required
Contribution type
contributionType
enum

Defines whether the original value should be used or if a transformation set should be used to override a value or transform it.

  • OriginalValue
  • OverrideValue
  • TransformValue
  • TransformURL
required
Value override
valueOverride

The value to be used instead of the detected value.

required
Segments to copy from URL path
segmentCount
integer

The number of segments of the URL to be kept. The URL is divided by slashes (/), the indexing starts with 1 at context root. For example, if you specify 2 for the www.dynatrace.com/support/help/dynatrace-api/ URL, the value of support/help is used.

required
Transformations
transformations

Choose how to transform a value before it contributes to the Service Id. Note that all of the Transformations are always applied. Transformations are applied in the order they are specified, and the output of the previous transformation is the input for the next one. The resulting value contributes to the Service Id and can be found on the Service overview page under Properties and tags.

required
The publicDomainTransformationSet object
Property
Type
Description
Required
Contribution type
contributionType
enum

Defines whether the original value should be used or if a transformation set should be used to override a value or transform it.

  • OriginalValue
  • OverrideValue
  • TransformValue
required
Value override
valueOverride

The value to be used instead of the detected value.

required
Copy from host name
copyFromHostName
boolean

Use the detected host name instead of the request's domain name.

required
Transformations
transformations

Choose how to transform a value before it contributes to the Service Id. Note that all of the Transformations are always applied. Transformations are applied in the order they are specified, and the output of the previous transformation is the input for the next one. The resulting value contributes to the Service Id and can be found on the Service overview page under Properties and tags.

required
The valueOverride object
Property
Type
Description
Required
Value
value
text
-
required
The transformation object
Property
Type
Description
Required
Transformation type
transformationType
enum

Defines what kind of transformation will be applied on the original value.

  • BEFORE
  • AFTER
  • BETWEEN
  • REPLACE_BETWEEN
  • REMOVE_NUMBERS
  • REMOVE_CREDIT_CARDS
  • REMOVE_IBANS
  • REMOVE_IPS
  • SPLIT_SELECT
  • TAKE_SEGMENTS
required
prefix
prefix
text
-
optional
suffix
suffix
text
-
optional
replacement
replacementValue
text
-
optional
split by
splitDelimiter
text
-
optional
select index
selectIndex
integer
-
required
min digit count
minDigitCount
integer
-
required
include hexadecimal numbers
includeHexNumbers
boolean
-
required
segment count
segmentCount
integer

How many segments should be taken.

required
take from end
takeFromEnd
boolean
-
required
The reducedTransformation object
Property
Type
Description
Required
Transformation Type
transformationType
enum

Defines what kind of transformation will be applied on the original value.

  • BEFORE
  • REPLACE_BETWEEN
  • REMOVE_NUMBERS
  • REMOVE_CREDIT_CARDS
  • REMOVE_IBANS
  • REMOVE_IPS
required
prefix
prefix
text
-
optional
suffix
suffix
text
-
optional
replacement
replacementValue
text
-
optional
min digit count
minDigitCount
integer
-
required
include hexadecimal numbers
includeHexNumbers
boolean
-
required