健康檢查 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 伺服器在線上，以滿足基於已配置的Erasure Code 同位檢查的寫入仲裁要求。請考慮使用以下指標之一配置 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 伺服器在線上，以滿足基於已配置的Erasure Code 同位檢查的讀取仲裁要求。請考慮使用 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 伺服器在線上，以滿足基於已配置的Erasure Code 同位檢查的讀取和寫入仲裁要求。請考慮使用 minio_cluster_nodes_offline_total 指標配置 Prometheus 警報，以偵測一個或多個 MinIO 節點是否離線。