文档

mc admin profile

Note

mc RELEASE.2023-04-06T16-51-10Z 起,该命令已由 mc support profile 取代。

描述

mc admin profile 命令会生成用于调试的性能分析数据。

仅在 MinIO 部署上使用 mc admin

MinIO 不支持将 mc admin 命令用于其他 S3 兼容服务, 无论这些服务声称与 MinIO 部署具有何种兼容性。

性能分析数据格式

mc admin profile 会生成一个 ZIP 归档文件 profile.zip, 其中包含一个或多个 .pprof 文件。使用 pprof go 工具读取这些性能分析数据。

示例

单个资源的性能分析数据

使用 mc admin profile start 并结合 type 标志开始对该资源进行性能分析:

mc admin profile start --type "TYPE" ALIAS
  • ALIAS 替换为 MinIO 主机的 alias

  • TYPE 替换为要分析的资源类型。

使用 mc admin profile stop 停止对指定资源的性能分析并输出结果:

mc admin profile stop

该命令会将性能分析数据输出为 profile.zip

多个资源的性能分析数据

使用 mc admin profile start 并结合 type 标志开始对这些资源进行性能分析:

mc admin profile start --type "TYPE,[TYPE...]" ALIAS
  • ALIAS 替换为 MinIO 主机的 alias

  • TYPE 替换为要分析的资源类型。 多个资源类型请使用逗号分隔列表指定。

使用 mc admin profile stop 停止对指定资源的性能分析并输出结果:

mc admin profile stop

该命令会将性能分析数据输出为 profile.zip

语法

mc admin profile 的语法如下:

mc admin profile SUBCOMMAND

mc admin profile 支持以下子命令:

mc admin profile start

在目标 MinIO 部署上开始收集性能分析数据。该命令语法如下:

mc admin profile start [FLAGS] TARGET

mc admin profile start 支持以下参数:

TARGET

已配置 MinIO 部署的 alias,命令将从该部署收集性能分析数据。

type

TARGET MinIO 部署收集的性能分析数据类型。

将以下一个或多个支持的类型以逗号分隔列表形式指定:

  • cpu

  • mem

  • block

  • mutex

  • trace

  • threads

  • goroutines

省略时默认为 cpu,mem,block

mc admin profile stop

停止性能分析过程,并将收集的数据作为 profile.zip 返回。该 zip 文件包含一个或多个 .pprof 文件,可由 go pprof 等工具读取。

该命令语法如下:

mc admin profile stop TARGET

该命令支持以下参数:

TARGET

已配置 MinIO 部署的 alias,命令将从该部署返回可用的性能分析数据。