Back to websiteSample workspace with illustrative data. Start a free trial to see your own.Sign in
Sample data

Alert Rules

Rules watch one service each and judge a window of requests. Alerts are what rules produce. Declared incidents are written by people and are kept apart.

Loading alert rules

2 rules firing, 1 cannot judge yet

kyc-verify has been over its line since 13:55 GMT and fx-gateway since 14:04 GMT. The apache-httpd rule has seen 5 of the 10 requests it needs, so it is not judging. That is not the same as healthy.

All rules last evaluated 14:07 GMT A request is an entry span (server, consumer, or a root span) with health probes excluded. A failed request is a distinct trace with an error span in that service, never more than the requests. Rules, Overview, Services and Query Studio all use this rule.
  • 2Firing
  • 1OK
  • 1Not enough traffic
  • 1Paused

No rules yet, so nothing is watching

Until you add a rule, Onyx cannot raise an alert for you. Silence on this page does not mean your services are healthy. Declared incidents still appear in their own tab.

Rules

One service per rule. Fired in 24 h counts alerts that started.
Alert rules, one row per rule
NameScopeConditionStateLast evaluatedFired in 24 hActions
Failed requests above 5%, 5 min kyc-verify

More than 5% of requests fail over 5 minutes. Needs at least 10 requests before it judges.

failed_pct(5m) > 5 and requests(5m) >= 10
FiringCritical, since 13:55 GMT31 of 118 failed (26.3%)
14:07 GMT 1 Open in Query Studio
Latency p95 above 450 ms fx-gateway

p95 latency is above 450 ms over 5 minutes. Needs at least 10 requests before it judges.

p95_ms(5m) > 450 and requests(5m) >= 10
FiringWarning, since 14:04 GMTp95 468 ms now
14:07 GMT 2 Open in Query Studio
Failed requests above 5%, 5 min rate-engine

More than 5% of requests fail over 5 minutes. Needs at least 10 requests before it judges.

failed_pct(5m) > 5 and requests(5m) >= 10
OKJudged, under the line2 of 598 failed (0.33%)
14:07 GMT 1 Open in Query Studio
Failed requests above 5%, 5 min apache-httpd

More than 5% of requests fail over 5 minutes. Needs at least 10 requests before it judges.

failed_pct(5m) > 5 and requests(5m) >= 10
Not enough traffic
5 of the 10 requests needed
Not judging yet, so this is not healthy. It is unknown. All 5 requests seen so far failed.
14:07 GMTno verdict Not available, the rule is not judging Open in Query Studio
Settlement backlog over 15 min settlement-worker

The oldest unsettled batch has waited more than 15 minutes.

oldest_pending_min > 15
PausedPaused by ops, Sun 4 Oct, 17:40 GMT. Not evaluating, so it cannot fire.
Sun 17:40 GMT Not available, the rule is paused Open in Query Studio
Rules are evaluated every minute. A rule that cannot judge shows Not enough traffic or Paused, never OK.

No alert rules yet

A rule watches one service and tells you when a signal crosses a line you choose. Pick a starter below to fill in the form for you, or begin with a blank rule. Every rule waits for a minimum of 10 requests by default, so a quiet service shows Not enough traffic instead of a false alarm or a false all-clear.

Starter rules

Failed requests above 5%, 5 min

Catches a service that starts failing. Waits for 10 requests in the window before it judges.

failed_pct(5m) > 5 and requests(5m) >= 10

Latency p95 above 450 ms

Catches a service that is up but slow. Useful at the edge, where customers feel it first.

p95_ms(5m) > 450 and requests(5m) >= 10

Slow leak: failed requests above 2%, 30 min

Catches a small, steady failure rate that a 5 minute rule would miss.

failed_pct(30m) > 2 and requests(30m) >= 10