Back to Collection Items
Use ChilkatAx-win32.pkg
Procedure Test
Handle hoHttp
Boolean iSuccess
Variant vJson
Handle hoJson
Variant vResp
Handle hoResp
Variant vSbResponseBody
Handle hoSbResponseBody
Handle hoJResp
Integer iRespStatusCode
Integer iV_end
Integer iStart
Integer j
Integer iCount_j
String sStrVal
String sData_source
String sAggregation
Integer iInterval
String sComputeMetric
String sQuery
String sFacet
Integer iLimit
String sSortAggregation
String sSortMetric
String sOrder
String sV_type
String sQuery
String sCreated
String sV_Email
String sHandle
String sName
String sDeleted
Integer iId
String sMessage
String sModified
Boolean iMulti
String sName
String sGroup_by
String sMetric
String sV_Type
Boolean iEnable_logs_sample
Boolean iEnable_samples
String sEscalation_message
Integer iEvaluation_delay
String sGroup_retention_duration
Boolean iGroupby_simple_monitor
Boolean iInclude_tags
Boolean iLocked
Integer iMin_failure_duration
Integer iMin_location_failed
Integer iNew_group_delay
Integer iNew_host_delay
Integer iNo_data_timeframe
String sNotification_preset_name
Boolean iNotify_audit
Boolean iNotify_no_data
String sOn_missing_data
String sRenotify_interval
Integer iRenotify_occurrences
Boolean iRequire_full_window
String sDay_starts
Integer iHour_starts
Integer iMonth_starts
Integer iNon_6f_
String sSynthetics_check_id
String sRecovery_window
String sTrigger_window
String sCritical
String sCritical_recovery
String sOk
String sUnknown
String sWarning
String sWarning_recovery
String sTimeout_h
String sOverall_state
Integer iPriority
Integer iLast_nodata_ts
Integer iLast_notified_ts
Integer iLast_resolved_ts
Integer iLast_triggered_ts
String sLorem_1Name
String sStatus
Integer iNisi_c43Last_nodata_ts
Integer iNisi_c43Last_notified_ts
Integer iNisi_c43Last_resolved_ts
Integer iNisi_c43Last_triggered_ts
String sNisi_c43Name
String sNisi_c43Status
Integer iMinim_cLast_nodata_ts
Integer iMinim_cLast_notified_ts
Integer iMinim_cLast_resolved_ts
Integer iMinim_cLast_triggered_ts
String sMinim_cName
String sMinim_cStatus
Integer i
Integer iCount_i
String sTemp1
Boolean bTemp1
// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
Get Create (RefClass(cComChilkatHttp)) To hoHttp
If (Not(IsComObjectCreated(hoHttp))) Begin
Send CreateComObject of hoHttp
End
// Use this online tool to generate code from sample JSON: Generate Code to Create JSON
// The following JSON is sent in the request body.
// {
// "message": "You may need to add web hosts if this is consistently high.",
// "name": "Bytes received on host0",
// "options": {
// "no_data_timeframe": 20,
// "notify_no_data": true
// },
// "query": "avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100",
// "tags": [
// "app:webserver",
// "frontend"
// ],
// "type": "query alert"
// }
Get Create (RefClass(cComChilkatJsonObject)) To hoJson
If (Not(IsComObjectCreated(hoJson))) Begin
Send CreateComObject of hoJson
End
Get ComUpdateString Of hoJson "message" "You may need to add web hosts if this is consistently high." To iSuccess
Get ComUpdateString Of hoJson "name" "Bytes received on host0" To iSuccess
Get ComUpdateInt Of hoJson "options.no_data_timeframe" 20 To iSuccess
Get ComUpdateBool Of hoJson "options.notify_no_data" True To iSuccess
Get ComUpdateString Of hoJson "query" "avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100" To iSuccess
Get ComUpdateString Of hoJson "tags[0]" "app:webserver" To iSuccess
Get ComUpdateString Of hoJson "tags[1]" "frontend" To iSuccess
Get ComUpdateString Of hoJson "type" "query alert" To iSuccess
Send ComSetRequestHeader To hoHttp "Content-Type" "application/json"
Send ComSetRequestHeader To hoHttp "Accept" "application/json"
Get pvComObject of hoJson to vJson
Get ComPostJson3 Of hoHttp "https://api.app.ddog-gov.com/api/v1/monitor" "application/json" vJson To vResp
If (IsComObject(vResp)) Begin
Get Create (RefClass(cComChilkatHttpResponse)) To hoResp
Set pvComObject Of hoResp To vResp
End
Get ComLastMethodSuccess Of hoHttp To bTemp1
If (bTemp1 = False) Begin
Get ComLastErrorText Of hoHttp To sTemp1
Showln sTemp1
Procedure_Return
End
Get Create (RefClass(cComChilkatStringBuilder)) To hoSbResponseBody
If (Not(IsComObjectCreated(hoSbResponseBody))) Begin
Send CreateComObject of hoSbResponseBody
End
Get pvComObject of hoSbResponseBody to vSbResponseBody
Get ComGetBodySb Of hoResp vSbResponseBody To iSuccess
Get Create (RefClass(cComChilkatJsonObject)) To hoJResp
If (Not(IsComObjectCreated(hoJResp))) Begin
Send CreateComObject of hoJResp
End
Get pvComObject of hoSbResponseBody to vSbResponseBody
Get ComLoadSb Of hoJResp vSbResponseBody To iSuccess
Set ComEmitCompact Of hoJResp To False
Showln "Response Body:"
Get ComEmit Of hoJResp To sTemp1
Showln sTemp1
Get ComStatusCode Of hoResp To iRespStatusCode
Showln "Response Status Code = " iRespStatusCode
If (iRespStatusCode >= 400) Begin
Showln "Response Header:"
Get ComHeader Of hoResp To sTemp1
Showln sTemp1
Showln "Failed."
Send Destroy of hoResp
Procedure_Return
End
Send Destroy of hoResp
// Sample JSON response:
// (Sample code for parsing the JSON response is shown below)
// {
// "type": "query alert",
// "query": "avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100",
// "created": "1989-12-01T14:28:43.831Z",
// "creator": {
// "email": "officia sunt",
// "handle": "pariatur",
// "name": "aute do"
// },
// "deleted": "2020-10-30T20:46:24.520Z",
// "id": -50675854,
// "matching_downtimes": [
// {
// "id": 1625,
// "end": 1412792983,
// "scope": [
// "env:staging"
// ],
// "start": 1412792983
// },
// {
// "id": 1625,
// "end": 1412792983,
// "scope": [
// "env:staging"
// ],
// "start": 1412792983
// }
// ],
// "message": "ullamco incididunt cupidatat",
// "modified": "1981-03-27T05:04:03.098Z",
// "multi": false,
// "name": "My monitor",
// "options": {
// "aggregation": {
// "group_by": "host",
// "metric": "metrics.name",
// "type": "count"
// },
// "device_ids": [
// "mobile_small",
// "chrome.tablet"
// ],
// "enable_logs_sample": false,
// "enable_samples": false,
// "escalation_message": "none",
// "evaluation_delay": -52819274,
// "group_retention_duration": "dolor Lorem qui",
// "groupby_simple_monitor": false,
// "include_tags": true,
// "locked": false,
// "min_failure_duration": 0,
// "min_location_failed": 1,
// "new_group_delay": -94315945,
// "new_host_delay": 300,
// "no_data_timeframe": -86360342,
// "notification_preset_name": "show_all",
// "notify_audit": false,
// "notify_by": [
// "labore dolore",
// "deserunt commodo consectetur"
// ],
// "notify_no_data": false,
// "on_missing_data": "resolve",
// "renotify_interval": null,
// "renotify_occurrences": 56355858,
// "renotify_statuses": [
// "warn",
// "no data"
// ],
// "require_full_window": false,
// "scheduling_options": {
// "evaluation_window": {
// "day_starts": "04:00",
// "hour_starts": 0,
// "month_starts": 1
// }
// },
// "silenced": {
// "non_6f_": 77287100
// },
// "synthetics_check_id": "culpa in laborum irure",
// "threshold_windows": {
// "recovery_window": "culpa cupidatat Lorem ut",
// "trigger_window": "fugiat officia mollit esse quis"
// },
// "thresholds": {
// "critical": -44507487.0891542,
// "critical_recovery": 94365870.17342958,
// "ok": 26645340.31156695,
// "unknown": -32772943.396166816,
// "warning": 75330874.10211122,
// "warning_recovery": 30665996.226613894
// },
// "timeout_h": null,
// "variables": [
// {
// "data_source": "rum",
// "compute": {
// "aggregation": "avg",
// "interval": 60000,
// "metric": "@duration"
// },
// "name": "query_errors",
// "group_by": [
// {
// "facet": "status",
// "limit": 10,
// "sort": {
// "aggregation": "avg",
// "metric": "minim tempor i",
// "order": "desc"
// }
// },
// {
// "facet": "status",
// "limit": 10,
// "sort": {
// "aggregation": "avg",
// "metric": "Ut fugiat officia",
// "order": "desc"
// }
// }
// ],
// "indexes": [
// "days-3",
// "days-7"
// ],
// "search": {
// "query": "service:query"
// }
// },
// {
// "data_source": "rum",
// "compute": {
// "aggregation": "avg",
// "interval": 60000,
// "metric": "@duration"
// },
// "name": "query_errors",
// "group_by": [
// {
// "facet": "status",
// "limit": 10,
// "sort": {
// "aggregation": "avg",
// "metric": "do velit",
// "order": "desc"
// }
// },
// {
// "facet": "status",
// "limit": 10,
// "sort": {
// "aggregation": "avg",
// "metric": "amet proident anim in",
// "order": "desc"
// }
// }
// ],
// "indexes": [
// "days-3",
// "days-7"
// ],
// "search": {
// "query": "service:query"
// }
// }
// ]
// },
// "overall_state": "Warn",
// "priority": 1,
// "restricted_roles": [
// "enim qui cillum est",
// "quis ut"
// ],
// "state": {
// "groups": {
// "Lorem_1": {
// "last_nodata_ts": -12653992,
// "last_notified_ts": -66141067,
// "last_resolved_ts": 5643925,
// "last_triggered_ts": -6121593,
// "name": "dolore nulla i",
// "status": "OK"
// },
// "nisi_c43": {
// "last_nodata_ts": -66061060,
// "last_notified_ts": -86988012,
// "last_resolved_ts": -39919633,
// "last_triggered_ts": 13467862,
// "name": "Ut fugiat eiusmod anim",
// "status": "Ignored"
// },
// "minim_c": {
// "last_nodata_ts": 6509669,
// "last_notified_ts": 39348490,
// "last_resolved_ts": 13221088,
// "last_triggered_ts": 21889420,
// "name": "in velit Duis",
// "status": "Alert"
// }
// }
// },
// "tags": [
// "ex tempor",
// "enim veniam dolore"
// ]
// }
// Sample code for parsing the JSON response...
// Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code
Get ComStringOf Of hoJResp "type" To sV_type
Get ComStringOf Of hoJResp "query" To sQuery
Get ComStringOf Of hoJResp "created" To sCreated
Get ComStringOf Of hoJResp "creator.email" To sV_Email
Get ComStringOf Of hoJResp "creator.handle" To sHandle
Get ComStringOf Of hoJResp "creator.name" To sName
Get ComStringOf Of hoJResp "deleted" To sDeleted
Get ComIntOf Of hoJResp "id" To iId
Get ComStringOf Of hoJResp "message" To sMessage
Get ComStringOf Of hoJResp "modified" To sModified
Get ComBoolOf Of hoJResp "multi" To iMulti
Get ComStringOf Of hoJResp "name" To sName
Get ComStringOf Of hoJResp "options.aggregation.group_by" To sGroup_by
Get ComStringOf Of hoJResp "options.aggregation.metric" To sMetric
Get ComStringOf Of hoJResp "options.aggregation.type" To sV_Type
Get ComBoolOf Of hoJResp "options.enable_logs_sample" To iEnable_logs_sample
Get ComBoolOf Of hoJResp "options.enable_samples" To iEnable_samples
Get ComStringOf Of hoJResp "options.escalation_message" To sEscalation_message
Get ComIntOf Of hoJResp "options.evaluation_delay" To iEvaluation_delay
Get ComStringOf Of hoJResp "options.group_retention_duration" To sGroup_retention_duration
Get ComBoolOf Of hoJResp "options.groupby_simple_monitor" To iGroupby_simple_monitor
Get ComBoolOf Of hoJResp "options.include_tags" To iInclude_tags
Get ComBoolOf Of hoJResp "options.locked" To iLocked
Get ComIntOf Of hoJResp "options.min_failure_duration" To iMin_failure_duration
Get ComIntOf Of hoJResp "options.min_location_failed" To iMin_location_failed
Get ComIntOf Of hoJResp "options.new_group_delay" To iNew_group_delay
Get ComIntOf Of hoJResp "options.new_host_delay" To iNew_host_delay
Get ComIntOf Of hoJResp "options.no_data_timeframe" To iNo_data_timeframe
Get ComStringOf Of hoJResp "options.notification_preset_name" To sNotification_preset_name
Get ComBoolOf Of hoJResp "options.notify_audit" To iNotify_audit
Get ComBoolOf Of hoJResp "options.notify_no_data" To iNotify_no_data
Get ComStringOf Of hoJResp "options.on_missing_data" To sOn_missing_data
Get ComStringOf Of hoJResp "options.renotify_interval" To sRenotify_interval
Get ComIntOf Of hoJResp "options.renotify_occurrences" To iRenotify_occurrences
Get ComBoolOf Of hoJResp "options.require_full_window" To iRequire_full_window
Get ComStringOf Of hoJResp "options.scheduling_options.evaluation_window.day_starts" To sDay_starts
Get ComIntOf Of hoJResp "options.scheduling_options.evaluation_window.hour_starts" To iHour_starts
Get ComIntOf Of hoJResp "options.scheduling_options.evaluation_window.month_starts" To iMonth_starts
Get ComIntOf Of hoJResp "options.silenced.non_6f_" To iNon_6f_
Get ComStringOf Of hoJResp "options.synthetics_check_id" To sSynthetics_check_id
Get ComStringOf Of hoJResp "options.threshold_windows.recovery_window" To sRecovery_window
Get ComStringOf Of hoJResp "options.threshold_windows.trigger_window" To sTrigger_window
Get ComStringOf Of hoJResp "options.thresholds.critical" To sCritical
Get ComStringOf Of hoJResp "options.thresholds.critical_recovery" To sCritical_recovery
Get ComStringOf Of hoJResp "options.thresholds.ok" To sOk
Get ComStringOf Of hoJResp "options.thresholds.unknown" To sUnknown
Get ComStringOf Of hoJResp "options.thresholds.warning" To sWarning
Get ComStringOf Of hoJResp "options.thresholds.warning_recovery" To sWarning_recovery
Get ComStringOf Of hoJResp "options.timeout_h" To sTimeout_h
Get ComStringOf Of hoJResp "overall_state" To sOverall_state
Get ComIntOf Of hoJResp "priority" To iPriority
Get ComIntOf Of hoJResp "state.groups.Lorem_1.last_nodata_ts" To iLast_nodata_ts
Get ComIntOf Of hoJResp "state.groups.Lorem_1.last_notified_ts" To iLast_notified_ts
Get ComIntOf Of hoJResp "state.groups.Lorem_1.last_resolved_ts" To iLast_resolved_ts
Get ComIntOf Of hoJResp "state.groups.Lorem_1.last_triggered_ts" To iLast_triggered_ts
Get ComStringOf Of hoJResp "state.groups.Lorem_1.name" To sLorem_1Name
Get ComStringOf Of hoJResp "state.groups.Lorem_1.status" To sStatus
Get ComIntOf Of hoJResp "state.groups.nisi_c43.last_nodata_ts" To iNisi_c43Last_nodata_ts
Get ComIntOf Of hoJResp "state.groups.nisi_c43.last_notified_ts" To iNisi_c43Last_notified_ts
Get ComIntOf Of hoJResp "state.groups.nisi_c43.last_resolved_ts" To iNisi_c43Last_resolved_ts
Get ComIntOf Of hoJResp "state.groups.nisi_c43.last_triggered_ts" To iNisi_c43Last_triggered_ts
Get ComStringOf Of hoJResp "state.groups.nisi_c43.name" To sNisi_c43Name
Get ComStringOf Of hoJResp "state.groups.nisi_c43.status" To sNisi_c43Status
Get ComIntOf Of hoJResp "state.groups.minim_c.last_nodata_ts" To iMinim_cLast_nodata_ts
Get ComIntOf Of hoJResp "state.groups.minim_c.last_notified_ts" To iMinim_cLast_notified_ts
Get ComIntOf Of hoJResp "state.groups.minim_c.last_resolved_ts" To iMinim_cLast_resolved_ts
Get ComIntOf Of hoJResp "state.groups.minim_c.last_triggered_ts" To iMinim_cLast_triggered_ts
Get ComStringOf Of hoJResp "state.groups.minim_c.name" To sMinim_cName
Get ComStringOf Of hoJResp "state.groups.minim_c.status" To sMinim_cStatus
Move 0 To i
Get ComSizeOfArray Of hoJResp "matching_downtimes" To iCount_i
While (i < iCount_i)
Set ComI Of hoJResp To i
Get ComIntOf Of hoJResp "matching_downtimes[i].id" To iId
Get ComIntOf Of hoJResp "matching_downtimes[i].end" To iV_end
Get ComIntOf Of hoJResp "matching_downtimes[i].start" To iStart
Move 0 To j
Get ComSizeOfArray Of hoJResp "matching_downtimes[i].scope" To iCount_j
While (j < iCount_j)
Set ComJ Of hoJResp To j
Get ComStringOf Of hoJResp "matching_downtimes[i].scope[j]" To sStrVal
Move (j + 1) To j
Loop
Move (i + 1) To i
Loop
Move 0 To i
Get ComSizeOfArray Of hoJResp "options.device_ids" To iCount_i
While (i < iCount_i)
Set ComI Of hoJResp To i
Get ComStringOf Of hoJResp "options.device_ids[i]" To sStrVal
Move (i + 1) To i
Loop
Move 0 To i
Get ComSizeOfArray Of hoJResp "options.notify_by" To iCount_i
While (i < iCount_i)
Set ComI Of hoJResp To i
Get ComStringOf Of hoJResp "options.notify_by[i]" To sStrVal
Move (i + 1) To i
Loop
Move 0 To i
Get ComSizeOfArray Of hoJResp "options.renotify_statuses" To iCount_i
While (i < iCount_i)
Set ComI Of hoJResp To i
Get ComStringOf Of hoJResp "options.renotify_statuses[i]" To sStrVal
Move (i + 1) To i
Loop
Move 0 To i
Get ComSizeOfArray Of hoJResp "options.variables" To iCount_i
While (i < iCount_i)
Set ComI Of hoJResp To i
Get ComStringOf Of hoJResp "options.variables[i].data_source" To sData_source
Get ComStringOf Of hoJResp "options.variables[i].compute.aggregation" To sAggregation
Get ComIntOf Of hoJResp "options.variables[i].compute.interval" To iInterval
Get ComStringOf Of hoJResp "options.variables[i].compute.metric" To sComputeMetric
Get ComStringOf Of hoJResp "options.variables[i].name" To sName
Get ComStringOf Of hoJResp "options.variables[i].search.query" To sQuery
Move 0 To j
Get ComSizeOfArray Of hoJResp "options.variables[i].group_by" To iCount_j
While (j < iCount_j)
Set ComJ Of hoJResp To j
Get ComStringOf Of hoJResp "options.variables[i].group_by[j].facet" To sFacet
Get ComIntOf Of hoJResp "options.variables[i].group_by[j].limit" To iLimit
Get ComStringOf Of hoJResp "options.variables[i].group_by[j].sort.aggregation" To sSortAggregation
Get ComStringOf Of hoJResp "options.variables[i].group_by[j].sort.metric" To sSortMetric
Get ComStringOf Of hoJResp "options.variables[i].group_by[j].sort.order" To sOrder
Move (j + 1) To j
Loop
Move 0 To j
Get ComSizeOfArray Of hoJResp "options.variables[i].indexes" To iCount_j
While (j < iCount_j)
Set ComJ Of hoJResp To j
Get ComStringOf Of hoJResp "options.variables[i].indexes[j]" To sStrVal
Move (j + 1) To j
Loop
Move (i + 1) To i
Loop
Move 0 To i
Get ComSizeOfArray Of hoJResp "restricted_roles" To iCount_i
While (i < iCount_i)
Set ComI Of hoJResp To i
Get ComStringOf Of hoJResp "restricted_roles[i]" To sStrVal
Move (i + 1) To i
Loop
Move 0 To i
Get ComSizeOfArray Of hoJResp "tags" To iCount_i
While (i < iCount_i)
Set ComI Of hoJResp To i
Get ComStringOf Of hoJResp "tags[i]" To sStrVal
Move (i + 1) To i
Loop
End_Procedure
Curl Command
curl -X POST
-H "Content-Type: application/json"
-H "Accept: application/json"
-d '{
"message": "You may need to add web hosts if this is consistently high.",
"name": "Bytes received on host0",
"options": {
"no_data_timeframe": 20,
"notify_no_data": true
},
"query": "avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100",
"tags": [
"app:webserver",
"frontend"
],
"type": "query alert"
}'
https://api.app.ddog-gov.com/api/v1/monitor
Postman Collection Item JSON
{
"name": "Create a monitor",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application/json"
},
{
"key": "Accept",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"message\": \"You may need to add web hosts if this is consistently high.\",\n \"name\": \"Bytes received on host0\",\n \"options\": {\n \"no_data_timeframe\": 20,\n \"notify_no_data\": true\n },\n \"query\": \"avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100\",\n \"tags\": [\n \"app:webserver\",\n \"frontend\"\n ],\n \"type\": \"query alert\"\n}",
"options": {
"raw": {
"headerFamily": "json",
"language": "json"
}
}
},
"url": {
"raw": "{{baseUrl}}/api/v1/monitor",
"host": [
"{{baseUrl}}"
],
"path": [
"api",
"v1",
"monitor"
]
},
"description": "Create a monitor using the specified options.\n\n#### Monitor Types\n\nThe type of monitor chosen from:\n\n- anomaly: `query alert`\n- APM: `query alert` or `trace-analytics alert`\n- composite: `composite`\n- custom: `service check`\n- event: `event alert`\n- forecast: `query alert`\n- host: `service check`\n- integration: `query alert` or `service check`\n- live process: `process alert`\n- logs: `log alert`\n- metric: `query alert`\n- network: `service check`\n- outlier: `query alert`\n- process: `service check`\n- rum: `rum alert`\n- SLO: `slo alert`\n- watchdog: `event alert`\n- event-v2: `event-v2 alert`\n- audit: `audit alert`\n- error-tracking: `error-tracking alert`\n- database-monitoring: `database-monitoring alert`\n\n**Note**: Synthetic monitors are created through the Synthetics API. See the [Synthetics API] (https://docs.datadoghq.com/api/latest/synthetics/) documentation for more information.\n\n#### Query Types\n\n##### Metric Alert Query\n\nExample: `time_aggr(time_window):space_aggr:metric{tags} [by {key}] operator #`\n\n- `time_aggr`: avg, sum, max, min, change, or pct_change\n- `time_window`: `last_#m` (with `#` between 1 and 10080 depending on the monitor type) or `last_#h`(with `#` between 1 and 168 depending on the monitor type) or `last_1d`, or `last_1w`\n- `space_aggr`: avg, sum, min, or max\n- `tags`: one or more tags (comma-separated), or *\n- `key`: a 'key' in key:value tag syntax; defines a separate alert for each tag in the group (multi-alert)\n- `operator`: <, <=, >, >=, ==, or !=\n- `#`: an integer or decimal number used to set the threshold\n\nIf you are using the `_change_` or `_pct_change_` time aggregator, instead use `change_aggr(time_aggr(time_window),\ntimeshift):space_aggr:metric{tags} [by {key}] operator #` with:\n\n- `change_aggr` change, pct_change\n- `time_aggr` avg, sum, max, min [Learn more](https://docs.datadoghq.com/monitors/create/types/#define-the-conditions)\n- `time_window` last\\_#m (between 1 and 2880 depending on the monitor type), last\\_#h (between 1 and 48 depending on the monitor type), or last_#d (1 or 2)\n- `timeshift` #m_ago (5, 10, 15, or 30), #h_ago (1, 2, or 4), or 1d_ago\n\nUse this to create an outlier monitor using the following query:\n`avg(last_30m):outliers(avg:system.cpu.user{role:es-events-data} by {host}, 'dbscan', 7) > 0`\n\n##### Service Check Query\n\nExample: `\"check\".over(tags).last(count).by(group).count_by_status()`\n\n- `check` name of the check, for example `datadog.agent.up`\n- `tags` one or more quoted tags (comma-separated), or \"*\". for example: `.over(\"env:prod\", \"role:db\")`; `over` cannot be blank.\n- `count` must be at greater than or equal to your max threshold (defined in the `options`). It is limited to 100.\nFor example, if you've specified to notify on 1 critical, 3 ok, and 2 warn statuses, `count` should be at least 3.\n- `group` must be specified for check monitors. Per-check grouping is already explicitly known for some service checks.\nFor example, Postgres integration monitors are tagged by `db`, `host`, and `port`, and Network monitors by `host`, `instance`, and `url`. See [Service Checks](https://docs.datadoghq.com/api/latest/service-checks/) documentation for more information.\n\n##### Event Alert Query\n\nExample: `events('sources:nagios status:error,warning priority:normal tags: \"string query\"').rollup(\"count\").last(\"1h\")\"`\n\n- `event`, the event query string:\n- `string_query` free text query to match against event title and text.\n- `sources` event sources (comma-separated).\n- `status` event statuses (comma-separated). Valid options: error, warn, and info.\n- `priority` event priorities (comma-separated). Valid options: low, normal, all.\n- `host` event reporting host (comma-separated).\n- `tags` event tags (comma-separated).\n- `excluded_tags` excluded event tags (comma-separated).\n- `rollup` the stats roll-up method. `count` is the only supported method now.\n- `last` the timeframe to roll up the counts. Examples: 45m, 4h. Supported timeframes: m, h and d. This value should not exceed 48 hours.\n\n**NOTE** The Event Alert Query is being deprecated and replaced by the Event V2 Alert Query. For more information, see the [Event Migration guide](https://docs.datadoghq.com/events/guides/migrating_to_new_events_features/).\n\n##### Event V2 Alert Query\n\nExample: `events(query).rollup(rollup_method[, measure]).last(time_window) operator #`\n\n- `query` The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).\n- `rollup_method` The stats roll-up method - supports `count`, `avg` and `cardinality`.\n- `measure` For `avg` and cardinality `rollup_method` - specify the measure or the facet name you want to use.\n- `time_window` #m (between 1 and 2880), #h (between 1 and 48).\n- `operator` `<`, `<=`, `>`, `>=`, `==`, or `!=`.\n- `#` an integer or decimal number used to set the threshold.\n\n##### Process Alert Query\n\nExample: `processes(search).over(tags).rollup('count').last(timeframe) operator #`\n\n- `search` free text search string for querying processes.\nMatching processes match results on the [Live Processes](https://docs.datadoghq.com/infrastructure/process/?tab=linuxwindows) page.\n- `tags` one or more tags (comma-separated)\n- `timeframe` the timeframe to roll up the counts. Examples: 10m, 4h. Supported timeframes: s, m, h and d\n- `operator` <, <=, >, >=, ==, or !=\n- `#` an integer or decimal number used to set the threshold\n\n##### Logs Alert Query\n\nExample: `logs(query).index(index_name).rollup(rollup_method[, measure]).last(time_window) operator #`\n\n- `query` The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).\n- `index_name` For multi-index organizations, the log index in which the request is performed.\n- `rollup_method` The stats roll-up method - supports `count`, `avg` and `cardinality`.\n- `measure` For `avg` and cardinality `rollup_method` - specify the measure or the facet name you want to use.\n- `time_window` #m (between 1 and 2880), #h (between 1 and 48).\n- `operator` `<`, `<=`, `>`, `>=`, `==`, or `!=`.\n- `#` an integer or decimal number used to set the threshold.\n\n##### Composite Query\n\nExample: `12345 && 67890`, where `12345` and `67890` are the IDs of non-composite monitors\n\n* `name` [*required*, *default* = **dynamic, based on query**]: The name of the alert.\n* `message` [*required*, *default* = **dynamic, based on query**]: A message to include with notifications for this monitor.\nEmail notifications can be sent to specific users by using the same '@username' notation as events.\n* `tags` [*optional*, *default* = **empty list**]: A list of tags to associate with your monitor.\nWhen getting all monitor details via the API, use the `monitor_tags` argument to filter results by these tags.\nIt is only available via the API and isn't visible or editable in the Datadog UI.\n\n##### SLO Alert Query\n\nExample: `error_budget(\"slo_id\").over(\"time_window\") operator #`\n\n- `slo_id`: The alphanumeric SLO ID of the SLO you are configuring the alert for.\n- `time_window`: The time window of the SLO target you wish to alert on. Valid options: `7d`, `30d`, `90d`.\n- `operator`: `>=` or `>`\n\n##### Audit Alert Query\n\nExample: `audits(query).rollup(rollup_method[, measure]).last(time_window) operator #`\n\n- `query` The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).\n- `rollup_method` The stats roll-up method - supports `count`, `avg` and `cardinality`.\n- `measure` For `avg` and cardinality `rollup_method` - specify the measure or the facet name you want to use.\n- `time_window` #m (between 1 and 2880), #h (between 1 and 48).\n- `operator` `<`, `<=`, `>`, `>=`, `==`, or `!=`.\n- `#` an integer or decimal number used to set the threshold.\n\n**NOTE** Only available on US1-FED and in closed beta on US1, EU, AP1, US3, and US5.\n\n##### CI Pipelines Alert Query\n\nExample: `ci-pipelines(query).rollup(rollup_method[, measure]).last(time_window) operator #`\n\n- `query` The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).\n- `rollup_method` The stats roll-up method - supports `count`, `avg`, and `cardinality`.\n- `measure` For `avg` and cardinality `rollup_method` - specify the measure or the facet name you want to use.\n- `time_window` #m (between 1 and 2880), #h (between 1 and 48).\n- `operator` `<`, `<=`, `>`, `>=`, `==`, or `!=`.\n- `#` an integer or decimal number used to set the threshold.\n\n**NOTE** CI Pipeline monitors are in alpha on US1, EU, AP1, US3, and US5.\n\n##### CI Tests Alert Query\n\nExample: `ci-tests(query).rollup(rollup_method[, measure]).last(time_window) operator #`\n\n- `query` The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).\n- `rollup_method` The stats roll-up method - supports `count`, `avg`, and `cardinality`.\n- `measure` For `avg` and cardinality `rollup_method` - specify the measure or the facet name you want to use.\n- `time_window` #m (between 1 and 2880), #h (between 1 and 48).\n- `operator` `<`, `<=`, `>`, `>=`, `==`, or `!=`.\n- `#` an integer or decimal number used to set the threshold.\n\n**NOTE** CI Test monitors are available only in closed beta on US1, EU, AP1, US3, and US5.\n\n##### Error Tracking Alert Query\n\nExample(RUM): `error-tracking-rum(query).rollup(rollup_method[, measure]).last(time_window) operator #`\nExample(APM Traces): `error-tracking-traces(query).rollup(rollup_method[, measure]).last(time_window) operator #`\n\n- `query` The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).\n- `rollup_method` The stats roll-up method - supports `count`, `avg`, and `cardinality`.\n- `measure` For `avg` and cardinality `rollup_method` - specify the measure or the facet name you want to use.\n- `time_window` #m (between 1 and 2880), #h (between 1 and 48).\n- `operator` `<`, `<=`, `>`, `>=`, `==`, or `!=`.\n- `#` an integer or decimal number used to set the threshold.\n\n**Database Monitoring Alert Query**\n\nExample: `database-monitoring(query).rollup(rollup_method[, measure]).last(time_window) operator #`\n\n- `query` The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).\n- `rollup_method` The stats roll-up method - supports `count`, `avg`, and `cardinality`.\n- `measure` For `avg` and cardinality `rollup_method` - specify the measure or the facet name you want to use.\n- `time_window` #m (between 1 and 2880), #h (between 1 and 48).\n- `operator` `<`, `<=`, `>`, `>=`, `==`, or `!=`.\n- `#` an integer or decimal number used to set the threshold.\n\n**NOTE** Database Monitoring monitors are in alpha on US1."
},
"response": [
{
"name": "OK",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application/json"
},
{
"key": "Accept",
"value": "application/json"
},
{
"description": "Added as a part of security scheme: apikey",
"key": "DD-API-KEY",
"value": "<API Key>"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"message\": \"You may need to add web hosts if this is consistently high.\",\n \"name\": \"Bytes received on host0\",\n \"options\": {\n \"no_data_timeframe\": 20,\n \"notify_no_data\": true\n },\n \"query\": \"avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100\",\n \"tags\": [\n \"app:webserver\",\n \"frontend\"\n ],\n \"type\": \"query alert\"\n}",
"options": {
"raw": {
"headerFamily": "json",
"language": "json"
}
}
},
"url": {
"raw": "{{baseUrl}}/api/v1/monitor",
"host": [
"{{baseUrl}}"
],
"path": [
"api",
"v1",
"monitor"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [
],
"body": "{\n \"type\": \"query alert\",\n \"query\": \"avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100\",\n \"created\": \"1989-12-01T14:28:43.831Z\",\n \"creator\": {\n \"email\": \"officia sunt\",\n \"handle\": \"pariatur\",\n \"name\": \"aute do\"\n },\n \"deleted\": \"2020-10-30T20:46:24.520Z\",\n \"id\": -50675854,\n \"matching_downtimes\": [\n {\n \"id\": 1625,\n \"end\": 1412792983,\n \"scope\": [\n \"env:staging\"\n ],\n \"start\": 1412792983\n },\n {\n \"id\": 1625,\n \"end\": 1412792983,\n \"scope\": [\n \"env:staging\"\n ],\n \"start\": 1412792983\n }\n ],\n \"message\": \"ullamco incididunt cupidatat\",\n \"modified\": \"1981-03-27T05:04:03.098Z\",\n \"multi\": false,\n \"name\": \"My monitor\",\n \"options\": {\n \"aggregation\": {\n \"group_by\": \"host\",\n \"metric\": \"metrics.name\",\n \"type\": \"count\"\n },\n \"device_ids\": [\n \"mobile_small\",\n \"chrome.tablet\"\n ],\n \"enable_logs_sample\": false,\n \"enable_samples\": false,\n \"escalation_message\": \"none\",\n \"evaluation_delay\": -52819274,\n \"group_retention_duration\": \"dolor Lorem qui\",\n \"groupby_simple_monitor\": false,\n \"include_tags\": true,\n \"locked\": false,\n \"min_failure_duration\": 0,\n \"min_location_failed\": 1,\n \"new_group_delay\": -94315945,\n \"new_host_delay\": 300,\n \"no_data_timeframe\": -86360342,\n \"notification_preset_name\": \"show_all\",\n \"notify_audit\": false,\n \"notify_by\": [\n \"labore dolore\",\n \"deserunt commodo consectetur\"\n ],\n \"notify_no_data\": false,\n \"on_missing_data\": \"resolve\",\n \"renotify_interval\": null,\n \"renotify_occurrences\": 56355858,\n \"renotify_statuses\": [\n \"warn\",\n \"no data\"\n ],\n \"require_full_window\": false,\n \"scheduling_options\": {\n \"evaluation_window\": {\n \"day_starts\": \"04:00\",\n \"hour_starts\": 0,\n \"month_starts\": 1\n }\n },\n \"silenced\": {\n \"non_6f_\": 77287100\n },\n \"synthetics_check_id\": \"culpa in laborum irure\",\n \"threshold_windows\": {\n \"recovery_window\": \"culpa cupidatat Lorem ut\",\n \"trigger_window\": \"fugiat officia mollit esse quis\"\n },\n \"thresholds\": {\n \"critical\": -44507487.0891542,\n \"critical_recovery\": 94365870.17342958,\n \"ok\": 26645340.31156695,\n \"unknown\": -32772943.396166816,\n \"warning\": 75330874.10211122,\n \"warning_recovery\": 30665996.226613894\n },\n \"timeout_h\": null,\n \"variables\": [\n {\n \"data_source\": \"rum\",\n \"compute\": {\n \"aggregation\": \"avg\",\n \"interval\": 60000,\n \"metric\": \"@duration\"\n },\n \"name\": \"query_errors\",\n \"group_by\": [\n {\n \"facet\": \"status\",\n \"limit\": 10,\n \"sort\": {\n \"aggregation\": \"avg\",\n \"metric\": \"minim tempor i\",\n \"order\": \"desc\"\n }\n },\n {\n \"facet\": \"status\",\n \"limit\": 10,\n \"sort\": {\n \"aggregation\": \"avg\",\n \"metric\": \"Ut fugiat officia\",\n \"order\": \"desc\"\n }\n }\n ],\n \"indexes\": [\n \"days-3\",\n \"days-7\"\n ],\n \"search\": {\n \"query\": \"service:query\"\n }\n },\n {\n \"data_source\": \"rum\",\n \"compute\": {\n \"aggregation\": \"avg\",\n \"interval\": 60000,\n \"metric\": \"@duration\"\n },\n \"name\": \"query_errors\",\n \"group_by\": [\n {\n \"facet\": \"status\",\n \"limit\": 10,\n \"sort\": {\n \"aggregation\": \"avg\",\n \"metric\": \"do velit\",\n \"order\": \"desc\"\n }\n },\n {\n \"facet\": \"status\",\n \"limit\": 10,\n \"sort\": {\n \"aggregation\": \"avg\",\n \"metric\": \"amet proident anim in\",\n \"order\": \"desc\"\n }\n }\n ],\n \"indexes\": [\n \"days-3\",\n \"days-7\"\n ],\n \"search\": {\n \"query\": \"service:query\"\n }\n }\n ]\n },\n \"overall_state\": \"Warn\",\n \"priority\": 1,\n \"restricted_roles\": [\n \"enim qui cillum est\",\n \"quis ut\"\n ],\n \"state\": {\n \"groups\": {\n \"Lorem_1\": {\n \"last_nodata_ts\": -12653992,\n \"last_notified_ts\": -66141067,\n \"last_resolved_ts\": 5643925,\n \"last_triggered_ts\": -6121593,\n \"name\": \"dolore nulla i\",\n \"status\": \"OK\"\n },\n \"nisi_c43\": {\n \"last_nodata_ts\": -66061060,\n \"last_notified_ts\": -86988012,\n \"last_resolved_ts\": -39919633,\n \"last_triggered_ts\": 13467862,\n \"name\": \"Ut fugiat eiusmod anim\",\n \"status\": \"Ignored\"\n },\n \"minim_c\": {\n \"last_nodata_ts\": 6509669,\n \"last_notified_ts\": 39348490,\n \"last_resolved_ts\": 13221088,\n \"last_triggered_ts\": 21889420,\n \"name\": \"in velit Duis\",\n \"status\": \"Alert\"\n }\n }\n },\n \"tags\": [\n \"ex tempor\",\n \"enim veniam dolore\"\n ]\n}"
},
{
"name": "Bad Request",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application/json"
},
{
"key": "Accept",
"value": "application/json"
},
{
"description": "Added as a part of security scheme: apikey",
"key": "DD-API-KEY",
"value": "<API Key>"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"message\": \"You may need to add web hosts if this is consistently high.\",\n \"name\": \"Bytes received on host0\",\n \"options\": {\n \"no_data_timeframe\": 20,\n \"notify_no_data\": true\n },\n \"query\": \"avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100\",\n \"tags\": [\n \"app:webserver\",\n \"frontend\"\n ],\n \"type\": \"query alert\"\n}",
"options": {
"raw": {
"headerFamily": "json",
"language": "json"
}
}
},
"url": {
"raw": "{{baseUrl}}/api/v1/monitor",
"host": [
"{{baseUrl}}"
],
"path": [
"api",
"v1",
"monitor"
]
}
},
"status": "Bad Request",
"code": 400,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [
],
"body": "{\n \"errors\": [\n \"Bad Request\",\n \"Bad Request\"\n ]\n}"
},
{
"name": "Forbidden",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application/json"
},
{
"key": "Accept",
"value": "application/json"
},
{
"description": "Added as a part of security scheme: apikey",
"key": "DD-API-KEY",
"value": "<API Key>"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"message\": \"You may need to add web hosts if this is consistently high.\",\n \"name\": \"Bytes received on host0\",\n \"options\": {\n \"no_data_timeframe\": 20,\n \"notify_no_data\": true\n },\n \"query\": \"avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100\",\n \"tags\": [\n \"app:webserver\",\n \"frontend\"\n ],\n \"type\": \"query alert\"\n}",
"options": {
"raw": {
"headerFamily": "json",
"language": "json"
}
}
},
"url": {
"raw": "{{baseUrl}}/api/v1/monitor",
"host": [
"{{baseUrl}}"
],
"path": [
"api",
"v1",
"monitor"
]
}
},
"status": "Forbidden",
"code": 403,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [
],
"body": "{\n \"errors\": [\n \"Bad Request\",\n \"Bad Request\"\n ]\n}"
},
{
"name": "Too many requests",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application/json"
},
{
"key": "Accept",
"value": "application/json"
},
{
"description": "Added as a part of security scheme: apikey",
"key": "DD-API-KEY",
"value": "<API Key>"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"message\": \"You may need to add web hosts if this is consistently high.\",\n \"name\": \"Bytes received on host0\",\n \"options\": {\n \"no_data_timeframe\": 20,\n \"notify_no_data\": true\n },\n \"query\": \"avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100\",\n \"tags\": [\n \"app:webserver\",\n \"frontend\"\n ],\n \"type\": \"query alert\"\n}",
"options": {
"raw": {
"headerFamily": "json",
"language": "json"
}
}
},
"url": {
"raw": "{{baseUrl}}/api/v1/monitor",
"host": [
"{{baseUrl}}"
],
"path": [
"api",
"v1",
"monitor"
]
}
},
"status": "Too Many Requests",
"code": 429,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [
],
"body": "{\n \"errors\": [\n \"Bad Request\",\n \"Bad Request\"\n ]\n}"
}
]
}
