健康檢查 API

MinIO 公開未經身份驗證的端點，用於探測節點正常運行時間和叢集高可用性，以便進行簡單的健康檢查。這些端點會傳回 HTTP 狀態代碼，指示基礎資源是否正常或滿足讀取/寫入仲裁。MinIO 不會透過這些端點公開其他資料。

節點存活度

使用以下端點測試 MinIO 伺服器是否在線上

curl -I https://minio.example.net:9000/minio/health/live

將 https://minio.example.net:9000 替換為要檢查的 MinIO 伺服器的 DNS 主機名稱。

回應代碼 200 OK 表示 MinIO 伺服器在線上且功能正常。任何其他 HTTP 代碼都表示連線伺服器時出現問題，例如暫時性網路問題或潛在停機。

單獨的健康檢查探測無法判斷 MinIO 伺服器是否離線，只能判斷目前主機是否無法連線到伺服器。請考慮使用 minio_cluster_nodes_offline_total 指標配置 Prometheus 警示，以偵測是否有一個或多個 MinIO 節點離線。

叢集寫入仲裁

使用以下端點測試 MinIO 叢集是否具有寫入仲裁

curl -I https://minio.example.net:9000/minio/health/cluster

將 https://minio.example.net:9000 替換為要檢查的 MinIO 叢集中節點的 DNS 主機名稱。對於使用負載平衡器管理傳入連線的叢集，請指定負載平衡器的主機名稱。

回應代碼 200 OK 表示 MinIO 叢集有足夠的 MinIO 伺服器在線上以滿足寫入仲裁。回應代碼 503 Service Unavailable 表示叢集目前沒有寫入仲裁。

單靠健康檢查探針無法判斷 MinIO 伺服器是否離線或正常處理寫入操作，它只能判斷是否有足夠的 MinIO 伺服器在線上，以滿足根據配置的糾刪碼同位所要求的寫入仲裁。建議使用以下指標之一來設定 Prometheus 警報，以偵測 MinIO 集群上的潛在問題或錯誤。

minio_cluster_nodes_offline_total，用於在一個或多個 MinIO 節點離線時發出警報。
minio_node_drive_free_bytes，用於在集群的可用磁碟空間不足時發出警報。

集群讀取仲裁

使用以下端點來測試 MinIO 集群是否具有讀取仲裁

curl -I https://minio.example.net:9000/minio/health/cluster/read

回應碼 200 OK 表示 MinIO 集群有足夠的 MinIO 伺服器在線上以滿足讀取仲裁。回應碼 503 Service Unavailable 表示該集群目前沒有讀取仲裁。

單靠健康檢查探針無法判斷 MinIO 伺服器是否離線或正常處理讀取操作，它只能判斷是否有足夠的 MinIO 伺服器在線上，以滿足根據配置的糾刪碼同位所要求的讀取仲裁。建議使用 minio_cluster_nodes_offline_total 指標來設定 Prometheus 警報，以偵測是否有一個或多個 MinIO 節點離線。

集群維護檢查

使用以下端點來測試，如果指定的 MinIO 伺服器因維護而關閉，MinIO 集群是否可以維持讀取和寫入

curl -I https://minio.example.net:9000/minio/health/cluster?maintenance=true

回應碼 200 OK 表示 MinIO 集群有足夠的 MinIO 伺服器在線上以滿足寫入仲裁。回應碼 412 Precondition Failed 表示如果該 MinIO 伺服器離線，集群將失去仲裁。

單靠健康檢查探針無法判斷 MinIO 伺服器是否離線，它只能判斷在將節點關閉進行維護後，是否有足夠的 MinIO 伺服器在線上，以滿足根據配置的糾刪碼同位所要求的讀取和寫入仲裁。建議使用 minio_cluster_nodes_offline_total 指標來設定 Prometheus 警報，以偵測是否有一個或多個 MinIO 節點離線。