`mc ping`

語法

mc ping 命令會對指定的目標執行活躍度檢查。

範例

以下程式碼會向目標傳送回應請求，並輸出回應的最小、最大、平均和往返時間，以及處理請求時遇到的錯誤次數。

mc ping play --count 5

該命令會對 alias play 上的部署進行五個週期的 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]

方括號 [] 表示選用參數。
同一行的參數彼此相依。
使用管道符號 | 分隔的參數是互斥的。

將範例複製到文字編輯器中，並在終端機/命令列中執行命令之前根據需要進行修改。

參數

TARGET: 必要
命令應執行所在位置的別名或前綴的完整路徑。

--count

可選

指定執行檢查的次數。

如果未指定，存活檢查將持續執行直到停止。

--error-count

可選

指定在退出前要接收的錯誤次數。

例如，要在收到五個錯誤後停止 ping 程序，請使用

mc ping TARGET -e 5

--exit: 可選

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

在第一次成功檢查後退出。

--interval

可選

請求之間等待的時間長度，以秒為單位。

預設情況下，命令在請求之間等待 1 秒。

--distributed: 可選
將請求發送到 MinIO 叢集中的所有伺服器。

注意

對於您可以直接存取每個節點或 Pod 的分散式部署，請使用此選項。當節點放置在服務（例如負載平衡器）後面時，此標誌不起作用。

全域標誌

此命令支援任何全域標誌。

範例

傳回 5 個請求的延遲和存活狀態

以下命令會向別名為 myminio 的部署傳送五次存活狀態檢查，輸出每次檢查的結果，然後結束。

mc ping myminio --count 5

重複傳送存活狀態檢查，每次請求之間等待 5 分鐘

以下命令會傳送連續的存活狀態檢查請求，每次請求之間間隔 5 分鐘（300 秒）。

mc ping myminio --interval 300

當錯誤計數大於 20 時結束存活狀態檢查

以下命令會傳送連續的存活狀態檢查，直到遇到 20 個錯誤

mc ping myminio --error-count 20