• 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.

GETManagedDynatrace for Governmenthttps://{your-domain}/e/{your-environment-id}/api/v2/synthetic/executions/{executionId}
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/synthetic/executions/{executionId}
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/synthetic/executions/{executionId}

Authentication

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.

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
  • NOT_TRIGGERED
  • TIMED_OUT
  • TRIGGERED
  • WAITING
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.

nextExecutionIdinteger

Next execution id for sequential mode.

userIdstring

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

metadataobject

Metadata map for the execution batch.

sourcestring

The source of the triggering request.

The element can hold these values
  • API
  • UI
processingModestring

The processing mode of the execution.

The element can hold these values
  • DISABLE_PROBLEM_DETECTION
  • EXECUTIONS_DETAILS_ONLY
  • NONE
  • STANDARD
  • UNKNOWN
customizedScriptObjectNode

Customized script properties for this on-demand batch execution.

simpleResultsExecutionSimpleResults

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

fullResultsExecutionFullResults

Contains extended monitor's execution details.

The ObjectNode object

Customized script properties for this on-demand batch execution.

The object doesn't provide any parameters.

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.

chromeErrorboolean

Informs whether is Chrome 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

DEPRECATED

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.

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", "metadata": { "key": "value", "version": "1.255.20221022" }, "userId": "someUserIdentifier", "simpleResults": [ { "startTimestamp": "1629891693487", "engineId": "1993198092", "executedSteps": "1", "totalTime": "955", "publicLocation": "false", "tlsHandshakeTime": "167", "tcpConnectTime": "127", "hostNameResolutionTime": "50", "redirectionTime": "576", "responseBodySizeLimitExceeded": "false", "responseStatusCode": "200", "healthStatus": "HEALTHY", "responseSize": "1530652" } ], "source": "API", "processingMode": "STANDARD", "customizedScript": { "requests": [ { "url": "https://www.somepage.org", "preProcessingScript": "if (response.getResponseBody().includes(\"error\")) {api.fail(\"HTTP failing monitor.\");}" }, { "sequenceId": "3", "validation": { "rules": [ { "value": "=201", "passIfFound": "true" } ] } } ] } }
Related topics
  • Synthetic Monitoring

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