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.
GET | ManagedDynatrace for Government | 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 and Cluster ActiveGate (default port 9999) | https://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/synthetic/execution/{monitorId}/{resultType} |
Authentication
To execute this request, you need an access token with one of the following scopes:
DataExport
ExternalSyntheticIntegration
ReadSyntheticData
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 | Type | Description |
---|---|---|
200 | MonitorExecutionResults | Success. The response contains detailed data. |
Response body objects
The MonitorExecutionResults
object
Results of the execution of all HTTP monitor's requests.
Element | Type | Description |
---|---|---|
locationsExecutionResults | LocationExecutionResults[] | The list with the results of the requests executed on assigned locations. |
monitorId | string | Monitor id. |
The LocationExecutionResults
object
Results of the execution HTTP monitor's requests at a given location
Element | Type | Description |
---|---|---|
executionId | string | Execution id. |
locationId | string | Location 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.
The ExecutionStep
object
Contains detailed information about the monitor's step execution.
Element | Type | Description |
---|---|---|
monitorType | string | Defines the actual set of fields depending on the value. See one of the following objects:
|
The CustomLogLine
object
A custom script log line
Element | Type | Description |
---|---|---|
logLevel | string | Log level of the message |
message | string | The message |
timestamp | integer | A timestamp of this log message |
The MonitorRequestHeader
object
A header of the Http request
Element | Type | Description |
---|---|---|
name | string | Header's name. |
value | string | Header's value. |
Response body JSON model
1{2 "locationsExecutionResults": [3 {4 "executionId": "6136172183050046113",5 "locationId": "7804738439930364165",6 "requestResults": [7 {8 "engineId": 338502283,9 "errorCode": 0,10 "failureMessage": "",11 "hostNameResolutionTime": 26,12 "method": "GET",13 "peerCertificateDetails": "[Certificate details]",14 "peerCertificateExpiryDate": 1647302399000,15 "publicLocation": false,16 "redirectionTime": 70,17 "redirectsCount": 1,18 "requestBody": "",19 "requestHeaders": [20 {21 "name": "User-Agent",22 "value": "DynatraceSynthetic/1.215.1"23 },24 {25 "name": "X-Dynatrace-Visit",26 "value": "6136172183050046113"27 },28 {29 "name": "X-Dynatrace-Test",30 "value": "HTTP_CHECK-12B428F6D37A9197"31 }32 ],33 "requestId": "HTTP_CHECK_STEP-53071FC3C4F72E28",34 "requestName": "Request name",35 "resolvedIps": [36 "80.252.0.145"37 ],38 "responseBody": "<html><head>Title</head><body>Main Page</body></html>",39 "responseBodySizeLimitExceeded": false,40 "responseHeaders": [41 {42 "name": "Date",43 "value": "Mon, 15 Mar 2021 11:09:30 GMT"44 },45 {46 "name": "Content-Language",47 "value": "en"48 }49 ],50 "responseMessage": "OK",51 "responseSize": 1112,52 "responseStatusCode": 200,53 "sequenceNumber": 1,54 "startTimestamp": 1615806570884,55 "tcpConnectTime": 15,56 "timeToFirstByte": 96,57 "tlsHandshakeTime": 8,58 "totalTime": 238,59 "url": "https://www.examplePage.com",60 "waitingTime": 4761 }62 ]63 }64 ],65 "monitorId": "HTTP_CHECK-12B428F6D37A9197"66}