Alerts & rules

What is firing right now, and the recording and alerting rules behind it.

Alerts

/api/v1/alerts — every alert that is firing or pending, with its labels, annotations and how long it has been in that state. This is the “what woke me up” screen, and it answers the follow-up question too: is it still firing?

Alerts poll while live updates are on, plus pull-to-refresh.

Rules

/api/v1/rules — both recording and alerting rules, grouped as Prometheus groups them, with each rule’s state, its expression, and its evaluation health.

Two things this is good for on a phone:

  • checking what an alert actually means — the expression is right there, so you can see the threshold you are being paged about without opening the rules repository;
  • spotting a rule whose evaluation is failing, which is why a dashboard has been suspiciously quiet.

From either screen, the query explorer is one section away when you want to run the expression yourself over a window.

Back to Prometheus.