mc admin trace

描述

Themc 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

指定alias已配置的 MinIO 部署的 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-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

返回输入函数名的调用。

--method

返回指定 HTTP 方法的调用。

--node

返回指定服务器的调用。

--path

返回指定路径的调用。

--request-header

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

--request-query

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

--response-duration

追踪响应时长超过指定值的调用。

--response-threshold

接受一个时间字符串作为值，例如5ms仅返回响应时间大于指定阈值的调用。

如果未指定，MinIO 将返回响应时间超过 5 毫秒的调用。

--status-code

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

--stats

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

输出表包含以下列。

呼叫	捕获的客户端操作或函数的名称。
计数	客户端操作或调用发生的次数。
RPM	客户端操作或调用的每分钟速率（RPM）。
平均时间	客户端操作或调用完成所需的平均时间。
最短时间	客户端操作或调用完成所需的最短时间。
最大时间	客户端操作或调用完成所花费的最长时间。
平均 TTFB	版本 RELEASE.2023-11-15T22-45-58Z 中的新增功能。 客户端操作或调用响应的平均首字节时间(TTFB)。
最大 TTFB	版本 RELEASE.2023-11-15T22-45-58Z 中的新增功能。 客户端操作或调用响应的最大首字节时间。
平均大小	客户端操作或调用响应的平均大小。
错误	出现错误而失败的客户端操作或调用次数。
RX 平均值	客户端操作或调用的平均接收字节数（RX）。 仅当该统计值不为零（0）时显示。
TX AVG	客户端操作或调用的平均发送字节数（TX）。 此统计信息仅在非零（0）时显示。

累积统计信息，例如名称、计数、持续时间、最短时间、最长时间、首字节时间或错误。 最多可累积15个统计条目。

--verbose

返回详细输出。