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:
DataExportExternalSyntheticIntegrationReadSyntheticData
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}