mc admin trace

描述

mc admin trace 命令用于显示目标 MinIO 部署上发生的 API 操作。

示例

mc admin trace -a ALIAS

mc admin trace -v --status-code 503 ALIAS

mc admin trace --path my-bucket/my-prefix/* ALIAS

mc admin trace --filter-response --filter-size 1Mb ALIAS

mc admin trace --filter-duration --filter-size 5ms ALIAS

语法

mc admin trace 的语法如下：

mc admin trace [FLAGS] TARGET

mc admin trace 支持以下参数：

TARGET

指定一个配置好的 MinIO 部署的 alias，用于监控 API 操作。

--all, a

返回 MinIO 部署上的所有流量，包括 MinIO 服务器之间的节点间流量。

--call

只跟踪匹配的客户端操作或调用类型。 例如，以下命令仅跟踪 scanner 类型的操作。

mc admin trace --call scanner TARGET

有效的呼叫类型包括：

• batch-keyrotation

• batch-replication

• bootstrap

• decommission

• ftp

• healing

• ilm

• internal

• os

• rebalance

• replication-resync

• s3

• scanner

• storage

如果未指定，MinIO 默认返回 s3 调用类型。

--errors, e

仅返回失败的 API 操作。

--filter-request

跟踪请求大小大于指定 --filter-size 值的客户端操作或调用。

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

--filter-response

跟踪响应大小大于指定 --filter-size 值的客户端操作或调用。

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

--filter-size

过滤调用的尺寸限制。

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

有效单位包括：

Suffix	Unit Size
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

返回输入的函数名称的调用记录。

--method

返回指定HTTP方法的调用记录。

--node

返回指定服务器的调用记录。

--path

返回指定路径的调用记录。

--request-header

返回与提供的请求头匹配的调用记录。

--request-query

返回与提供的请求查询参数匹配的调用记录。 此调试选项应仅在MinIO支持团队的指导下使用。

--response-duration

跟踪响应持续时间超过指定值的调用。

--response-threshold

使用时间字符串作为值，例如 5ms 。 仅返回响应时间超过提供的阈值的调用。

如果没有指定，MinIO 将返回响应时间超过 5ms 的调用。

--status-code

返回指定HTTP状态码的调用。

--stats

在当前跟踪会话期间，为每个跟踪的函数调用积累聚合统计数据。

输出表包括以下列。

Call	捕获的客户端操作或功能的名称。
Count	客户端操作或调用的次数。
RPM	客户端操作或呼叫的每分钟速率 (RPM)。
Avg Time	客户操作或呼叫完成所需的平均时间。
Min Time	客户操作或呼叫完成所需的最短时间。
Max Time	客户操作或呼叫完成所需的最长时间。
Avg TTFB	在 RELEASE.2023-11-15T22-45-58Z 版本加入. 客户端操作或呼叫响应的平均首字节时间 (TTFB)。
Max TTFB	在 RELEASE.2023-11-15T22-45-58Z 版本加入. 客户端操作或呼叫响应的最大到第一个字节的时间。
Avg Size	客户操作或呼叫响应的平均大小。
Errors	出错的客户端操作或调用失败的次数。
RX Avg	客户端操作或呼叫的平均接收字节数 (RX)。 只有在不为零（0）的情况下才会显示该统计量。
TX AVG	客户端操作或呼叫的平均发送字节数 (TX)。 只有在不为零（0）的情况下才会显示该统计量。

收集统计数据，如名称、计数、持续时间、最小时间、最大时间、首次字节时间或错误。 累积最多 15 个统计条目。

--verbose

返回详细输出。