`mc admin trace`

描述

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

仅在 MinIO 部署上使用 mc admin

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

示例

监控所有 API 操作

使用 mc admin trace 监控 MinIO 部署上的 API 操作

mc admin trace -a ALIAS

将 ALIAS 替换为 MinIO 部署的 别名。

查看返回 503 错误的调用

使用 mc admin trace 监控返回服务不可用 503 错误的 API 操作

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

将 ALIAS 替换为 MinIO 部署的 别名。

查看路径的控制台跟踪

使用 mc admin trace 监控特定路径的活动。

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

将 ALIAS 替换为 MinIO 部署的 别名。
将 my-bucket/my-prefix/* 替换为要跟踪的存储桶、前缀和对象名称或通配符。

如果响应大小大于 1Mb，请参阅控制台跟踪

使用 mc admin trace 监控特定大小的响应。

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

将 ALIAS 替换为 MinIO 部署的 别名。
将 1Mb 替换为所需的响应大小。

如果请求操作持续时间大于 5ms，请参阅控制台跟踪

使用 mc admin trace 监控长时间操作。

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

将 ALIAS 替换为 MinIO 部署的 别名。

语法

mc admin trace 具有以下语法。

mc admin trace [FLAGS] TARGET

mc admin trace 支持以下参数。

TARGET: 指定要监控 API 操作的已配置 MinIO 部署的 alias。

--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 标志之一一起使用。

有效的单位包括：

后缀	单位大小
`k`	KB（千字节，1000 字节）
`m`	MB（兆字节，1000 千字节）
`g`	GB（千兆字节，1000 兆字节）
`t`	TB（太字节，1000 千兆字节）
`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 将返回响应时间大于 5ms 的调用。

--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 平均值	客户端操作或调用发送的平均字节数 (TX)。此统计信息仅在不为零 (0) 时显示。

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

--verbose: 返回详细输出。

全局标志

此命令支持任何全局标志。