mc admin trace

说明

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

示例

监控所有 API 操作

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

mc admin trace -a ALIAS

• 将 ALIAS 替换为 MinIO 部署的 alias。

查看返回 503 错误的调用

使用 mc admin trace 监控返回 503 Service Unavailable 错误的 API 操作：

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

• 将 ALIAS 替换为 MinIO 部署的 alias。

查看指定路径的控制台跟踪

使用 mc admin trace 监控指定路径的活动：

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

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

查看响应大小大于 1Mb 的控制台跟踪

使用 mc admin trace 监控超过指定大小的响应：

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

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

查看请求操作时长大于 5ms 的控制台跟踪

使用 mc admin trace 监控耗时较长的操作：

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

• 将 ALIAS 替换为 MinIO 部署的 alias。

语法

mc admin trace 的语法如下：

mc admin trace [FLAGS] TARGET

mc admin trace 支持以下参数：

TARGET

mc-cmd

指定已配置 MinIO 部署的 alias，用于监控其 API 操作。

--all, a

mc-cmd

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

--call

mc-cmd

仅跟踪匹配的客户端操作或调用类型。 例如，以下命令仅跟踪 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

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

有效单位包括：

--funcname

mc-cmd

返回输入函数名对应的调用。

--method

mc-cmd

返回指定 HTTP 方法的调用。

--node

mc-cmd

返回指定服务器的调用。

--path

mc-cmd

返回指定路径的调用。

--request-header

mc-cmd

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

--request-query

mc-cmd

返回与提供的请求查询参数匹配的调用。 此调试选项只能在 MinIO Support 指导下使用。

--response-duration

mc-cmd

跟踪响应时长大于指定值的调用。

--response-threshold

mc-cmd

接受时间字符串作为值，例如 5ms。 仅返回响应时间大于所提供阈值的调用。

如果未指定，MinIO 返回响应时间大于 5ms 的调用。

--status-code

mc-cmd

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

--stats

mc-cmd

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

输出表包含以下列。

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

--verbose

mc-cmd

返回详细输出。

全局标志

此命令支持 全局标志 中的任意选项。