Request attributes API - GET a request attribute
Gets parameters of the specified request attribute.
The request produces an application/json
payload.
GET | ManagedDynatrace for Government | https://{your-domain}/e/{your-environment-id}/api/config/v1/service/requestAttributes/{id} |
SaaS | https://{your-environment-id}.live.dynatrace.com/api/config/v1/service/requestAttributes/{id} | |
Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/service/requestAttributes/{id} |
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 request attribute. | path | required |
includeProcessGroupReferences | boolean | Flag to include process group references to the response. Process Group group references aren't compatible across environments. | query | optional |
Response
Response codes
Code | Type | Description |
---|---|---|
200 | Request | Success |
Response body objects
The RequestAttribute
object
Element | Type | Description |
---|---|---|
aggregation | string | Aggregation type for the request values. |
confidential | boolean | Confidential data flag. Set |
dataSources | Data | The list of data sources. |
dataType | string | The data type of the request attribute. |
enabled | boolean | The request attribute is enabled ( |
id | string | The ID of the request attribute. |
metadata | Configuration | Metadata useful for debugging |
name | string | The name of the request attribute. |
normalization | string | String values transformation. If the dataType is not |
skipPersonalDataMasking | boolean | Personal data masking flag. Set Warning: This will potentially access personalized data. |
The DataSource
object
Element | Type | Description |
---|---|---|
capturingAndStorageLocation | string | Specifies the location where the values are captured and stored. Required if the source is one of the following: Not applicable in other cases. If the source value is |
cicsSDKMethodNodeCondition | Value | IBM integration bus label node name condition for which the value is captured. |
cicsTransactionCallType | string | CICS transaction call type condition for which the value is captured. Required if the source is: Not applicable in other cases. |
enabled | boolean | The data source is enabled ( |
iibLabelMethodNodeCondition | Value | IBM integration bus label node name condition for which the value is captured. |
iibMethodNodeCondition | Value | IBM integration bus label node name condition for which the value is captured. |
iibNodeType | string | The IBM integration bus node type for which the value is captured. This or Not applicable in other cases. |
imsTransactionCallType | string | IMS transaction call type condition for which the value is captured. Required if the source is: Not applicable in other cases. |
methods | Captured | The method specification if the source value is Not applicable in other cases. |
parameterName | string | The name of the web request parameter to capture. Required if the source is one of the following: Not applicable in other cases. |
scope | Scope | Conditions for data capturing. |
serverVariableTechnology | string | The technology of the server variable to capture if the source value is |
sessionAttributeTechnology | string | The technology of the session attribute to capture if the source value is |
source | string | The source of the attribute to capture. Works in conjunction with parameterName or methods and technology. |
spanAttributeKey | string | The key of the span attribute to capture. Required if the source is: Not applicable in other cases. |
technology | string | The technology of the method to capture if the source value is |
valueProcessing | Value | Process values as specified. |
The ValueCondition
object
IBM integration bus label node name condition for which the value is captured.
Element | Type | Description |
---|---|---|
negate | boolean | Negate the comparison. |
operator | string | Operator comparing the extracted value to the comparison value. |
value | string | The value to compare to. |
The CapturedMethod
object
Element | Type | Description |
---|---|---|
argumentIndex | integer | The index of the argument to capture. Set Required if the capture is set to Not applicable in other cases. |
capture | string | What to capture from the method. |
deepObjectAccess | string | The getter chain to apply to the captured object. It is required in one of the following cases: The capture is set to Not applicable in other cases. |
method | Method | Configuration of a method to be captured. |
The MethodReference
object
Configuration of a method to be captured.
Element | Type | Description |
---|---|---|
argumentTypes | string[] | The list of argument types. |
className | string | The class name where the method to capture resides. Either this or the fileName must be set. |
fileName | string | The file name where the method to capture resides. Either this or className must be set. |
fileNameMatcher | string | The operator of the comparison. If not set, |
methodName | string | The name of the method to capture. |
modifiers | string[] | The modifiers of the method to capture. |
returnType | string | The return type. |
visibility | string | The visibility of the method to capture. |
The ScopeConditions
object
Conditions for data capturing.
Element | Type | Description |
---|---|---|
hostGroup | string | Only applies to this host group. |
processGroup | string | Only applies to this process group. Note that this can't be transferred between different clusters or environments. |
serviceTechnology | string | Only applies to this service technology. |
tagOfProcessGroup | string | Only apply to process groups matching this tag. |
The ValueProcessing
object
Process values as specified.
Element | Type | Description |
---|---|---|
extractSubstring | Extract | Preprocess by extracting a substring from the original value. |
splitAt | string | Split (preprocessed) string values at this separator. |
trim | boolean | Prune Whitespaces. Defaults to false. |
valueCondition | Value | IBM integration bus label node name condition for which the value is captured. |
valueExtractorRegex | string | Extract value from captured data per regex. |
The ExtractSubstring
object
Preprocess by extracting a substring from the original value.
Element | Type | Description |
---|---|---|
delimiter | string | The delimiter string. |
endDelimiter | string | The end-delimiter string. Required if the position value is |
position | string | The position of the extracted string relative to delimiters. |
The ConfigurationMetadata
object
Metadata useful for debugging
Element | Type | Description |
---|---|---|
clusterVersion | string | Dynatrace version. |
configurationVersions | integer[] | A sorted list of the version numbers of the configuration. |
currentConfigurationVersions | string[] | A sorted list of version numbers of the configuration. |
Response body JSON model
{
"aggregation": "ALL_DISTINCT_VALUES",
"confidential": false,
"dataSources": [
{
"capturingAndStorageLocation": "CAPTURE_AND_STORE_ON_SERVER",
"enabled": true,
"parameterName": "query",
"scope": {
"tagOfProcessGroup": "SearchFrontend"
},
"source": "QUERY_PARAMETER"
}
],
"dataType": "STRING",
"enabled": true,
"name": "Query Term",
"normalization": "TO_LOWER_CASE",
"skipPersonalDataMasking": false
}