---
title: "GET /v2/GetClusterHealth"
method: GET
path: "/v2/GetClusterHealth"
tags: ["Cluster"]
---

# GET /v2/GetClusterHealth

`GET /v2/GetClusterHealth`

Returns the global status of the cluster, the number of connected nodes (over the number of known ones), the number of healthy storage nodes (over the declared ones), and the number of healthy partitions (over the total).

## Response `200`

Cluster health report

- GetClusterHealthResponse
  - `connectedNodes` integer, required — the number of nodes this Garage node currently has an open connection to
  - `knownNodes` integer, required — the number of nodes this Garage node has had a TCP connection to since the daemon started
  - `partitions` integer, required — the total number of partitions of the data (currently always 256)
  - `partitionsAllOk` integer, required — the number of partitions for which we are connected to all storage nodes responsible of storing it
  - `partitionsQuorum` integer, required — the number of partitions for which a quorum of write nodes is available
  - `status` string, required — One of `healthy`, `degraded` or `unavailable`: - `healthy`: Garage node is connected to all storage nodes - `degraded`: Garage node is not connected to all storage nodes, but a quorum of write nodes is available for all partitions - `unavailable`: a quorum of write nodes is not available for some partitions
  - `storageNodes` integer, required — the number of storage nodes currently registered in the cluster layout
  - `storageNodesUp` integer, required — the number of storage nodes to which a connection is currently open

---

[API](https://skmtc.dev/deuxfleurs/apis/garage-administration-api.md) · [All operations](https://skmtc.dev/deuxfleurs/apis/garage-administration-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/deuxfleurs/garage-administration-api/revisions/07ffb2d0febb/schema)