The Manage Monitors page lets you run an advanced search of all monitors so you can delete, mute, resolve, or edit service tags for selected monitors in bulk. You can also clone or fully edit any individual monitor in the search results.
Advanced search lets you query monitors by any combination of monitor attributes:
message— text search
status— Alert, Warn, No Data, Ok
scope— e.g. *, role:master-db
type— metric, integration, apm, etc
notification— the monitor’s notification target, e.g. email@example.com, slack-ops-oncall
metric— the metric or service check monitored, e.g. system.cpu.user, http.can_connect
To run a search, construct your query using the checkboxes on the left and/or the search bar along the top. When you check the boxes, the search bar updates with the equivalent query. Likewise, when you modify the search bar query (or write one from scratch), the checkboxes update to reflect the change. In any case, query results update in real-time as you edit the query; there’s no ‘Search’ button to click.
When you don’t need to search monitor titles and bodies for specific text, your search is a quick click or two away. Check as many boxes as you need to find your desired monitors, keeping the following in mind:
status:Alert type:Metric(the lack of an operator between the two search terms implies AND)
status:(Alert OR Warn), but there are some exceptions. For example, checking multiple scopes or service tags ANDs them.
status:(Alert OR Warn OR "No Data"), not
status:Triggered. Triggered is not a valid monitor status.
muted:trueto your query, not
metricin the query, e.g. selecting the check
metric:http.can_connectto your query.
For fields that have an arbitrary (i.e. large) number of values across all monitors—Service tag, Scope, Metric/Check, Notification—use the field-specific search bars to find the value you’re looking for.
When you need to run a more complex search than the checkboxes allow, use the search bar to edit your query or write a new one.
The most common reason to write a query is to search for specific text across all monitor titles and message bodies. A simple search of
postgresql returns all monitors with
postgresql anywhere in the title or message body. To search on title or message body, but not both, qualify the search term with the field name, e.g.
Otherwise, you can use boolean operators (AND, OR, and NOT) and parentheses to write complex queries using any monitor fields. The search syntax is very similar to that of Elasticsearch, so it’s easiest to describe how it is not like Elasticsearch syntax:
?) is not supported, but the general wildcard (
Finally, The following characters are reserved:
., and whitespace. To search monitor fields that include any of them, wrap the field string in quotes:
status:Alert AND "chef-client" is a valid query string;
status:Alert AND chef-client is not.
There are a few caveats regarding quoted fields:
.with or without surrounding quotes, as it commonly appears in some fields:
"chef-client*", while valid syntactically, won’t return a monitor titled
"chef-client failing"because the
*is treated literally.
When you have found the monitors you were looking for, select one or more that you wish you update using the checkboxes next to each result. You can select all results by ticking the topmost checkbox next to the STATUS column heading. Modify the monitors in bulk using the buttons at the top right of the search results: Mute, Resolve, Delete, and Edit Service Tags.
To edit an individual monitor, hover over it and use the buttons to the far right in its row: Edit, Clone, Mute, Delete. To see more detail on a monitor, click its Name to visit its status page.
You can mute or resolve triggered monitors in bulk using the Triggered Monitors page. It’s similar to the Manage Monitors page—you can find monitors by their attributes using the same easy tickboxes or query syntax—but there are a few differences. Aside from only showing monitors with a triggered status (Alert, Warn, or No Data), the main difference is that the Triggered Monitors page shows a row for each group (i.e. each reporting source) of each monitor.
Say you have a monitor called “high latency” that is grouped by host. If there are 20 hosts reporting and 14 have a triggered status, the Triggered Monitor page shows 14 rows if you search for the monitor by title in the query search bar (e.g.
high latency or
"high latency"). This lets you easily mute or resolve a monitor for some reporting sources, but not all (though of course you can mute or resolve all, too).
In writing your search queries, you can use all the same fields available on the Manage Monitors page, even though most of them aren’t controllable via tickboxes on the Triggered Monitors page. A few notes on field differences on the Triggered Monitors page:
group_statusfield instead of
triggeredfield, which lets you filter monitors by how long they’ve been triggered.
groupfield, which helps you narrow down search results for monitors grouped by more than one thing. Say you have a monitor grouped by
env. You search for this monitor by title and get four rows, where the groups are
host:web02,env:prod. Use the
groupfield to only show, for example, prod hosts (
group:"env:prod") or web02 hosts (
Additional helpful documentation, links, and articles: