docs/source/reference/minio-mc-admin/mc-admin-trace.rst

mc admin trace

minio

Table of Contents

mc admin trace

Description

The mc admin trace command displays API operations occurring on the target MinIO deployment.

Use mc admin on MinIO Deployments Only

Examples

Monitor All API operations

Use mc admin trace to monitor API operations on a MinIO deployment:

mc admin trace -a ALIAS

• Replace ALIAS <mc admin trace TARGET> with the alias <mc alias> of the MinIO deployment.

See Calls that Return 503 Errors

Use mc admin trace to monitor API operations that return a service unavailable 503 error:

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

• Replace ALIAS <mc admin trace TARGET> with the alias <mc alias> of the MinIO deployment.

See Console Trace for a Path

Use mc admin trace to monitor activity for a specific path:

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

• Replace ALIAS <mc admin trace TARGET> with the alias <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

Use mc admin trace to monitor responses over a specific size:

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

• Replace ALIAS <mc admin trace TARGET> with the alias <mc alias> of the MinIO deployment.
• Replace 1Mb with the desired response size.

See Console Trace for a Request Operation Durations Greater than 5ms

Use mc admin trace to monitor long operations:

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

• Replace ALIAS <mc admin trace TARGET> with the alias <mc alias> of the MinIO deployment.

Syntax

mc admin trace has the following syntax:

mc admin trace [FLAGS] TARGET

mc admin trace supports the following argument:

TARGET

Specify the alias <mc alias> of a configured MinIO deployment for which to monitor API operations.

--all, a

Returns all traffic on the MinIO deployment, including internode traffic between MinIO servers.

--call

Traces only matching call types. For example, the following command only traces calls of the type scanner.

mc admin trace --call scanner TARGET

Valid call types include:

• batch-replication
• bootstrap
• decommission
• ftp
• healing
• internal
• os
• rebalance
• replication-resync
• s3
• scanner
• storage

If not specified, MinIO returns call types of s3.

--errors, e

Returns failed API operations only.

--filter-request

Trace calls with request size greater than the specified ~mc admin trace --filter-size value.

Must be used with ~mc admin trace --filter-size flag.

--filter-response

Trace calls with response size greater than the specified ~mc admin trace --filter-size value.

Must be used with ~mc admin trace --filter-size flag.

--filter-size

Size limit of a filtered call.

Must be used with either ~mc admin trace --filter-request or ~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

Returns calls for the entered function name.

--method

Returns call of the specified HTTP method.

--node

Returns calls for the specified server.

--path

Returns calls for the specified path.

--request-header

Returns calls matching the supplied request header.

--response-duration

Trace calls with response duration greater than the specified value.

--response-threshold

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

Returns calls of the specified HTTP status code.

--verbose

Returns verbose output.

Global Flags