`mc ping`

语法

The mc ping 命令对指定目标执行存活性检查。

示例

以下命令向目标发送响应请求，并输出响应的最小值、最大值、平均值和往返时间，以及处理请求时遇到的错误数量。

mc ping play --count 5

该命令对 alias play 处的部署执行了 5 次 ping 操作。输出类似于以下内容

https://play.min.io   min=213.00ms   max=213.00ms   average=213.00ms   errors=0   roundtrip=213.00ms
https://play.min.io   min=67.15ms    max=213.00ms   average=140.07ms   errors=0   roundtrip=67.15ms
https://play.min.io   min=67.15ms    max=213.00ms   average=115.85ms   errors=0   roundtrip=67.41ms
https://play.min.io   min=61.26ms    max=213.00ms   average=102.20ms   errors=0   roundtrip=61.26ms
https://play.min.io   min=61.26ms    max=213.00ms   average=95.03ms    errors=0   roundtrip=66.36ms

语法

该命令具有以下语法

mc [GLOBALFLAGS] ping                       \
                 TARGET                     \
                 [--count, -c value]        \
                 [--error-count, -e value]  \
                 [--interval, -i value]     \
                 [--distributed, -a value]

方括号 [] 表示可选参数。
共享同一行的参数是相互依赖的。
使用管道 | 运算符分隔的参数是相互排斥的。

将示例复制到文本编辑器中，并在终端/shell 中运行该命令之前根据需要进行修改。

参数

TARGET: 必需
命令应运行的完整路径别名或前缀。

--count

可选

指定执行检查的次数。

如果未指定，则活动性检查将持续执行，直到停止。

--error-count

可选

指定在退出之前接收的错误数量。

例如，要接收五个错误后停止 ping 进程，请使用

mc ping TARGET -e 5

--exit: 可选

RELEASE.2023-05-30T22-41-38Z 版本新增。

在第一次成功检查后退出。

--interval

可选

请求之间等待的时间长度（以秒为单位）。

默认情况下，命令在请求之间等待 1 秒。

--distributed: 可选
向 MinIO 集群中的所有服务器发送请求。

注意

在您直接访问每个节点或 Pod 的分布式部署中使用此选项。当节点位于服务（如负载均衡器）后面时，此标志不起作用。

全局标志

此命令支持任何全局标志。

示例

返回 5 个请求的延迟和活动性

以下命令针对使用别名 myminio 的部署发送 5 次活动性检查，输出每次检查的结果，然后结束。

mc ping myminio --count 5

以每 5 分钟等待一次的间隔重复发送活动性检查

以下命令以每次请求之间间隔 5 分钟（300 秒）发送连续的活动性检查请求。

mc ping myminio --interval 300

结束错误计数大于 20 的活动性检查

以下命令发送连续的活动性检查，直到遇到 20 个错误。

mc ping myminio --error-count 20