Document Kibana Alert Statuses

[stefnestor]

Kibana version: 7.12-7.13

Howdy! It appears there is a defined categorization of Kibana Alert statuses from #51099 by @pmuellr on #75553 : [active, error, ok, pending, unknown]

However I'm unable to find their definitions in the documentation (expected somewhere around here or here). I may just be blind (if so, sorry in advance).

I'm particularly interested in the difference between active & ok, error & unknown, and what pending means in general.

[elasticmachine]

Pinging @elastic/kibana-docs (Team:Docs)

[elasticmachine]

Pinging @elastic/kibana-alerting-services (Team:Alerting Services)

[pmuellr]

Ya, we need to doc this. I'm going to start pointing folks asking to this issue, and here's a quick summary:

• active - the conditions for the rule have been met, and the associated actions should be invoked
• ok - the conditions for the rule had previously been met, but no longer are being met. This will change to recovered in a future release (see PR referenced below).
• error - an error was encountered when the rule was executed
• pending - the rule has not yet executed; it was either just created, or just enabled after being disabled
• unknown - fallback internally when calculating the status; if this is observed, there is likely some kind of problem with the alerting code

Some improvements currently merged to 7.x, so hopefully available in 7.14: #98135