`mc ping`

语法

Themc ping该命令对指定目标执行存活检查。

EXAMPLE

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

mc ping play --count 5

该命令对部署执行 ping 操作alias play经过五个周期。输出结果类似于以下内容：

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

SYNTAX

该命令具有以下语法：

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

Brackets[]表示可选参数。
共享同一行的参数是相互依赖的。
使用竖线分隔的参数|操作符是互斥的。

将示例复制到文本编辑器中，根据需要修改，然后在终端/Shell中运行命令。

参数

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

--count

可选

指定执行检查的次数。

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

--error-count

可选

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

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

mc ping TARGET -e 5

--exit: 可选

版本 RELEASE.2023-05-30T22-41-38Z 中的新增功能。

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

--interval

可选

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

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

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

Note

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

全局标志

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

示例

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

以下命令为别名为的部署发送活跃度检查myminio五次，输出每次检查的结果，然后结束。

mc ping myminio --count 5

重复发送活跃度检查，每次请求间隔5分钟

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

mc ping myminio --interval 300

当错误计数大于20时结束活跃度检查

以下命令将持续发送活跃度检查，直到遇到20个错误：

mc ping myminio --error-count 20