文档

mc admin scanner trace

说明

mc admin scanner trace 命令显示 扫描器 在目标 MinIO 部署上发生的特定 API 操作。

仅在 MinIO 部署上使用 mc admin

MinIO 不支持将 mc admin 命令与其他 S3 兼容服务一起使用,无论它们声称与 MinIO 部署的兼容性如何。

以下示例将返回与 myminio 部署上的扫描器相关的 API 操作列表。

mc admin scanner trace myminio

该命令具有以下语法

mc admin scanner trace ALIAS
                       [--filter-request]            \
                       [--filter-response]           \
                       [--filter-size <value>]       \
                       [--funcname <value>]          \
                       [--node <value>]              \
                       [--path <value>]              \
                       [--response-duration <value>] \
                       [--verbose, -v]
  • 方括号 [] 表示可选参数。

  • 共享一行参数是相互依赖的。

  • 使用管道 | 运算符分隔的参数是相互排斥的。

将示例复制到文本编辑器中,并在终端/shell 中运行命令之前根据需要进行修改。

参数

ALIAS
必需

用于显示 MinIO 部署的 别名,以便显示 扫描器 API 操作。

--filter-request
可选

跟踪请求大小大于指定 --filter-size 值的扫描器操作或调用。

**必须**与 --filter-size 标志一起使用。

--filter-response
可选

跟踪响应大小大于指定 --filter-size 值的扫描器操作或调用。

**必须**与 --filter-size 标志一起使用。

--filter-size
可选

将输出过滤到请求大小或响应大小大于指定大小的值。

必须与 --filter-request--filter-response 标志一起使用。

有效单位包括

后缀

单位大小

k

KB(千字节,1000 字节)

m

MB(兆字节,1000 千字节)

g

GB(吉字节,1000 兆字节)

t

TB(太字节,1000 吉字节)

ki

KiB(Kibibyte,1024 字节)

mi

MiB(Mebibyte,1024 Kibibytes)

gi

GiB(Gibibyte,1024 Mebibytes)

ti

TiB(Tebibyte,1024 Gibibytes)

--funcname
可选

返回输入函数名的调用。

--node
可选

返回指定服务器的调用。

--path
可选

返回指定路径的调用。

--response-duration
可选

跟踪响应持续时间大于指定值的调用。

--verbose, -v
可选

返回详细输出。

全局标志

此命令支持任何 全局标志

示例

监控所有扫描器 API 操作

使用 mc admin scanner trace 监控别名为 myminio 的 MinIO 部署上的 扫描器 API 操作。

mc admin scanner trace myminio

显示特定路径的扫描器跟踪

使用 mc admin scanner trace 监控别名为 myminio 的部署上的路径 my-bucket/my-prefix/* 的 API 操作。

 mc admin scanner trace --path my-bucket/my-prefix/* myminio

显示 scanObject 函数的扫描器 API 操作

监控别名为 myminio 的部署上的 scanObject 函数 的扫描器活动。

mc admin scanner trace --funcname=scanner.ScanObject myminio

显示大小大于 1MB 的扫描器操作请求

使用 mc admin scanner trace 监控别名为 myminio 的部署上的大于 1MB 的请求。

mc admin scanner trace --filter-request --filter-size 1MB myminio

显示大小大于 1MB 的扫描器操作响应

使用 mc admin scanner trace 监控大型响应大小。

 mc admin scanner trace --filter-response --filter-size 1MB myminio

显示持续时间超过五毫秒的扫描器操作

使用 mc admin scanner trace 监控长时间操作。

 mc admin scanner trace --response-duration 5ms myminio