Gets a list of all all on-demand executions of synthetic monitors.
The request produces an application/json
payload.
GET | SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/synthetic/executions |
Environment ActiveGateCluster ActiveGate | https://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/synthetic/executions |
To execute this request, you need an access token with one of the following scopes:
syntheticExecutions.read
ExternalSyntheticIntegration
ReadSyntheticData
To learn how to obtain and use it, see Tokens and authentication.
Filters the resulting set of executions by their stage.
TRIGGERED
EXECUTED
DATA_RETRIEVED
The start of the requested timeframe for scheduling timestamps.
You can use one of the following formats:
2021-01-25T05:57:01.123+01:00
. If no time zone is specified, UTC is used. You can use a space character instead of the T
. Seconds and fractions of a second are optional.now-NU/A
, where N
is the amount of time, U
is the unit of time, and A
is an alignment. The alignment rounds all the smaller values to the nearest zero in the past. For example, now-1y/w
is one year back, aligned by a week.
You can also specify relative timeframe without an alignment: now-NU
.
Supported time units for the relative timeframe are:
m
: minutesh
: hoursd
: daysw
: weeksM
: monthsy
: yearsIf not set, the maximum relative timeframe of six hours is used (now-6h
).
The end of the requested timeframe for scheduling timestamps.
You can use one of the following formats:
2021-01-25T05:57:01.123+01:00
. If no time zone is specified, UTC is used. You can use a space character instead of the T
. Seconds and fractions of a second are optional.now-NU/A
, where N
is the amount of time, U
is the unit of time, and A
is an alignment. The alignment rounds all the smaller values to the nearest zero in the past. For example, now-1y/w
is one year back, aligned by a week.
You can also specify relative timeframe without an alignment: now-NU
.
Supported time units for the relative timeframe are:
m
: minutesh
: hoursd
: daysw
: weeksM
: monthsy
: yearsIf not set, the current timestamp is used.
The start of the requested timeframe for execution timestamps.
You can use one of the following formats:
2021-01-25T05:57:01.123+01:00
. If no time zone is specified, UTC is used. You can use a space character instead of the T
. Seconds and fractions of a second are optional.now-NU/A
, where N
is the amount of time, U
is the unit of time, and A
is an alignment. The alignment rounds all the smaller values to the nearest zero in the past. For example, now-1y/w
is one year back, aligned by a week.
You can also specify relative timeframe without an alignment: now-NU
.
Supported time units for the relative timeframe are:
m
: minutesh
: hoursd
: daysw
: weeksM
: monthsy
: yearsIf not set, the maximum relative timeframe of six hours is used (now-6h
).
The end of the requested timeframe for execution timestamps.
You can use one of the following formats:
2021-01-25T05:57:01.123+01:00
. If no time zone is specified, UTC is used. You can use a space character instead of the T
. Seconds and fractions of a second are optional.now-NU/A
, where N
is the amount of time, U
is the unit of time, and A
is an alignment. The alignment rounds all the smaller values to the nearest zero in the past. For example, now-1y/w
is one year back, aligned by a week.
You can also specify relative timeframe without an alignment: now-NU
.
Supported time units for the relative timeframe are:
m
: minutesh
: hoursd
: daysw
: weeksM
: monthsy
: yearsIf not set, the current timestamp is used.
The start of the requested timeframe for data delivering timestamps.
You can use one of the following formats:
2021-01-25T05:57:01.123+01:00
. If no time zone is specified, UTC is used. You can use a space character instead of the T
. Seconds and fractions of a second are optional.now-NU/A
, where N
is the amount of time, U
is the unit of time, and A
is an alignment. The alignment rounds all the smaller values to the nearest zero in the past. For example, now-1y/w
is one year back, aligned by a week.
You can also specify relative timeframe without an alignment: now-NU
.
Supported time units for the relative timeframe are:
m
: minutesh
: hoursd
: daysw
: weeksM
: monthsy
: yearsIf not set, the maximum relative timeframe of six hours is used (now-6h
).
SyntheticOnDemandExecutions
objectContains a list of synthetic on-demand executions.
SyntheticOnDemandExecution
objectDescribes the status of an on-demand execution.
The identifier of the batch.
The timestamp when whole data set has been collected on server, in UTC milliseconds.
The identifier of the execution.
Execution stage.
DATA_RETRIEVED
EXECUTED
NOT_TRIGGERED
TIMED_OUT
TRIGGERED
WAITING
The timestamp when execution was finished, in UTC milliseconds.
ObjectNode
objectCustomized script properties for this on-demand batch execution.
ExecutionFullResults
objectContains extended monitor's execution details.
Error code.
Number executed steps.
Failed step name.
Failed step sequence id.
Failure message.
ExecutionStep
objectContains detailed information about the monitor's step execution.
Defines the actual set of fields depending on the value. See one of the following objects:
BROWSER
-> BMActionHTTP
-> MonitorRequestExecutionResultBROWSER
HTTP
ExecutionSimpleResults
objectContains basic results of the monitor's on-demand execution.
Informs whether is Chrome error.
Synthetic engine id on which monitor was executed.
Error code.
Number of the executed steps by Synthetic engine
Failure message.
A hostname resolution time measured in milliseconds.
{"executions": [{"executionId": "7002396514015719218","executionStage": "EXECUTED","executionTimestamp": "1629891695487","locationId": "SYNTHETIC_LOCATION-9BB04DAEBA71B8CA","monitorId": "HTTP_CHECK-6349B98E1CD87352","schedulingTimestamp": "1629891686877","userId": "someUserIdentifier"}]}