健康檢查 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 服務無法使用 表示叢集目前不具備寫入仲裁。

僅憑健康檢查探測無法確定 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 服務無法使用 表示叢集目前不具備讀取仲裁。

僅憑健康檢查探測無法確定 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 伺服器在線上，以滿足基於已配置的糾刪碼同位的讀取和寫入仲裁需求。請考慮使用 minio_cluster_nodes_offline_total 指標配置 Prometheus 警報，以偵測是否有一個或多個 MinIO 節點離線。