mc support perf object

The mc support perf object command measures the S3 performance of reading and writing objects in a cluster.

AIStor autotunes concurrency to obtain maximum throughput and IOPS (Input/Output Per Second).

Use this command to identify potential S3 API performance bottlenecks in your deployment.

Syntax

Example Syntax

The command has the following syntax:

mc [GLOBALFLAGS] support perf object  \
                 ALIAS                \
                 [--size]             \
                 [--concurrent]       \
                 [--verbose, -v]      \
                 [--airgap]

Brackets [] indicate optional parameters.
Parameters sharing a line are mutually dependent.
Parameters separated using the pipe | operator are mutually exclusive.

Copy the example to a text editor and modify as needed before running the command in the terminal/shell.

Parameters

ALIAS

Required

The alias of the AIStor deployment.

--airgap

Optional

Use in environments without network access to SUBNET (for example, airgapped, firewalled, or similar configuration).

If the deployment is airgapped, but the local device where you are using the AIStor Client has network access, you do not need to use the --airgap flag.

--concurrent

Optional

Specify the number of concurrent requests to test per server.

If not specified, the default value is 32.

Use --concurrent <value> where <value> is a number.

--size

Optional

Specify the size of the object to use for upload and download performance test.

If not specified, the default value is 64MiB.

Use --size <value> where <value> is a number and the storage unit, KiB, MiB, or GiB.

--verbose, -v

Optional

Show per-server stats in the output.

Global flags

This command supports any of the global flags.

Examples

Measure speed of an object

Measure the performance of S3 read/write of an object on the alias myaistor. AIStor autotunes concurrency to obtain maximum throughput and IOPS.

mc support perf object myaistor

Measure speed of an object of a specific size for a specific duration

Run the S3 read/write performance test of an object for 20 seconds with object size of 128MiB on alias myaistor. AIStor autotunes concurrency to obtain maximum throughput.

mc support perf object myaistor --duration 20s --size 128MiB