Web application metrics API - GET a metric

Gets the descriptor of the specified calculated web application metric.

The request produces an application/json payload.

GET	Managed	`https://{your-domain}/e/{your-environment-id}/api/config/v1/calculatedMetrics/rum/{metricKey}`
	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/config/v1/calculatedMetrics/rum/{metricKey}`
	Environment ActiveGate	`https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/calculatedMetrics/rum/{metricKey}`

Authentication

To execute this request, you need an access token with Read configuration (ReadConfig) scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Parameter	Type	Description	In	Required
metricKey	string	The key of the required metric.	path	required

Response

Response codes

Code	Type	Description
200	WebApplicationMetric	Success

Response body objects

The `WebApplicationMetric` object

Descriptor of the calculated web application metric.

Element	Type	Description
applicationIdentifier	string	The Dynatrace entity ID of the application to which the metric belongs.
name	string	The displayed name of the metric.
metricKey	string	The unique key of the metric. The key must have the `calc:apps` prefix.
enabled	boolean	The metric is enabled (`true`) or disabled (`false`).
metricDefinition	WebApplicationMetricDefinition	Definition of the web application metric.
dimensions	WebApplicationDimensionDefinition[]	A list of metric dimensions. Can be `null`.
userActionFilter	UserActionFilter	User actions filter of the calculated web application metric. Only user actions matching the provided criteria are used for metric calculation. A user action must match all the criteria. Can be `null`.

The `WebApplicationMetricDefinition` object

Definition of the web application metric.

Element Type Description

metric

string

Element	Type	Description
metric	string	The type of the web application metric. The element can hold these values `Apdex` `ApplicationCache` `Callback` `CumulativeLayoutShift` `DNSLookup` `DOMComplete` `DOMContentLoaded` `DOMInteractive` `DoubleProperty` `ErrorCount` `FirstContentfulPaint` `FirstInputDelay` `FirstInputStart` `FirstPaint` `HTMLDownloaded` `LargestContentfulPaint` `LoadEventEnd` `LoadEventStart` `LongProperty` `LongTasksTime` `NavigationStart` `OnDOMContentLoaded` `OnLoad` `Processing` `RedirectTime` `Request` `RequestStart` `Response` `SecureConnect` `SpeedIndex` `TCPConnect` `TimeToFirstByte` `UserActionDuration` `VisuallyComplete`
propertyKey	string	The key of the user action property. Only applicable for `DoubleProperty` and `LongProperty` metrics. Can be `null`.

The type of the web application metric.

The element can hold these values

Apdex
ApplicationCache
Callback
CumulativeLayoutShift
DNSLookup
DOMComplete
DOMContentLoaded
DOMInteractive
DoubleProperty
ErrorCount
FirstContentfulPaint
FirstInputDelay
FirstInputStart
FirstPaint
HTMLDownloaded
LargestContentfulPaint
LoadEventEnd
LoadEventStart
LongProperty
LongTasksTime
NavigationStart
OnDOMContentLoaded
OnLoad
Processing
RedirectTime
Request
RequestStart
Response
SecureConnect
SpeedIndex
TCPConnect
TimeToFirstByte
UserActionDuration
VisuallyComplete

propertyKey

string

The key of the user action property.

Only applicable for DoubleProperty and LongProperty metrics.

Can be null.

The `WebApplicationDimensionDefinition` object

Dimension of the calculated web application metrics.

Element Type Description

topX

integer

Element	Type	Description
topX	integer	The number of top values to be calculated.
dimension	string	The dimension of the metric. The element can hold these values `ApdexType` `Browser` `ErrorContext` `ErrorOrigin` `ErrorType` `GeoLocation` `StringProperty` `UserActionType`
propertyKey	string	The key of the user action property. Only applicable for the `StringProperty` dimension. Can be `null`.

The number of top values to be calculated.

dimension

string

The dimension of the metric.

The element can hold these values

ApdexType
Browser
ErrorContext
ErrorOrigin
ErrorType
GeoLocation
StringProperty
UserActionType

propertyKey

string

The key of the user action property.

Only applicable for the StringProperty dimension.

Can be null.

The `UserActionFilter` object

User actions filter of the calculated web application metric.

Only user actions matching the provided criteria are used for metric calculation.

A user action must match all the criteria.

Element	Type	Description
actionDurationFromMilliseconds	integer	Only actions with a duration more than or equal to this value (in milliseconds) are included in the metric calculation. Can be `null`.
actionDurationToMilliseconds	integer	Only actions with a duration less than or equal to this value (in milliseconds) are included in the metric calculation. Can be `null`.
loadAction	boolean	The status of load actions in the metric calculation: `true`: Load actions are included. `false`: All actions are included. Can be `null`.
xhrAction	boolean	The status of XHR actions in the metric calculation: `true`: XHR actions are included. `false`: All actions are included. Can be `null`.
xhrRouteChangeAction	boolean	The status of route change actions in the metric calculation: `true`: Route change actions are included. `false`: All actions are included. Can be `null`.
customAction	boolean	The status of custom actions in the metric calculation: `true`: Custom actions are included. `false`: All actions are included. Can be `null`.
apdex	string	Only actions with the specified Apdex score are included in the metric calculation. The element can hold these values `Frustrated` `Satisfied` `Tolerating` `Unknown` Can be `null`.
domain	string	Only user actions coming from the specified domain are included in the metric calculation. The EQUALS operator applies. Can be `null`.
userActionName	string	Only actions with this name are included in the metric calculation. The EQUALS operator applies. Can be `null`.
realUser	boolean	The status of actions coming from real users in the metric calculation: `true`: Only actions from real users are included. `false`: All actions are included. Can be `null`.
robot	boolean	The status of actions coming from robots in the metric calculation: `true`: Only actions from robots are included. `false`: All actions are included. Can be `null`.
synthetic	boolean	The status of actions coming from synthetic monitors in the metric calculation: `true`: Only actions from synthetic monitors are included. `false`: All actions are included. Can be `null`.
browserFamily	string	Only user actions coming from the specified browser family are included in the metric calculation. The EQUALS operator applies. Can be `null`.
browserType	string	Only user actions coming from the specified browser type are included in the metric calculation. The EQUALS operator applies. Can be `null`.
browserVersion	string	Only user actions coming from the specified browser version are included in the metric calculation. The EQUALS operator applies. Can be `null`.
hasCustomErrors	boolean	The custom error status of the actions to be included in the metric calculation: `true`: Only actions with custom errors are included. `false`: All actions are included. Can be `null`.
hasAnyError	boolean	The error status of the actions to be included in the metric calculation: `true`: Only actions that have any errors are included. `false`: All actions are included. Can be `null`.
hasHttpErrors	boolean	The request error status of the actions to be included in the metric calculation: `true`: Only actions with request errors (HTTP errors, failed images, CSP rule violations) are included. `false`: All actions are included. Can be `null`.
hasJavascriptErrors	boolean	The JavaScript error status of the actions to be included in the metric calculation: `true`: Only actions with JavaScript errors are included. `false`: All actions are included. Can be `null`.
city	string	Only actions of users from this city are included in the metric calculation. Specify geolocation ID here. Can be `null`.
continent	string	Only actions of users from this continent are included in the metric calculation. Specify geolocation ID here. Can be `null`.
country	string	Only actions of users from this country are included in the metric calculation. Specify geolocation ID here. Can be `null`.
region	string	Only actions of users from this region are included in the metric calculation. Specify geolocation ID here. Can be `null`.
ip	string	Only actions coming from this IP address are included in the metric calculation. The EQUALS operator applies. Can be `null`.
ipV6Traffic	boolean	The IPv6 status of the actions to be included in the metric calculation: `true`: Only actions coming from IPv6 are included. `false`: All actions are included. Can be `null`.
osFamily	string	Only actions coming from this OS family are included in the metric calculation. Specify the OS ID here. Can be `null`.
osVersion	string	Only actions coming from this OS version are included in the metric calculation. Specify the OS ID here. Can be `null`.
httpErrorCode	integer	The HTTP error status code of the actions to be included in the metric calculation. Can be `null`.
httpErrorCodeTo	integer	Can be used in combination with `httpErrorCode` to define a range of error codes that will be included in the metric calculation. Can be `null`.
httpPath	string	The request path that has been determined to be the origin of an HTTP error of the actions to be included in the metric calculation. Can be `null`.
customErrorType	string	The custom error type of the actions to be included in the metric calculation. Can be `null`.
customErrorName	string	The custom error name of the actions to be included in the metric calculation. Can be `null`.
userActionProperties	UserActionPropertyFilter[]	Only actions with the specified properties are included in the metric calculation. Can be `null`.
targetViewName	string	Only actions on the specified view are included in the metric calculation. Can be `null`.
targetViewNameMatchType	string	Specifies the match type of the view name filter, e.g. using `Contains` or `Equals`. Defaults to `Equals`. The element can hold these values `Contains` `Equals` Can be `null`.
targetViewGroup	string	Only actions on the specified group of views are included in the metric calculation. Can be `null`.
targetViewGroupNameMatchType	string	Specifies the match type of the view group filter, e.g. using `Contains` or `Equals`. Defaults to `Equals`. The element can hold these values `Contains` `Equals` Can be `null`.

The `UserActionPropertyFilter` object

User action property filter.

Element	Type	Description
key	string	The key of the action property we're checking. Can be `null`.
value	string	Only actions that have this value in the specified property are included in the metric calculation. Only applicable to string values. Can be `null`.
from	number	Only actions that have a value greater than or equal to this are included in the metric calculation. Only applicable to numerical values. Can be `null`.
to	number	Only actions that have a value less than or equal to this are included in the metric calculation. Only applicable to numerical values. Can be `null`.
matchType	string	Specifies the match type of a string filter, e.g. using `Contains` or `Equals`. Only applicable to string values. The element can hold these values `Contains` `Equals` Can be `null`.

Response body JSON model

json
{
  "enabled": true,
  "name": "MyMetric",
  "metricKey": "calc:apps.web.mymetric",
  "metricDefinition": {
    "metric": "UserActionDuration"
  },
  "applicationIdentifier": "APPLICATION-1234",
  "userActionFilter": {
    "loadAction": true,
    "country": "GEOLOCATION-1234",
    "browserType": "BROWSER-1234"
  },
  "dimensions": [
    {
      "dimension": "GeoLocation",
      "topX": 20
    }
  ]
}

Web application metrics API - GET a metric

Authentication

Parameters

Response

Response codes

Response body objects

The WebApplicationMetric object

The WebApplicationMetricDefinition object

The WebApplicationDimensionDefinition object

The UserActionFilter object

The UserActionPropertyFilter object

Response body JSON model

The `WebApplicationMetric` object

The `WebApplicationMetricDefinition` object

The `WebApplicationDimensionDefinition` object

The `UserActionFilter` object

The `UserActionPropertyFilter` object