Synthetic monitors API - JSON models

Some JSON models of the Synthetic monitors API vary depending on the type of the model. The JSON models for each variation are listed below.

Variations of the SyntheticMonitor object

BROWSER

The BrowserSyntheticMonitor object

Browser synthetic monitor. Some fields are inherited from the base SyntheticMonitor model.

ElementTypeDescription
eventsEventDto[]

A list of events for this monitor

keyPerformanceMetricsKeyPerformanceMetrics

The key performance metrics configuration.

The EventDto object

ElementTypeDescription
entityIdstring

Event identifier

namestring

Event name

sequenceNumberinteger

Event sequence number

The KeyPerformanceMetrics object

The key performance metrics configuration.

ElementTypeDescription
loadActionKpmstring

Defines the key performance metric for load actions.

  • VISUALLY_COMPLETE
  • SPEED_INDEX
  • USER_ACTION_DURATION
  • TIME_TO_FIRST_BYTE
  • HTML_DOWNLOADED
  • DOM_INTERACTIVE
  • LOAD_EVENT_START
  • LOAD_EVENT_END
xhrActionKpmstring

Defines the key performance metric for XHR actions.

  • VISUALLY_COMPLETE
  • USER_ACTION_DURATION
  • TIME_TO_FIRST_BYTE
  • RESPONSE_END

HTTP

The HttpSyntheticMonitor object

HTTP synthetic monitor. Some fields are inherited from base SyntheticMonitor model.

ElementTypeDescription
requestsRequestDto[]

A list of events for this monitor

The RequestDto object

ElementTypeDescription
entityIdstring

Request identifier

namestring

Request name

sequenceNumberinteger

Request sequence number

Variations of the SyntheticMonitorUpdate object

BROWSER

The BrowserSyntheticMonitorUpdate object

Browser synthetic monitor update. Some fields are inherited from base SyntheticMonitorUpdate model.

ElementTypeDescription
keyPerformanceMetricsKeyPerformanceMetrics

The key performance metrics configuration.

The KeyPerformanceMetrics object

The key performance metrics configuration.

ElementTypeDescription
loadActionKpmstring

Defines the key performance metric for load actions.

  • VISUALLY_COMPLETE
  • SPEED_INDEX
  • USER_ACTION_DURATION
  • TIME_TO_FIRST_BYTE
  • HTML_DOWNLOADED
  • DOM_INTERACTIVE
  • LOAD_EVENT_START
  • LOAD_EVENT_END
xhrActionKpmstring

Defines the key performance metric for XHR actions.

  • VISUALLY_COMPLETE
  • USER_ACTION_DURATION
  • TIME_TO_FIRST_BYTE
  • RESPONSE_END

HTTP

The HttpSyntheticMonitorUpdate object

HTTP synthetic monitor update. Some fields are inherited from base SyntheticMonitorUpdate model.

ElementTypeDescription
anomalyDetectionAnomalyDetection

The anomaly detection configuration.

enabledboolean

The monitor is enabled (true) or disabled (false).

frequencyMininteger

The frequency of the monitor, in minutes.

You can use one of the following values: 5, 10, 15, 30, and 60.

locationsstring[]

A list of locations from which the monitor is executed.

To specify a location, use its entity ID. For public locations use GEOLOCATION-9999453BE4BDB3CD form and SYNTHETIC_LOCATION-DF80ACFB688C583B for private ones.

manuallyAssignedAppsstring[]

A set of manually assigned applications.

namestring

The name of the monitor.

scriptobject

The script of a browser or HTTP monitor.

tagsTagWithSourceInfo[]

A set of tags assigned to the monitor.

You can specify only the value of the tag here and the CONTEXTLESS context and source 'USER' will be added automatically. But preferred option is usage of TagWithSourceDto model.

typestring

Defines the actual set of fields depending on the value. See one of the following objects:

  • BROWSER -> BrowserSyntheticMonitorUpdate
  • HTTP -> HttpSyntheticMonitorUpdate
  • BROWSER
  • HTTP

The AnomalyDetection object

The anomaly detection configuration.

ElementTypeDescription
loadingTimeThresholdsLoadingTimeThresholdsPolicyDto

Performance thresholds configuration.

outageHandlingOutageHandlingPolicy

Outage handling configuration.

The LoadingTimeThresholdsPolicyDto object

Performance thresholds configuration.

ElementTypeDescription
enabledboolean

Performance threshold is enabled (true) or disabled (false).

thresholdsLoadingTimeThreshold[]

The list of performance threshold rules.

The LoadingTimeThreshold object

The performance threshold rule.

ElementTypeDescription
eventIndexinteger

Specify the event to which an ACTION threshold applies.

requestIndexinteger

Specify the request to which an ACTION threshold applies.

typestring

The type of the threshold: total loading time or action loading time.

  • ACTION
  • TOTAL
valueMsinteger

Notify if monitor takes longer than X milliseconds to load.

The OutageHandlingPolicy object

Outage handling configuration.

ElementTypeDescription
globalOutageboolean

When enabled (true), generate a problem and send an alert when the monitor is unavailable at all configured locations.

globalOutagePolicyGlobalOutagePolicy

Global outage handling configuration.

localOutageboolean

When enabled (true), generate a problem and send an alert when the monitor is unavailable for one or more consecutive runs at any location.

localOutagePolicyLocalOutagePolicy

Local outage handling configuration.

Alert if affectedLocations of locations are unable to access the web application consecutiveRuns times consecutively.

retryOnErrorboolean

Schedule retry if browser monitor execution results in a fail. For HTTP monitors this property is ignored.

The GlobalOutagePolicy object

Global outage handling configuration.

ElementTypeDescription
consecutiveRunsinteger

Alert if all locations are unable to access the web application X times consecutively.

The LocalOutagePolicy object

Local outage handling configuration.

Alert if affectedLocations of locations are unable to access the web application consecutiveRuns times consecutively.

ElementTypeDescription
affectedLocationsinteger

The number of affected locations to trigger an alert.

consecutiveRunsinteger

The number of consecutive fails to trigger an alert.

The TagWithSourceInfo object

Tag with source of a Dynatrace entity.

ElementTypeDescription
contextstring

The origin of the tag, such as AWS or Cloud Foundry.

Custom tags use the CONTEXTLESS value.

  • AWS
  • AWS_GENERIC
  • AZURE
  • CLOUD_FOUNDRY
  • CONTEXTLESS
  • ENVIRONMENT
  • GOOGLE_CLOUD
  • KUBERNETES
keystring

The key of the tag.

Custom tags have the tag value here.

sourcestring

The source of the tag, such as USER, RULE_BASED or AUTO

  • AUTO
  • RULE_BASED
  • USER
valuestring

The value of the tag.

Not applicable to custom tags.