mc admin trace
说明
mc admin trace 命令显示目标 MinIO 部署上发生的 API 操作。
服务端兼容性
mcli admin 正式支持的目标服务端为 SILO。与未修改的上游 MinIO 保持尽最大努力兼容；仅具备通用 S3 兼容性并不提供这些管理 API。
示例
监控所有 API 操作
使用 mc admin trace 监控 MinIO 部署上的 API 操作：
查看返回 503 错误的调用
使用 mc admin trace 监控返回 503 Service Unavailable 错误的 API 操作：
查看指定路径的控制台跟踪
使用 mc admin trace 监控指定路径的活动：
查看响应大小大于 1Mb 的控制台跟踪
使用 mc admin trace 监控超过指定大小的响应：
查看请求操作时长大于 5ms 的控制台跟踪
使用 mc admin trace 监控耗时较长的操作：
语法
mc admin trace 的语法如下：
mc admin trace 支持以下参数：
TARGET
mc-cmd
指定已配置 MinIO 部署的 alias，用于监控其 API 操作。
--all, a
mc-cmd
返回 MinIO 部署上的所有流量，包括 MinIO 服务器之间的节点间流量。
--call
mc-cmd
仅跟踪匹配的客户端操作或调用类型。 例如，以下命令仅跟踪 scanner 类型的操作。
有效的调用类型包括：
batch-keyrotationbatch-replicationbootstrapdecommissionftphealingilminternalosrebalancereplication-resyncs3scannerstorage
如果未指定，MinIO 返回 s3 类型的调用。
--errors, e
mc-cmd
仅返回失败的 API 操作。
--filter-request
mc-cmd
跟踪请求大小大于指定 --filter-size 值的客户端操作或调用。
必须与 --filter-size 标志一起使用。
--filter-response
mc-cmd
跟踪响应大小大于指定 --filter-size 值的客户端操作或调用。
必须与 --filter-size 标志一起使用。
--filter-size
mc-cmd
过滤后的客户端操作或调用的大小限制。
必须与 --filter-request 或 --filter-response 标志之一一起使用。
有效单位包括：
| 后缀 | 单位大小 |
|---|---|
k |
KB（Kilobyte，1000 Bytes） |
m |
MB（Megabyte，1000 Kilobytes） |
g |
GB（Gigabyte，1000 Megabytes） |
t |
TB（Terrabyte，1000 Gigabytes） |
ki |
KiB（Kibibyte，1024 Bites） |
mi |
MiB（Mebibyte，1024 Kibibytes） |
gi |
GiB（Gibibyte，1024 Mebibytes） |
ti |
TiB（Tebibyte，1024 Gibibytes） |
--funcname
mc-cmd
返回输入函数名对应的调用。
--method
mc-cmd
返回指定 HTTP 方法的调用。
--node
mc-cmd
返回指定服务器的调用。
--path
mc-cmd
返回指定路径的调用。
--request-header
mc-cmd
返回与提供的请求头匹配的调用。
--request-query
mc-cmd
返回与提供的请求查询参数匹配的调用。
--response-duration
mc-cmd
跟踪响应时长大于指定值的调用。
--response-threshold 不是当前 mcli 支持的标志。请改用 --response-duration 5ms 筛选慢于 5 毫秒的调用。未指定该标志时，不会应用响应时长阈值。
--status-code
mc-cmd
返回指定 HTTP 状态码的调用。
--stats
mc-cmd
在当前跟踪会话期间，为每个被跟踪的函数调用累积聚合统计信息。
输出表包含以下列。
| 列 | 说明 |
|---|---|
Call |
捕获到的客户端操作或函数名称。 |
Count |
客户端操作或调用发生的次数。 |
RPM |
客户端操作或调用的每分钟速率（Rate Per Minute，RPM）。 |
Avg Time |
客户端操作或调用完成所需的平均时间。 |
Min Time |
客户端操作或调用完成所用的最短时间。 |
Max Time |
客户端操作或调用完成所用的最长时间。 |
Avg TTFB |
客户端操作或调用响应的平均首字节时间（Time To First Byte，TTFB）。 |
Max TTFB |
客户端操作或调用响应的最大首字节时间。 |
Avg Size |
客户端操作或调用响应的平均大小。 |
Errors |
因错误失败的客户端操作或调用数量。 |
RX Avg |
客户端操作或调用的平均接收字节数（Bytes Received，RX）。仅在值不为零（0）时显示。 |
TX AVG |
客户端操作或调用的平均发送字节数（Bytes Sent，TX）。仅在值不为零（0）时显示。 |
新增: RELEASE.2023-11-15T22-45-58Z
Avg TTFB 与 Max TTFB 统计列新增于 RELEASE.2023-11-15T22-45-58Z。
累积统计信息，例如名称、计数、持续时间、最短时间、最长时间、首字节时间或错误。 最多累积 15 条统计条目。
--verbose
mc-cmd
返回详细输出。
全局标志
此命令支持 全局标志 中的任意选项。