文档

MinIO Object Storage

mc ping

语法

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

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

mc ping play --count 5

该命令对 alias play 对应的部署执行五次 ping。 输出类似如下：

1: https://play.min.io   min=213.00ms   max=213.00ms   average=213.00ms   errors=0   roundtrip=213.00ms
2: https://play.min.io   min=67.15ms    max=213.00ms   average=140.07ms   errors=0   roundtrip=67.15ms
3: https://play.min.io   min=67.15ms    max=213.00ms   average=115.85ms   errors=0   roundtrip=67.41ms
4: https://play.min.io   min=61.26ms    max=213.00ms   average=102.20ms   errors=0   roundtrip=61.26ms
5: 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
Required

命令应运行所在位置的 alias 或前缀完整路径。

--count
Optional

指定执行检查的次数。

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

--error-count
Optional

指定在退出前允许出现的错误次数。

例如，要在出现五次错误后停止 ping 进程，请使用：

mc ping TARGET -e 5
--exit
Optional

New in version RELEASE.2023-05-30T22-41-38Z.

在首次检查成功后退出。

--interval
Optional

指定请求之间的等待时间（秒）。

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

--distributed
Optional

向 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
本作品采用 Creative Commons Attribution 4.0 International License. 授权。 2020-Present, MinIO, Inc. Creative Commons 许可证