`mc support perf`

Changed in version RELEASE.2022-07-24T02-25-13Z: mc support perf 替代 mc admin speedtest 命令。

需要完成 SUBNET 注册

mc support 命令面向已在 MinIO SUBNET 注册的 MinIO 部署设计，以确保诊断和性能测试获得最佳结果。未注册 SUBNET 的部署无法使用 mc support 命令。

描述

使用 mc support perf 命令可检查 S3 API（读/写）、网络 IO 和存储（磁盘读/写）的性能。

测试结果可为部署在 S3 GET 和 PUT 请求下的性能提供总体参考，并识别潜在瓶颈。如需更完整的性能测试，建议结合预发应用环境中的负载测试与 MinIO WARP S3 基准测试工具。

mc support perf 包含以下子命令

drive

测量 MinIO 部署中磁盘的速度。

mc support perf drive 在测试期间会临时暂停 S3 API 调用。命令运行期间，传入请求会保存在队列中。命令完成或结束后，MinIO 会处理排队请求并恢复正常运行。
object

测量集群中对象读写速度。
net

测量所有节点的网络吞吐量。

mc support perf net 在测试期间会临时暂停 S3 API 调用。命令运行期间，传入请求会保存在队列中。命令完成或结束后，MinIO 会处理排队请求并恢复正常运行。
client

测量到客户端的网络吞吐量。
site-replication

测量站点复制操作的速度。

需要完成 SUBNET 注册

mc support 命令面向已在 MinIO SUBNET 注册的 MinIO 部署设计，以确保诊断和性能测试获得最佳结果。未注册 SUBNET 的部署无法使用 mc support 命令。

示例

测量对象速度

在别名 minio1 上，测量某个对象的 S3 读写性能。 MinIO 会自动调优并发度，以获得最大吞吐量和 IOPS（Input/Output Per Second）。

mc support perf object minio1

在指定时长内测量指定大小对象的速度

在别名 minio1 上，对大小为 128MiB 的对象运行 20 秒的 S3 读写性能测试。 MinIO 会自动调优并发度以获得最大吞吐量。

mc support perf object minio1 --duration 20s --size 128MiB

使用默认规格测试所有节点上的全部磁盘速度

在别名为 minio1 的集群上，对所有节点上的所有磁盘执行读写性能测量。该命令未指定 blocksize，因此使用默认值 4MiB。

mc support perf drive minio1

使用自定义规格测试磁盘速度

在别名为 minio1 的集群上执行磁盘读写性能测量，指定 blocksize 为 64KiB，且每个磁盘读写数据量为 2GiB。

mc support perf drive minio1 --blocksize 64KiB --filesize 2GiB

测试网络吞吐量

在别名为 minio1 的集群上运行网络吞吐量测试。

mc support perf net minio1

测试站点复制速度

测试站点 minio1 到其他已配置对等站点的站点复制操作速度。

mc support perf site-replication minio1

语法

mc support perf drive

测量集群中磁盘的读写速度。

mc [GLOBAL FLAGS] support perf drive   \
                [--concurrent]         \
                [--verbose, -v]        \
                [--filesize]           \
                [--blocksize]          \
                [--serial]             \
                [--airgap]             \
                ALIAS

mc support perf object

测量集群中对象读写的 S3 性能。

mc [GLOBAL FLAGS] support perf object  \
                [--size]               \
                [--concurrent]         \
                [--verbose, -v]        \
                [--airgap]             \
                ALIAS

mc support perf net

测量集群中所有节点的网络吞吐量。

mc [GLOBAL FLAGS] support perf net  \
                [--concurrent]      \
                [--verbose, -v]     \
                [--serial]          \
                [--airgap]          \
                ALIAS

mc support perf client

测量运行 MinIO Client 的本地设备到服务器的网络吞吐量。

mc [GLOBAL FLAGS] support perf client  \
                --duration             \
                [--verbose, -v]        \
                [--airgap]             \
                ALIAS

mc support perf site-replication

测量从指定 ALIAS 到其他已配置对等站点的站点复制操作速度。

mc [GLOBAL FLAGS] support perf site-replication \
                  --duration                    \
                  [--verbose, -v]               \
                  ALIAS

参数

--airgap

Optional

用于无法通过网络访问 SUBNET 的环境（例如 airgapped、受防火墙限制或类似配置）。

如果部署本身是 airgapped，但你使用 minio client 的本地设备可以访问网络，则无需使用 --airgap 标志。

--size

Optional

适用于 object 命令。

指定上传和下载性能测试所使用的对象大小。

未指定时，默认值为 64MiB。

使用 --size <value>，其中 <value> 为数字加存储单位 KiB、MiB 或 GiB。

--concurrent

Optional

适用于 drive、object 和 net 命令。

指定每台服务器用于测试的并发请求数。

未指定时，默认值为 32。

使用 --concurrent <value>，其中 <value> 为数字。

--verbose, -v

Optional

适用于 drive、object 和 net 命令。

在输出中显示每台服务器的统计信息。

--filesize

Optional

适用于 drive 命令。

指定每个磁盘读取或写入的数据总量。

未指定时，默认值为 1GiB。

使用 --filesize <value>，其中 <value> 为数字和存储单位 KiB、MiB 或 GiB。

--blocksize

Optional

适用于 drive 命令。

指定读写块大小。

未指定时，默认值为 4MiB。

使用 --filesize <value>，其中 <value> 为数字和存储单位，使用标准存储单位缩写。

--serial

Optional

适用于 drive 和 net 命令。

逐个对磁盘执行性能测试。

ALIAS

Required

适用于 drive、object、net 和 client 命令。

MinIO 部署的 alias。

--duration

Required

适用于 client 命令。

执行测试的时长（秒）。时间不能为 0 或负数。

全局标志

此命令支持全局标志中的任意选项。