Synthetic monitors API - POST a monitor
Creates a new synthetic monitor.
The configuration of the new monitor is passed via its JSON script.
This request is an early adopter release and may be changed in non compatible way.
POST |
|
Parameters
Refer to JSON models to find all JSON models that depend on the type of the model.
Parameter | Type | Description | In | Required |
---|---|---|---|---|
body | SyntheticMonitorUpdate |
The JSON body of the request, containing parameters of the new synthetic monitor. |
body | optional |
The SyntheticMonitorUpdate object
The synthetic monitor update. This is a base object, the exact type depends on the value of the type
field.
Element | Type | Description | Required |
---|---|---|---|
frequencyMin | integer |
The frequency of the monitor, in minutes. You can use one of the following values: |
required |
anomalyDetection | AnomalyDetection |
The anomaly detection configuration. |
optional |
type | string |
Defines the actual set of fields depending on the value: BROWSER -> BrowserSyntheticMonitorUpdate HTTP -> HttpSyntheticMonitorUpdate The type element can hold these values. |
required |
name | string |
The name of the monitor. |
required |
locations | string[] |
A list of locations from which the monitor is executed. To specify a location, use its entity ID. |
required |
enabled | boolean |
The monitor is enabled ( |
required |
script | object |
The script of a browser or HTTP monitor. |
required |
tags | string[] |
A set of tags assigned to the monitor. Only specify the value of the tag here. The |
required |
manuallyAssignedApps | string[] |
A set of manually assigned applications. |
required |
The AnomalyDetection object
The anomaly detection configuration.
Element | Type | Description | Required |
---|---|---|---|
outageHandling | OutageHandlingPolicy |
Outage handling configuration. |
required |
loadingTimeThresholds | LoadingTimeThresholdsPolicyDto |
Performance thresholds configuration. |
required |
The LoadingTimeThresholdsPolicyDto object
Performance thresholds configuration.
Element | Type | Description | Required |
---|---|---|---|
enabled | boolean |
Performance threshold is enabled ( |
required |
thresholds | LoadingTimeThreshold[] |
The list of performance threshold rules. |
required |
The LoadingTimeThreshold object
The performance threshold rule.
Element | Type | Description | Required |
---|---|---|---|
type | string |
The type of the threshold: total loading time or action loading time. The type element can hold these values. |
required |
valueMs | integer |
Notify if monitor takes longer than X milliseconds to load. |
required |
requestIndex | integer |
Specify the request to which an ACTION threshold applies. |
optional |
The OutageHandlingPolicy object
Outage handling configuration.
Element | Type | Description | Required |
---|---|---|---|
globalOutage | boolean |
When enabled ( |
required |
localOutage | boolean |
When enabled ( |
required |
localOutagePolicy | LocalOutagePolicy |
Local outage handling configuration. |
required |
The LocalOutagePolicy object
Local outage handling configuration.
Alert if affectedLocations of locations are unable to access the web application consecutiveRuns times consecutively.
Element | Type | Description | Required |
---|---|---|---|
affectedLocations | integer |
The number of affected locations to trigger an alert. |
required |
consecutiveRuns | integer |
The number of consecutive fails to trigger an alert. |
required |
This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request. See the Example expandable section for working sample request.
{
"frequencyMin": 5,
"anomalyDetection": {
"outageHandling": {
"globalOutage": true,
"localOutage": true,
"localOutagePolicy": {
"affectedLocations": 1,
"consecutiveRuns": 3
}
},
"loadingTimeThresholds": {
"enabled": true,
"thresholds": [
{
"type": "TOTAL",
"valueMs": 100,
"requestIndex": 1
}
]
},
"_inheritance": "SyntheticMonitorUpdate"
},
"type": "BROWSER",
"name": "Browser Monitor Example",
"locations": [
"GEOLOCATION-9999453BE4BDB3CD"
],
"enabled": true,
"script": {
"type": "availability",
"version": "1.0",
"configuration": {
"device": {
"deviceName": "Desktop",
"orientation": "landscape"
}
},
"events": [
{
"type": "navigate",
"description": "Loading of "example.com"\n",
"url": "http://example.com",
"wait": {
"waitFor": "page_complete"
}
}
],
"_inheritance": "SyntheticMonitorUpdate"
},
"keyPerformanceMetrics": {
"loadActionKpm": "VISUALLY_COMPLETE",
"xhrActionKpm": "VISUALLY_COMPLETE",
"_inheritance": "SyntheticMonitorUpdate"
},
"tags": [
"example"
],
"manuallyAssignedApps": [
"APPLICATION-4ADF0EF407C7C545"
],
"events": []
}
Possible values
Possible values for the type element in the SyntheticMonitorUpdate object:
- BROWSER
- HTTP
Possible values for the type element in the LoadingTimeThreshold object:
- ACTION
- TOTAL
Response format
The EntityIdDto object
A DTO for entity ID.
Element | Type | Description |
---|---|---|
entityId | string | Entity ID to be transferred |
{
"entityId": "string"
}
Example
In this example, the request creates a simple browser monitor that navigates to dexp.ae.
The monitor is executed every 10 minutes from one location, which has the ID of GEOLOCATION-0A41430434C388A9. A problem will be raised if the website is unavailable for three consecutive runs. A notification is sent if the website takes longer than 500 milliseconds to load.
The API token is passed in the Authorization header.
The response contains the entity ID of the newly created monitor.
Since the request body is lengthy, it is truncated in this example Curl section. See the full body in the Request body section. You can download or copy the example request body to try it out on your own. Before using it, make sure that the location from the example is available in your environment. You can fetch the list of available locations with the GET all synthetic locations call. If the location is not available, replace it with any location you're using.
Curl
curl -X POST \
https://mySampleEnv.live.dexp.ae/api/v1/synthetic/monitors \
-H 'Authorization: Api-Token abcdefjhij1234567890' \
-H 'Content-Type: application/json' \
-d '{<truncated - see the Request body section >}'
Request URL
https://mySampleEnv.live.dexp.ae/api/v1/synthetic/monitors
Request body
api-examples/synthetic/post-monitor.json
{
"frequencyMin": 10,
"anomalyDetection": {
"outageHandling": {
"globalOutage": true,
"localOutage": false,
"localOutagePolicy": {
"affectedLocations": 1,
"consecutiveRuns": 3
}
},
"loadingTimeThresholds": {
"enabled": true,
"thresholds": [
{
"type": "total",
"valueMs": 500
}
]
}
},
"type": "BROWSER",
"name": "restExample",
"locations": [
"GEOLOCATION-0A41430434C388A9"
],
"enabled": true,
"script": {
"configuration": {
"device": {
"orientation": "landscape",
"deviceName": "Desktop"
}
},
"type": "clickpath",
"version": "1.0",
"events": [
{
"type": "navigate",
"wait": {
"waitFor":"page_complete"
},
"description": "navigate to main page ",
"url":"https://www.dexp.ae"
}
]
},
"tags": [
"restExample"
]
}
Response body
{
"entityId": "SYNTHETIC_TEST-00000000000254E2"
}
Response code
200