Get all monitor details
GET {{baseUrl}}/api/v1/monitor
Get details about the specified monitor from your organization.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
group_states | string | When specified, shows additional information about the group states. | |
Choose one or more from all, alert, warn, and no data. | |||
name | string | A string to filter monitors by name. | |
tags | string | A comma separated list indicating what tags, if any, should be used to filter the list of monitors by scope. | |
For example, host:host0. | |||
monitor_tags | string | A comma separated list indicating what service and/or custom tags, if any, should be used to filter the list of monitors. | |
Tags created in the Datadog UI automatically have the service key prepended. For example, service:my-app. | |||
with_downtimes | boolean | If this argument is set to true, then the returned data includes all current active downtimes for each monitor. | |
id_offset | number | Use this parameter for paginating through large sets of monitors. Start with a value of zero, make a request, set the value to the last ID of result set, and then repeat until the response is empty. | |
page | number | The page to start paginating from. If this argument is not specified, the request returns all monitors without pagination. | |
page_size | number | The number of monitors to return per page. If the page argument is not specified, the default behavior returns all monitors without a page_size limit. However, if page is specified and page_size is not, the argument defaults to 100. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
[{"type":"query alert","query":"avg(last_5m):sum:system.net.bytes_rcvd{host:host0} \u003e 100","created":"1968-12-22T10:23:44.547Z","creator":{"email":"Lorem","handle":"ea ad","name":"exercitation occaecat fugiat"},"deleted":"1957-11-20T09:35:51.648Z","id":-52785033,"matching_downtimes":[{"id":1625,"end":1412792983,"scope":["env:staging"],"start":1412792983},{"id":1625,"end":1412792983,"scope":["env:staging"],"start":1412792983}],"message":"fugiat aute","modified":"2016-02-23T08:25:10.298Z","multi":true,"name":"My monitor","options":{"aggregation":{"group_by":"host","metric":"metrics.name","type":"count"},"enable_logs_sample":true,"enable_samples":true,"escalation_message":"sit Lorem","evaluation_delay":81702297,"group_retention_duration":"culpa est","groupby_simple_monitor":false,"include_tags":true,"min_failure_duration":0,"min_location_failed":1,"new_group_delay":83284399,"no_data_timeframe":38198133,"notification_preset_name":"show_all","notify_audit":false,"notify_by":["id nostrud labore laboris sint","Lorem exercitation labore"],"notify_no_data":true,"on_missing_data":"default","renotify_interval":null,"renotify_occurrences":-75196602,"renotify_statuses":["alert","warn"],"require_full_window":true,"scheduling_options":{"custom_schedule":{"recurrences":[{"rrule":"FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR","start":"2023-08-31T16:30:00","timezone":"Europe/Paris"},{"rrule":"FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR","start":"2023-08-31T16:30:00","timezone":"Europe/Paris"}]},"evaluation_window":{"day_starts":"04:00","hour_starts":0,"month_starts":1}},"threshold_windows":{"recovery_window":"dolore anim veniam","trigger_window":"et reprehenderit Ut"},"thresholds":{"critical":-93227660.1225225,"critical_recovery":54848571.83284998,"ok":42528324.94726676,"unknown":25234544.24275866,"warning":31677783.689706236,"warning_recovery":12934179.164734736},"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":"quis non pariatur consequat","order":"desc"}},{"facet":"status","limit":10,"sort":{"aggregation":"avg","metric":"irure adipisicing aliqua","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":"minim","order":"desc"}},{"facet":"status","limit":10,"sort":{"aggregation":"avg","metric":"eiusmod","order":"desc"}}],"indexes":["days-3","days-7"],"search":{"query":"service:query"}}]},"overall_state":"Warn","priority":2,"restricted_roles":["esse qui Ut eiusmod officia","cupidatat deserunt labore elit"],"state":{"groups":{"commodo_7":{"last_nodata_ts":76648341,"last_notified_ts":-58294565,"last_resolved_ts":-86848018,"last_triggered_ts":-87357474,"name":"elit tempor nulla","status":"Alert"},"Ut9e":{"last_nodata_ts":-56064388,"last_notified_ts":82661693,"last_resolved_ts":1205946,"last_triggered_ts":-36844347,"name":"ut","status":"Warn"},"esse_1":{"last_nodata_ts":63786855,"last_notified_ts":-97622539,"last_resolved_ts":-32537264,"last_triggered_ts":46932555,"name":"in","status":"Unknown"},"tempor6":{"last_nodata_ts":8598206,"last_notified_ts":-33351692,"last_resolved_ts":-69521487,"last_triggered_ts":42717159,"name":"fugiat aliquip consequat dolore","status":"No Data"}}},"tags":["tempor ut","ea elit officia"]},{"type":"query alert","query":"avg(last_5m):sum:system.net.bytes_rcvd{host:host0} \u003e 100","created":"2004-01-02T04:48:18.523Z","creator":{"email":"es","handle":"temp","name":"tempor dolore anim in"},"deleted":"2008-08-15T21:08:26.899Z","id":-51965098,"matching_downtimes":[{"id":1625,"end":1412792983,"scope":["env:staging"],"start":1412792983},{"id":1625,"end":1412792983,"scope":["env:staging"],"start":1412792983}],"message":"ut","modified":"2005-03-10T13:34:28.799Z","multi":true,"name":"My monitor","options":{"aggregation":{"group_by":"host","metric":"metrics.name","type":"count"},"enable_logs_sample":true,"enable_samples":false,"escalation_message":"nisi dolor cillum quis proident","evaluation_delay":98247874,"group_retention_duration":"esse labore non eu","groupby_simple_monitor":false,"include_tags":true,"min_failure_duration":0,"min_location_failed":1,"new_group_delay":83568537,"no_data_timeframe":38046740,"notification_preset_name":"show_all","notify_audit":false,"notify_by":["quis aute","et incididunt deserunt in"],"notify_no_data":false,"on_missing_data":"show_and_notify_no_data","renotify_interval":null,"renotify_occurrences":-83601397,"renotify_statuses":["warn","warn"],"require_full_window":false,"scheduling_options":{"custom_schedule":{"recurrences":[{"rrule":"FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR","start":"2023-08-31T16:30:00","timezone":"Europe/Paris"},{"rrule":"FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR","start":"2023-08-31T16:30:00","timezone":"Europe/Paris"}]},"evaluation_window":{"day_starts":"04:00","hour_starts":0,"month_starts":1}},"threshold_windows":{"recovery_window":"dolor enim dolore","trigger_window":"aliqua non in veniam"},"thresholds":{"critical":24133850.051977217,"critical_recovery":27864124.367435932,"ok":84223880.08315665,"unknown":31175934.015187636,"warning":83948037.84049499,"warning_recovery":-23758868.821760252},"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":"laboris ipsum consequat occ","order":"desc"}},{"facet":"status","limit":10,"sort":{"aggregation":"avg","metric":"nostrud ea in","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":"dolore pariatur esse magna","order":"desc"}},{"facet":"status","limit":10,"sort":{"aggregation":"avg","metric":"in sint dolor","order":"desc"}}],"indexes":["days-3","days-7"],"search":{"query":"service:query"}}]},"overall_state":"No Data","priority":2,"restricted_roles":["ex in","ex velit sed veniam"],"state":{"groups":{"aliqua16":{"last_nodata_ts":-65843386,"last_notified_ts":-89493790,"last_resolved_ts":27985684,"last_triggered_ts":16421307,"name":"Excepteur","status":"No Data"},"culpa6e4":{"last_nodata_ts":-16909202,"last_notified_ts":98113790,"last_resolved_ts":43085013,"last_triggered_ts":-97185607,"name":"anim","status":"Ignored"}}},"tags":["sint culpa sunt cillum","irure dolore adipisicing"]}]