Elastic Docs ›Kibana Guide ›REST API ›Alerting APIs
« Find rules API Get rule API »

Get alerting framework health APIedit

Retrieve the health status of the alerting framework.

For the most up-to-date API details, refer to the open API specification. For a preview, check out Alert and rule APIs.

Requestedit

GET <kibana host>:<port>/api/alerting/_health

GET <kibana host>:<port>/s/<space_id>/api/alerting/_health

Prerequisitesedit

You must have read privileges for the Management > Stack Rules feature or for at least one of the Analytics > Discover, Analytics > Machine Learning, Observability, or Security features.

Path parametersedit

space_id
(Optional, string) An identifier for the space. If space_id is not provided in the URL, the default space is used.

Response codesedit

200
Indicates a successful call.

Examplesedit

Retrieve the health status of the alerting framework:

GET api/alerting/_health

The API returns the following:

{
   "is_sufficiently_secure":true, 
   "has_permanent_encryption_key":true, 
   "alerting_framework_health":{ 
      "decryption_health":{
         "status":"ok",
         "timestamp":"2022-06-21T21:46:15.023Z"
      },
      "execution_health":{
         "status":"ok",
         "timestamp":"2022-06-21T21:46:15.023Z"
      },
      "read_health":{
         "status":"ok",
         "timestamp":"2022-06-21T21:46:15.023Z"
      }
   }
}

is_sufficiently_secure is false when security is enabled, but TLS is not.

has_permanent_encryption_key is false when the encrypted saved object plugin does not have a permanent encryption key.

alerting_framework_health has three substates that identify the health of the alerting framework: decryption_health, execution_health, and read_health. decryption_health returns the timestamp and status of the rule decryption: ok, warn or error. execution_health returns the timestamp and status of the rule execution: ok, warn or error. read_health returns the timestamp and status of the rule reading events: ok, warn or error.
« Find rules API Get rule API »