• Home
  • Dynatrace API
  • Environment
  • Synthetic v2
  • Monitor executions
  • GET basic info of an execution

Synthetic monitor executions API v2 - GET basic info of an execution

Gets basic results of an on-demand execution of a synthetic monitor.

The request produces an application/json payload.

GETManaged https://{your-domain}/e/{your-environment-id}/api/v2/synthetic/executions/{executionId}
SaaS https://{your-environment-id}.live.dynatrace.com/api/v2/synthetic/executions/{executionId}
Environment ActiveGate https://{your-activegate-domain}/e/{your-environment-id}/api/v2/synthetic/executions/{executionId}

Authentication

To execute this request, you need an access token with Read synthetic monitor execution results (syntheticExecutions.read) scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

ParameterTypeDescriptionInRequired
executionIdinteger

The identifier of the on-demand execution.

pathrequired

Response

Response codes

CodeTypeDescription
200SyntheticOnDemandExecution

Success. The response contains basic information about the on-demand execution.

Response body objects

The SyntheticOnDemandExecution object

Describes the status of an on-demand execution.

ElementTypeDescription
batchIdstring

The identifier of the batch.

executionIdstring

The identifier of the execution.

executionStagestring

Execution stage.

The element can hold these values
  • DATA_RETRIEVED
  • EXECUTED
  • TIMED_OUT
  • TRIGGERED
schedulingTimestampinteger

The scheduling timestamp, in UTC milliseconds.

executionTimestampinteger

The timestamp when execution was finished, in UTC milliseconds.

dataDeliveryTimestampinteger

The timestamp when whole data set has been collected on server, in UTC milliseconds.

monitorIdstring

The identifier of the monitor.

locationIdstring

The identifier of the location from where the monitor is to be executed.

userIdstring

The name of the user who triggered the on-demand execution.

simpleResultsExecutionSimpleResults

Contains basic results of the monitor's on-demand execution.

fullResultsExecutionFullResults

Contains extended monitor's execution details.

The ExecutionSimpleResults object

Contains basic results of the monitor's on-demand execution.

ElementTypeDescription
statusstring

Execution status.

failureMessagestring

Failure message.

errorCodestring

Error code.

responseStatusCodeinteger

Response status code.

executedStepsinteger

Number of the executed steps by Synthetic engine

engineIdinteger

Synthetic engine id on which monitor was executed.

httperrorboolean

Informs whether is HTTP error.

publicLocationboolean

Flag informs whether request was executed on public location.

responseSizeinteger

Request's response size in bytes.

responseBodySizeLimitExceededboolean

A flag indicating that the response payload size limit of 10MB has been exceeded.

peerCertificateExpiryDateinteger

An expiry date of the first SSL certificate from the certificate chain.

totalTimeinteger

A total time measured in milliseconds.

hostNameResolutionTimeinteger

A hostname resolution time measured in milliseconds.

tcpConnectTimeinteger

A TCP connect time measured in milliseconds.

tlsHandshakeTimeinteger

A TLS handshake time measured in milliseconds.

timeToFirstByteinteger

A time to first byte measured in milliseconds.

redirectionTimeinteger

Total number of milliseconds spent on handling all redirect requests, measured in milliseconds.

redirectsCountinteger

Number of redirects.

startTimestampinteger

Start timestamp.

chromeErrorboolean

Informs whether is Chrome error.

The ExecutionFullResults object

Contains extended monitor's execution details.

ElementTypeDescription
statusstring

Execution status.

failureMessagestring

Failure message.

errorCodestring

Error code.

executionStepCountinteger

Number executed steps.

executionStepsExecutionStep[]

Details about the monitor's step execution.

The ExecutionStep object

Contains detailed information about the monitor's step execution.

ElementTypeDescription
monitorTypestring

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

  • BROWSER -> BMAction
  • HTTP -> MonitorRequestExecutionResult
The element can hold these values
  • BROWSER
  • HTTP

Response body JSON model

json
{ "batchId": "22396514015719218", "executionId": "7002396514015719218", "executionStage": "DATA_RETRIEVED", "schedulingTime": "1629891686877", "executionTimestamp": "1629891695487", "dataDeliveryTimestamp": "1629891701171", "monitorId": "HTTP_CHECK-6349B98E1CD87352", "locationId": "SYNTHETIC_LOCATION-9BB04DAEBA71B8CA", "userId": "someUserIdentifier", "simpleResults": [ { "startTimestamp": "1629891693487", "engineId": "1993198092", "executedSteps": "1", "totalTime": "955", "publicLocation": "false", "tlsHandshakeTime": "167", "tcpConnectTime": "127", "hostNameResolutionTime": "50", "redirectionTime": "576", "responseBodySizeLimitExceeded": "false", "peerCertificateExpiryDate": "0", "responseStatusCode": "200", "healthStatus": "HEALTHY", "responseSize": "1530652" } ] }
Related topics
  • Synthetic Monitoring

    Learn about Synthetic Monitoring and how to create a single-URL browser monitor, a browser clickpath, or an HTTP monitor.