Documentation

Documentation

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

MinIO does not support using mc admin commands with other S3-compatible services, regardless of their claimed compatibility with MinIO deployments.

Examples

Monitor All API operations

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

mc admin trace -a ALIAS
  • Replace ALIAS with the 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 with the alias of the MinIO deployment.

See Console Trace for a Path

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

mc admin trace --path my-bucket/my-prefix/* ALIAS
  • Replace ALIAS with the alias of the MinIO deployment.

  • Replace my-bucket/my-prefix/* with the bucket, prefix, and object name or wildcard you wish to trace.

Syntax

mc admin trace has the following syntax:

mc admin trace [FLAGS] TARGET

mc admin trace supports the following argument:

TARGET

Specify the 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:

  • s3

  • internal

  • storage

  • os

  • scanner

  • decommission

  • healing

--verbose

Returns verbose output.

--errors, e

Returns failed API operations only.

--response-threshold

Takes a time string as a value, such as 5ms. Returns only calls with a response time greater than the supplied threshold.

--status-code

Returns calls of the specified HTTP status code.

--method

Returns call of the specified HTTP method.

--funcname

Returns calls for the entered function name.

--path

Returns calls for the specified path.

--node

Returns calls for the specified server.

--request-header

Returns calls matching the supplied request header.