2019-07-05 17:50:48 +08:00
---
title: Management API
2021-06-22 06:59:31 +08:00
sort_rank: 8
2019-07-05 17:50:48 +08:00
---
2020-10-27 17:50:37 +08:00
Prometheus provides a set of management APIs to facilitate automation and integration.
2019-07-05 17:50:48 +08:00
2025-05-29 03:37:27 +08:00
## Health check
2019-07-05 17:50:48 +08:00
```
GET /-/healthy
2022-08-17 03:06:26 +08:00
HEAD /-/healthy
2019-07-05 17:50:48 +08:00
```
This endpoint always returns 200 and should be used to check Prometheus health.
2025-05-29 03:37:27 +08:00
## Readiness check
2019-07-05 17:50:48 +08:00
```
GET /-/ready
2022-08-17 03:06:26 +08:00
HEAD /-/ready
2019-07-05 17:50:48 +08:00
```
This endpoint returns 200 when Prometheus is ready to serve traffic (i.e. respond to queries).
2025-05-29 03:37:27 +08:00
## Reload
2019-07-05 17:50:48 +08:00
```
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.
2019-09-28 21:38:51 +08:00
Alternatively, a configuration reload can be triggered by sending a `SIGHUP` to the Prometheus process.
2019-07-05 17:50:48 +08:00
2025-05-29 03:37:27 +08:00
## Quit
2019-07-05 17:50:48 +08:00
```
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.
2019-09-28 21:38:51 +08:00
Alternatively, a graceful shutdown can be triggered by sending a `SIGTERM` to the Prometheus process.