`mc ping`

语法

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

EXAMPLE

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

mc ping play --count 5

该命令对部署在 alias play 的目标进行了五轮ping操作。输出类似于以下内容：

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

SYNTAX

该命令具有以下语法：

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

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

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

参数

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

--count

Optional

指定执行检查的次数。

如果未指定，存活检查将持续执行，直到被停止。

--error-count

Optional

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

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

mc ping TARGET -e 5

--exit: Optional

在 RELEASE.2023-05-30T22-41-38Z 版本加入.

第一次检查成功后退出。

--interval

Optional

两次请求之间等待的时间长度，以秒为单位。

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

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

备注

对于分布式部署，其中您直接访问每个节点或容器的场景，请使用此选项。此标志在节点放置在服务后面时，例如负载均衡器后面，将不起作用。

全局标记

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

示例

5 个请求的返回延迟和活跃度

以下命令对具有别名 myminio 的部署发送五次存活检查，输出每次检查的结果，然后结束。

mc ping myminio --count 5

重复发送活性检查，每个请求之间等待 5 分钟

以下命令使用5分钟（300秒）的间隔发送持续的存活检查请求。

mc ping myminio --interval 300

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

以下命令将连续发送存活检查，直到遇到20次错误为止：

mc ping myminio --error-count 20

商业支持购买咨询