文档基于2025-10-10日社区最终版构建     
切换到英文版    进入演示系统    进入交流社区

MinIO Documentation

mc admin scanner trace

描述

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

使用mc admin仅限 MinIO 部署

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

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

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]
  • Brackets[]表示可选参数。

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

  • 使用竖线分隔的参数|操作符是互斥的。

将示例复制到文本编辑器中,根据需要修改,然后在终端/Shell中运行命令。

参数

ALIAS
必需

The别名要显示其信息的 MinIO 部署扫描仪API 操作。

--filter-request
可选

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

必须可与...一起使用--filter-sizeflag.

--filter-response
可选

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

必须可与...一起使用--filter-sizeflag.

--filter-size
可选

筛选输出以获取请求大小或响应大小大于指定大小的内容。

必须与以下任一配合使用--filter-request or --filter-responseflag.

有效单位包括:

后缀

单元尺寸

k

KB (Kilobyte, 1000 Bytes)

m

MB (兆字节,1000千字节)

g

GB (Gigabyte,1000 Megabytes)

t

TB (太字节,1000 GB)

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监控扫描仪对别名为 `minio` 的 MinIO 部署的 API 操作myminio:

mc admin scanner trace myminio

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

使用mc admin scanner trace监控该路径的API操作my-bucket/my-prefix/*关于部署在myminioalias:

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

显示扫描仪 API 操作scanObjectfunction

监控扫描仪活动scanObject functionmyminio部署:

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

显示扫描器操作请求大于1MB在尺寸上

使用mc admin scanner trace监控大于a的请求1MBmyminio部署:

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