# mc admin scanner trace

LLMS 索引： [llms.txt](/zh/llms.txt)

---

<a id="mc-admin-scanner-trace"></a>

<a id="command-mc.admin.scanner.trace"></a>

<a id="id2" data-td-print-local></a>

## 说明 {#description}

[`mc admin scanner trace`](#command-mc.admin.scanner.trace) 命令会显示目标 MinIO 部署上发生的 [scanner](/zh/operations/concepts/scanner/#minio-concepts-scanner) 相关 API 操作。

> [!NOTE]
> **仅在 MinIO 部署上使用 `mc admin`**
>
> MinIO 不支持将 [`mc admin`](/zh/reference/minio-mc-admin/#command-mc.admin) 命令用于其他 S3 兼容服务， 无论这些服务声称与 MinIO 部署具有何种兼容性。

**示例**

以下示例返回 `myminio` 部署上与 scanner 相关的 API 操作列表。

```shell
mc admin scanner trace myminio
```

**语法**

命令语法如下：

```shell
mc admin scanner trace ALIAS
                       [--filter-request]            \
                       [--filter-response]           \
                       [--filter-size <value>]       \
                       [--funcname <value>]          \
                       [--node <value>]              \
                       [--path <value>]              \
                       [--response-duration <value>] \
                       [--verbose, -v]
```

- 方括号 `[]` 表示可选参数。
- 同一行中的参数彼此相互依赖。
- 使用管道符 `|` 分隔的参数彼此互斥。

请先将示例复制到文本编辑器中并按需修改，再在终端 / shell 中运行命令。

<a id="id3" data-td-print-local></a>

### 参数 {#parameters}

##### `ALIAS` {#mc.admin.scanner.trace.ALIAS}

*mc-cmd*

*Required*

要显示其 [scanner](/zh/operations/concepts/scanner/#minio-concepts-scanner) API 操作的 MinIO 部署的 [alias](/zh/reference/minio-mc/mc-alias-set/#alias)。

##### `--filter-request` {#mc.admin.scanner.trace.-filter-request}

*mc-cmd*

*Optional*

跟踪请求大小大于指定 [`--filter-size`](#mc.admin.scanner.trace.-filter-size) 值的 scanner 操作或调用。

**必须** 与 [`--filter-size`](#mc.admin.scanner.trace.-filter-size) 标志配合使用。

##### `--filter-response` {#mc.admin.scanner.trace.-filter-response}

*mc-cmd*

*Optional*

跟踪响应大小大于指定 [`--filter-size`](#mc.admin.scanner.trace.-filter-size) 值的 scanner 操作或调用。

**必须** 与 [`--filter-size`](#mc.admin.scanner.trace.-filter-size) 标志配合使用。

##### `--filter-size` {#mc.admin.scanner.trace.-filter-size}

*mc-cmd*

*Optional*

将输出过滤为请求大小或响应大小大于指定大小的条目。

必须与 [`--filter-request`](#mc.admin.scanner.trace.-filter-request) 或 [`--filter-response`](#mc.admin.scanner.trace.-filter-response) 标志之一配合使用。

有效单位包括：

| 后缀 | 单位大小                        |
| ---- | ------------------------------- |
| `k`  | KB（Kilobyte，1000 Bytes）      |
| `m`  | MB（Megabyte，1000 Kilobytes）  |
| `g`  | GB（Gigabyte，1000 Megabytes）  |
| `t`  | TB（Terabyte，1000 Gigabytes）  |
| `ki` | KiB（Kibibyte，1024 Bytes）     |
| `mi` | MiB（Mebibyte，1024 Kibibytes） |
| `gi` | GiB（Gibibyte，1024 Mebibytes） |
| `ti` | TiB（Tebibyte，1024 Gibibytes） |

##### `--funcname` {#mc.admin.scanner.trace.-funcname}

*mc-cmd*

*Optional*

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

##### `--node` {#mc.admin.scanner.trace.-node}

*mc-cmd*

*Optional*

返回指定服务器的调用。

##### `--path` {#mc.admin.scanner.trace.-path}

*mc-cmd*

*Optional*

返回指定路径的调用。

##### `--response-duration` {#mc.admin.scanner.trace.-response-duration}

*mc-cmd*

*Optional*

跟踪响应持续时间大于指定值的调用。

##### `--verbose, -v` {#mc.admin.scanner.trace.-verbose}

*mc-cmd*

*Optional*

返回详细输出。

<a id="id4" data-td-print-local></a>

### 全局标志 {#global-flags}

此命令支持 [全局标志](/zh/reference/minio-mc/#minio-mc-global-options) 中的任意选项。

<a id="id5" data-td-print-local></a>

## 示例 {#examples}

<a id="scanner-api" data-td-print-local></a>

### 监控所有 scanner API 操作 {#monitor-all-scanner-api-operations}

使用 [`mc admin scanner trace`](#command-mc.admin.scanner.trace) 监控别名为 `myminio` 的 MinIO 部署上的 [scanner](/zh/operations/concepts/scanner/#minio-concepts-scanner) API 操作：

```shell
mc admin scanner trace myminio
```

<a id="scanner" data-td-print-local></a>

### 显示特定路径的 scanner 跟踪 {#show-scanner-trace-for-a-specific-path}

使用 [`mc admin scanner trace`](#command-mc.admin.scanner.trace) 监控别名为 `myminio` 的部署上路径 `my-bucket/my-prefix/*` 的 API 操作：

```shell
mc admin scanner trace --path my-bucket/my-prefix/* myminio
```

<a id="scanobject-scanner-api" data-td-print-local></a>

### 显示 `scanObject` 函数的 scanner API 操作 {#show-scanner-api-operations-for-the-scanobject-function}

监控 `myminio` 部署上 `scanObject` 函数的 scanner 活动：

```shell
mc admin scanner trace --funcname=scanner.ScanObject myminio
```

<a id="mb-scanner" data-td-print-local></a>

### 显示大于 `1MB` 的 scanner 操作请求 {#show-scanner-operation-requests-greater-than-1mb-in-size}

使用 [`mc admin scanner trace`](#command-mc.admin.scanner.trace) 监控 `myminio` 部署上大于 `1MB` 的请求：

```shell
mc admin scanner trace --filter-request --filter-size 1MB myminio
```

<a id="id6" data-td-print-local></a>

### 显示大于 `1MB` 的 scanner 操作响应 {#show-scanner-operation-responses-greater-than-1mb-in-size}

使用 [`mc admin scanner trace`](#command-mc.admin.scanner.trace) 监控较大的响应大小：

```shell
mc admin scanner trace --filter-response --filter-size 1MB myminio
```

<a id="id7" data-td-print-local></a>

### 显示持续超过五毫秒的 scanner 操作 {#show-scanner-operations-that-last-longer-than-five-milliseconds}

使用 [`mc admin scanner trace`](#command-mc.admin.scanner.trace) 监控耗时较长的操作：

```shell
mc admin scanner trace --response-duration 5ms myminio
```