mc admin scanner trace
说明
mc admin scanner trace 命令会显示目标 MinIO 部署上发生的 scanner 相关 API 操作。
仅在 MinIO 部署上使用 mc admin
MinIO 不支持将 mc admin 命令用于其他 S3 兼容服务， 无论这些服务声称与 MinIO 部署具有何种兼容性。
以下示例返回 myminio 部署上与 scanner 相关的 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
mc-cmd
Required
要显示其 scanner API 操作的 MinIO 部署的 alias。
--filter-request
mc-cmd
Optional
跟踪请求大小大于指定 --filter-size 值的 scanner 操作或调用。
必须 与 --filter-size 标志配合使用。
--filter-response
mc-cmd
Optional
跟踪响应大小大于指定 --filter-size 值的 scanner 操作或调用。
必须 与 --filter-size 标志配合使用。
--filter-size
mc-cmd
Optional
将输出过滤为请求大小或响应大小大于指定大小的条目。
必须与 --filter-request 或 --filter-response 标志之一配合使用。
有效单位包括：
| 后缀 | 单位大小 |
|---|---|
k | KB（Kilobyte，1000 Bytes） |
m | MB（Megabyte，1000 Kilobytes） |
g | GB（Gigabyte，1000 Megabytes） |
t | TB（Terabyte，1000 Gigabytes） |
ki | KiB（Kibibyte，1024 Bytes） |
mi | MiB（Mebibyte，1024 Kibibytes） |
gi | GiB（Gibibyte，1024 Mebibytes） |
ti | TiB（Tebibyte，1024 Gibibytes） |
--funcname
mc-cmd
Optional
返回与输入函数名对应的调用。
--node
mc-cmd
Optional
返回指定服务器的调用。
--path
mc-cmd
Optional
返回指定路径的调用。
--response-duration
mc-cmd
Optional
跟踪响应持续时间大于指定值的调用。
--verbose, -v
mc-cmd
Optional
返回详细输出。
全局标志
此命令支持 全局标志 中的任意选项。
示例
监控所有 scanner API 操作
使用 mc admin scanner trace 监控别名为 myminio 的 MinIO 部署上的 scanner API 操作：
mc admin scanner trace myminio
显示特定路径的 scanner 跟踪
使用 mc admin scanner trace 监控别名为 myminio 的部署上路径 my-bucket/my-prefix/* 的 API 操作：
mc admin scanner trace --path my-bucket/my-prefix/* myminio
显示 scanObject 函数的 scanner API 操作
监控 myminio 部署上 scanObject 函数的 scanner 活动：
mc admin scanner trace --funcname=scanner.ScanObject myminio
显示大于 1MB 的 scanner 操作请求
使用 mc admin scanner trace 监控 myminio 部署上大于 1MB 的请求：
mc admin scanner trace --filter-request --filter-size 1MB myminio
显示大于 1MB 的 scanner 操作响应
使用 mc admin scanner trace 监控较大的响应大小：
mc admin scanner trace --filter-response --filter-size 1MB myminio
显示持续超过五毫秒的 scanner 操作
使用 mc admin scanner trace 监控耗时较长的操作：
mc admin scanner trace --response-duration 5ms myminio
本页部分内容改编自 MinIO 对象存储文档，© 2020–至今 MinIO, Inc.，依据 CC BY 4.0 授权，由 Silo 项目转换与维护。归属与署名
本页为非官方中文翻译。如与英文原文有出入，以英文原文为准。