健康检查 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

将 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 节点是否离线。