# mc admin trace LLMS index: [llms.txt](/llms.txt) --- ## Description {#description} The [`mc admin trace`](#command-mc.admin.trace) command displays API operations occurring on the target MinIO deployment. > [!NOTE] > **Use `mc admin` on MinIO Deployments Only** > > MinIO does not support using [`mc admin`](/reference/minio-mc-admin/#command-mc.admin) commands with other S3-compatible services, regardless of their claimed compatibility with MinIO deployments. ## Examples {#examples} ### Monitor All API operations {#monitor-all-api-operations} Use [`mc admin trace`](#command-mc.admin.trace) to monitor API operations on a MinIO deployment: ```shell mc admin trace -a ALIAS ``` - Replace [`ALIAS`](#mc.admin.trace.TARGET) with the [`alias`](/reference/minio-mc/mc-alias/#command-mc.alias) of the MinIO deployment. ### See Calls that Return 503 Errors {#see-calls-that-return-503-errors} Use [`mc admin trace`](#command-mc.admin.trace) to monitor API operations that return a service unavailable 503 error: ```shell mc admin trace -v --status-code 503 ALIAS ``` - Replace [`ALIAS`](#mc.admin.trace.TARGET) with the [`alias`](/reference/minio-mc/mc-alias/#command-mc.alias) of the MinIO deployment. ### See Console Trace for a Path {#see-console-trace-for-a-path} Use [`mc admin trace`](#command-mc.admin.trace) to monitor activity for a specific path: ```shell mc admin trace --path my-bucket/my-prefix/* ALIAS ``` - Replace [`ALIAS`](#mc.admin.trace.TARGET) with the [`alias`](/reference/minio-mc/mc-alias/#command-mc.alias) of the MinIO deployment. - Replace `my-bucket/my-prefix/*` with the bucket, prefix, and object name or wildcard you wish to trace. ### See Console Trace for a Response Size Greater than 1Mb {#see-console-trace-for-a-response-size-greater-than-1mb} Use [`mc admin trace`](#command-mc.admin.trace) to monitor responses over a specific size: ```shell mc admin trace --filter-response --filter-size 1Mb ALIAS ``` - Replace [`ALIAS`](#mc.admin.trace.TARGET) with the [`alias`](/reference/minio-mc/mc-alias/#command-mc.alias) of the MinIO deployment. - Replace `1Mb` with the desired response size. ### See Console Trace for a Request Operation Durations Greater than 5ms {#see-console-trace-for-a-request-operation-durations-greater-than-5ms} Use [`mc admin trace`](#command-mc.admin.trace) to monitor long operations: ```shell mc admin trace --filter-duration --filter-size 5ms ALIAS ``` - Replace [`ALIAS`](#mc.admin.trace.TARGET) with the [`alias`](/reference/minio-mc/mc-alias/#command-mc.alias) of the MinIO deployment. ## Syntax {#syntax} [`mc admin trace`](#command-mc.admin.trace) has the following syntax: ```shell mc admin trace [FLAGS] TARGET ``` [`mc admin trace`](#command-mc.admin.trace) supports the following argument: #### `TARGET` {#mc.admin.trace.TARGET} *mc-cmd* Specify the [`alias`](/reference/minio-mc/mc-alias/#command-mc.alias) of a configured MinIO deployment for which to monitor API operations. #### `--all, a` {#mc.admin.trace.-all} *mc-cmd* Returns all traffic on the MinIO deployment, including internode traffic between MinIO servers. #### `--call` {#mc.admin.trace.-call} *mc-cmd* Traces only matching client operation or call types. For example, the following command only traces operations of the type `scanner`. ```shell mc admin trace --call scanner TARGET ``` Valid call types include: - `batch-keyrotation` - `batch-replication` - `bootstrap` - `decommission` - `ftp` - `healing` - `ilm` - `internal` - `os` - `rebalance` - `replication-resync` - `s3` - `scanner` - `storage` If not specified, MinIO returns call types of `s3`. #### `--errors, e` {#mc.admin.trace.-errors} *mc-cmd* Returns failed API operations only. #### `--filter-request` {#mc.admin.trace.-filter-request} *mc-cmd* Trace client operations or calls with request size greater than the specified [`--filter-size`](#mc.admin.trace.-filter-size) value. Must be used with [`--filter-size`](#mc.admin.trace.-filter-size) flag. #### `--filter-response` {#mc.admin.trace.-filter-response} *mc-cmd* Trace client operations or calls with response size greater than the specified [`--filter-size`](#mc.admin.trace.-filter-size) value. Must be used with [`--filter-size`](#mc.admin.trace.-filter-size) flag. #### `--filter-size` {#mc.admin.trace.-filter-size} *mc-cmd* Size limit of a filtered client operation or call. Must be used with either [`--filter-request`](#mc.admin.trace.-filter-request) or [`--filter-response`](#mc.admin.trace.-filter-response) flag. Valid units include: | 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` {#mc.admin.trace.-funcname} *mc-cmd* Returns calls for the entered function name. #### `--method` {#mc.admin.trace.-method} *mc-cmd* Returns call of the specified HTTP method. #### `--node` {#mc.admin.trace.-node} *mc-cmd* Returns calls for the specified server. #### `--path` {#mc.admin.trace.-path} *mc-cmd* Returns calls for the specified path. #### `--request-header` {#mc.admin.trace.-request-header} *mc-cmd* Returns calls matching the supplied request header. #### `--request-query` {#mc.admin.trace.-request-query} *mc-cmd* Returns calls matching the supplied request query parameter. This debug option should only be used at the direction of MinIO Support. #### `--response-duration` {#mc.admin.trace.-response-duration} *mc-cmd* Trace calls with response duration greater than the specified value. #### `--response-threshold` {#mc.admin.trace.-response-threshold} *mc-cmd* Takes a time string as a value, such as `5ms`. Returns only calls with a response time greater than the supplied threshold. If not specified, MinIO returns calls with a response time greater than 5ms. #### `--status-code` {#mc.admin.trace.-status-code} *mc-cmd* Returns calls of the specified HTTP status code. #### `--stats` {#mc.admin.trace.-stats} *mc-cmd* Accumulates aggregated statistics for each traced function call during the current trace session. The output table includes the following columns.

Call

The name of the captured client operation or function.

Count

The number of times the client operation or call occurred.

RPM

The Rate Per Minute (RPM) of the client operation or call.

Avg Time

The average time required for the client operation or call to complete.

Min Time

The minimum time spent for the client operation or call to complete.

Max Time

The maximum time spent for the client operation or call to complete.

Avg TTFB

The average Time To First Byte (TTFB) for the client operation or call response.

Max TTFB

The maximum Time To First Byte for the client operation or call response.

Avg Size

Average size of client operation or call responses.

Errors

The number of client operations or calls that failed with an error.

RX Avg

The average number of Bytes Received (RX) for the client operation or call. This stat only displays if not zero (0).

TX AVG

The average number of Bytes Sent (TX) for the client operation or call. This stat only displays if not zero (0).
Accumulate stats, such as name, count, duration, min time, max time, time to first byte, or errors. Accumulates up to 15 stat entries. #### `--verbose` {#mc.admin.trace.-verbose} *mc-cmd* Returns verbose output. ### Global Flags {#global-flags} This command supports any of the [global flags](/reference/minio-mc/#minio-mc-global-options).