Use the Manage Monitors page to search, delete, mute, or resolve your monitors and edit monitor tags in bulk. You can also clone or edit individual monitors from the search results.
To search your monitors, construct a query using the attribute checkboxes on the left and/or the search bar at the top. When you select attributes, the search bar updates with the equivalent query. Likewise, when you modify the search bar query (or write a new one), the attribute checkboxes update to reflect the change. In any case, query results update in real-time as you edit the query. Note: There is no search button to click.
Use simple text to search across all monitor titles and notification messages. For example, a search of postgresql returns all monitors with postgresql anywhere in the title or notification message.
To limit the search, specify the field name:
| Item | Description | Example |
|---|---|---|
| Title | Search the text in the monitor’s title. | title:text |
| Message | Search the text in the monitor’s notification message. | message:text |
Additionally, you can search for a monitor using the ID, for example: 1234567. The monitor’s ID is available on the monitor status page.
Enhance your search query with boolean operators (AND, OR, NOT) and parentheses. The search syntax is very similar to Elasticsearch with the following exceptions:
?) is not supported, but the general wildcard (*) is supported.The following characters are reserved: -, (, ), ", ~, *, :, ., and whitespace. To search a monitor field that includes a reserved character, wrap the field string in quotes. For example, status:Alert AND "chef-client" is a valid query string.
There are a few caveats regarding quoted fields:
. with or without surrounding quotes, as it commonly appears in some fields. For example, metric:system.cpu.idle is valid."chef-client*" does not return a monitor titled "chef-client failing" because the * is treated literally.Advanced search lets you filter monitors by any combination of monitor attributes:
| Attribute | Description |
|---|---|
| Status | The monitor status: Triggered (Alert, Warn, No Data) or OK |
| Muted | The muted state of the monitor: true or false |
| Type | The Datadog monitor type |
| Creator | The creator of the monitor |
| Service | Service tags used by you in the form service:<VALUE>. |
| Tag | The tags assigned to the monitor |
| Env | Environment tags used by you in the form env:<VALUE>. |
| Scope | Search tags listed in the from field of your monitor query. |
| Metric/Check | The metric or service check being monitored |
| Notification | The person or service receiving a notification |
Check any number of boxes to find your monitors. The following rules apply:
AND operator is applied when checking attributes from different fields, for example: status:Alert type:Metric (the lack of an operator between the two search terms implies AND).OR operator is applied when checking attributes within the same field, for example: status:(Alert OR Warn). Some exceptions apply, for example checking multiple scopes or service tags uses the AND operator.Triggered checkbox under the Status attribute resolves to status:(Alert OR Warn OR "No Data"). Triggered is not a valid monitor status.metric in the query. For example, selecting the check http.can_connect resolves to metric:http.can_connect.Note: For attributes with a large number of values across your monitors, use the attribute search bar to find the correct value.
After searching, select one or more monitors to update using the checkboxes next to each result. Select all results with the top checkbox next to the STATUS column heading. Modify the monitors in bulk using the buttons at the right above the search results:
| Option | Description |
|---|---|
| Mute | Mute the selected monitors for 1h, 4h, 12h, 1d, 1w, or Forever |
| Unmute | If the selected monitors are muted, unmute them. |
| Resolve | Resolve the alert for the selected monitors. |
| Delete | Permanently delete the selected monitors. |
| Edit Tags | Edit the monitor tags for the selected monitors. |
To edit an individual monitor, hover over it and use the buttons to the far right: Edit, Clone, Mute, Delete. To see more details on a monitor, click its name to visit the status page.
You can mute or resolve triggered monitors in bulk using the Triggered Monitors page. This page only shows monitors with a triggered status (Alert, Warn, or No Data).
The triggered monitors page shows a row for each group (reporting source) of each monitor. For example, a monitor grouped by host with 14 hosts in a triggered status shows 14 rows on the triggered monitors page. This lets you mute or resolve a monitor for specific reporting sources.
When writing a search query, the same attributes from the manage monitors page are available, even if they are not displayed as check boxes on the triggered monitors page.
Attribute differences for the triggered monitors page:
group_status is the attribute name instead of status.triggered attribute lets you filter monitors by how long they have been triggered.group attribute helps you narrow down search results for monitors grouped by more than one tag. For example, a monitor is grouped by host and env. After searching, you see four rows with the groups host:web01,env:dev, host:web02,env:dev, host:web01,env:prod, and host:web02,env:prod. Use the group attribute to only show prod hosts (group:"env:prod") or web02 hosts (group:"host:web02").Monitor tags are independent of tags sent by the Agent or integrations. Add tags directly to your monitors for filtering on the manage monitors, triggered monitors, or manage downtime pages. Learn more about monitor tags in the tagging documentation.
