Get all monitor details
GET {{baseUrl}}/api/v1/monitor?group_states=alert&name=tempor Ut sed velit&tags=host:host0&monitor_tags=service:my-app&with_downtimes=true&id_offset=-62147425&page=0&page_size=20
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":"1977-10-10T13:08:01.527Z","creator":{"email":"eiusmod aliquip pariatur dolore","handle":"fugiat id sint","name":"elit in"},"deleted":"2015-07-16T18:46:50.390Z","id":83649643,"matching_downtimes":[{"id":1625,"end":1412792983,"scope":["env:staging"],"start":1412792983},{"id":1625,"end":1412792983,"scope":["env:staging"],"start":1412792983}],"message":"adi","modified":"1973-08-05T09:10:13.718Z","multi":false,"name":"My monitor","options":{"aggregation":{"group_by":"host","metric":"metrics.name","type":"count"},"device_ids":["firefox.tablet","mobile_small"],"enable_logs_sample":true,"enable_samples":true,"escalation_message":"none","evaluation_delay":27121357,"group_retention_duration":"esse aliquip ullamco irure","groupby_simple_monitor":true,"include_tags":true,"locked":false,"min_failure_duration":0,"min_location_failed":1,"new_group_delay":-9275927,"new_host_delay":300,"no_data_timeframe":58492166,"notification_preset_name":"show_all","notify_audit":false,"notify_by":["ut quis e","dolore elit"],"notify_no_data":false,"on_missing_data":"show_no_data","renotify_interval":null,"renotify_occurrences":-27638100,"renotify_statuses":["alert","warn"],"require_full_window":true,"scheduling_options":{"evaluation_window":{"day_starts":"04:00","hour_starts":0,"month_starts":1}},"silenced":{"Ut_d_e":94650378},"synthetics_check_id":"enim et tempor","threshold_windows":{"recovery_window":"ipsum eiusmod","trigger_window":"ullamco"},"thresholds":{"critical":-74585739.55469063,"critical_recovery":-14449679.792215124,"ok":69468073.65422091,"unknown":-35840527.53565459,"warning":-78191860.79094723,"warning_recovery":30967604.742167816},"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":"qui Ut cupidatat proid","order":"desc"}},{"facet":"status","limit":10,"sort":{"aggregation":"avg","metric":"nostrud mollit","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":"ut non","order":"desc"}},{"facet":"status","limit":10,"sort":{"aggregation":"avg","metric":"reprehenderit sint eu proident","order":"desc"}}],"indexes":["days-3","days-7"],"search":{"query":"service:query"}}]},"overall_state":"Unknown","priority":4,"restricted_roles":["Ut","dolor ad Duis proident"],"state":{"groups":{"ullamco2":{"last_nodata_ts":-30657062,"last_notified_ts":-69789968,"last_resolved_ts":-40935564,"last_triggered_ts":63742261,"name":"id","status":"Alert"},"voluptate_0c":{"last_nodata_ts":13097104,"last_notified_ts":53104444,"last_resolved_ts":-69320667,"last_triggered_ts":27152807,"name":"quis amet","status":"Alert"}}},"tags":["fugiat culpa aliqua consectetur","minim in"]},{"type":"query alert","query":"avg(last_5m):sum:system.net.bytes_rcvd{host:host0} \u003e 100","created":"1952-04-01T14:02:58.093Z","creator":{"email":"esse ad veniam qui","handle":"nulla enim non","name":"ut reprehend"},"deleted":"2005-07-24T20:18:36.078Z","id":14961847,"matching_downtimes":[{"id":1625,"end":1412792983,"scope":["env:staging"],"start":1412792983},{"id":1625,"end":1412792983,"scope":["env:staging"],"start":1412792983}],"message":"labore nulla","modified":"2013-05-28T22:30:26.014Z","multi":true,"name":"My monitor","options":{"aggregation":{"group_by":"host","metric":"metrics.name","type":"count"},"device_ids":["chrome.tablet","firefox.laptop_large"],"enable_logs_sample":false,"enable_samples":true,"escalation_message":"none","evaluation_delay":48023490,"group_retention_duration":"veniam eiusmod anim","groupby_simple_monitor":true,"include_tags":true,"locked":false,"min_failure_duration":0,"min_location_failed":1,"new_group_delay":-78698406,"new_host_delay":300,"no_data_timeframe":-29298203,"notification_preset_name":"show_all","notify_audit":false,"notify_by":["in labore irure reprehenderit","Ut ea"],"notify_no_data":false,"on_missing_data":"default","renotify_interval":null,"renotify_occurrences":88843653,"renotify_statuses":["warn","no data"],"require_full_window":false,"scheduling_options":{"evaluation_window":{"day_starts":"04:00","hour_starts":0,"month_starts":1}},"silenced":{"ut_8":-75892703},"synthetics_check_id":"ut et aute cupidatat","threshold_windows":{"recovery_window":"dolor do","trigger_window":"pariatur"},"thresholds":{"critical":-5336230.352944598,"critical_recovery":7945004.71738635,"ok":-68115416.21610427,"unknown":89541673.34797806,"warning":66901483.96194494,"warning_recovery":-39599171.26178945},"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":"deserunt nisi mollit","order":"desc"}},{"facet":"status","limit":10,"sort":{"aggregation":"avg","metric":"dolor pariatur","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":"l","order":"desc"}},{"facet":"status","limit":10,"sort":{"aggregation":"avg","metric":"ut non","order":"desc"}}],"indexes":["days-3","days-7"],"search":{"query":"service:query"}}]},"overall_state":"Unknown","priority":3,"restricted_roles":["ipsum laboris laborum incididunt","fugiat non est"],"state":{"groups":{"Ut7":{"last_nodata_ts":21127128,"last_notified_ts":19208840,"last_resolved_ts":29022384,"last_triggered_ts":-96682791,"name":"ex tempor","status":"OK"}}},"tags":["dolor nulla dolore elit","consequat sunt in"]}]