文件

健康檢查 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 伺服器在線上以滿足基於已設定的抹除碼同位的寫入仲裁要求。請考慮使用以下指標之一設定 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

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

回應碼 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

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

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

健康檢查探針本身無法判斷 MinIO 伺服器是否離線,僅能判斷在節點因維護而下線後,是否有足夠的 MinIO 伺服器在線上以滿足基於已設定的糾刪碼同位的讀取和寫入仲裁要求。請考慮使用 minio_cluster_nodes_offline_total 指標配置 Prometheus 警報,以檢測是否有一個或多個 MinIO 節點離線。