prometheus/docs/management_api.md
Marco Pracucci 2ccc48adc6 Documented /healthy, /ready and lifecycle API (#5737)
Signed-off-by: Marco Pracucci <marco.pracucci@spreaker.com>
2019-07-05 10:50:48 +01:00

51 lines
1,015 B
Markdown

---
title: Management API
sort_rank: 7
---
# Management API
Prometheus provides a set of management API to ease automation and integrations.
### Health check
```
GET /-/healthy
```
This endpoint always returns 200 and should be used to check Prometheus health.
### Readiness check
```
GET /-/ready
```
This endpoint returns 200 when Prometheus is ready to serve traffic (i.e. respond to queries).
### Reload
```
PUT /-/reload
POST /-/reload
```
This endpoint triggers a reload of the Prometheus configuration and rule files. It's disabled by default and can be enabled via the `--web.enable-lifecycle` flag.
An alternative way trigger a configuration reload is by sending a `SIGHUP` to the Prometheus process.
### Quit
```
PUT /-/quit
POST /-/quit
```
This endpoint triggers a graceful shutdown of Prometheus. It's disabled by default and can be enabled via the `--web.enable-lifecycle` flag.
An alternative way trigger a graceful shutdown is by sending a `SIGTERM` to the Prometheus process.