Synthetic monitor executions API v2 - GET HTTP monitor

Gets the result of the most recent execution of the specified HTTP monitor.

The request produces an application/json payload.

Early Adopter

This request is an Early Adopter release and may be changed in non-compatible way.

GET
  • Managed https://{your-domain}/e/{your-environment-id}/api/v2/synthetic/execution/{monitorId}/{resultType}
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/v2/synthetic/execution/{monitorId}/{resultType}
  • Environment ActiveGate https://{your-activegate-domain}/e/{your-environment-id}/api/v2/synthetic/execution/{monitorId}/{resultType}

Authentication

To execute this request, you need the Access problem and event feed, metrics, and topology (DataExport) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Parameter Type Description In Required
monitorId string

Identifier of the HTTP monitor for which last execution result is returned.

path required
resultType string

Defines the result type of the last HTTP monitor's execution.

path required
locationId string

Filters the results to those executed by specified Synthetic location. Specify the ID of the location.

query optional

Response

Response codes

Code Description
200

Success. The response contains detailed data.

Response body

The MonitorExecutionResults object

Results of the execution of all HTTP monitor's requests.

Element Type Description
monitorId string

Monitor id.

locationsExecutionResults LocationExecutionResults[]

The list with the results of the requests executed on assigned locations.

The LocationExecutionResults object

Results of the execution HTTP monitor's requests at a given location

Element Type Description
locationId string

Location id.

executionId string

Execution id.

requestResults MonitorRequestExecutionResult[]

The list of the monitor's request results executed on this location.

The MonitorRequestExecutionResult object

A result of the execution HTTP monitor's request.

Element Type Description
requestId string

Request id.

requestName string

Request name.

sequenceNumber integer

Request's sequence number.

startTimestamp integer

Request start timestamp.

engineId integer

VUC's id on which monitor's request was executed.

publicLocation boolean

Flag informs whether request was executed on public location.

url string

Request URL address.

method string

Request method type.

requestBody string

Request's request body.

requestHeaders MonitorRequestHeader[]

A list of request's headers

responseStatusCode integer

Request's response status code.

responseBody string

Request's response body.

responseSize integer

Request's response size in bytes.

responseBodySizeLimitExceeded boolean

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

responseHeaders MonitorRequestHeader[]

A list of request's response headers

resolvedIps string[]

Request's resolved ips.'

healthStatusCode integer

Request's health status code.

healthStatus string

Request's health status.

responseMessage string

Request's response message.'

peerCertificateExpiryDate integer

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

peerCertificateDetails string

Request's certificate details.

totalTime integer

A total request time measured in ms.

hostNameResolutionTime integer

A hostname resolution time measured in ms.

tcpConnectTime integer

A TCP connect time measured in ms.

tlsHandshakeTime integer

A TLS handshake time measured in ms.

timeToFirstByte integer

A time to first byte measured in ms.

redirectionTime integer

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

waitingTime integer

Waiting time (time to first byte - (DNS lookup time + TCP connect time + TLS handshake time), measured in ms.

redirectsCount integer

Number of request's redirects.

failureMessage string

Request's failure message.

The MonitorRequestHeader object

A header of the Http request

Element Type Description
name string

Header's name.

value string

Header's value.