`mc support top rpc`

SUBNET Registration Required

The mc support commands are designed for MinIO deployments registered with MinIO SUBNET to ensure optimal outcome of diagnostics and performance testing. Deployments not registered with SUBNET cannot use the mc support commands.

Syntax

The mc support top rpc command displays metrics for remote procedure calls (RPC).

EXAMPLE

The following command displays the current remote procedure call metrics for the alias myminio deployment.

mc support top rpc myminio/

The output returns information such as the server, number of connections, length of ping, time since last ping (pong), reconnections, string in, string out, messages in, and messages out.

The output resembles

λ mc support top rpc myminio
      SERVER            CONCTD  PING     PONG   OUT.Q   RECONNS STR.IN  STR.OUT MSG.IN  MSG.OUT
 To  127.0.0.1:9002       5     0.7ms   1s ago    0        0     ->0      0->    3269    3212
From 127.0.0.1:9002       5     1.1ms   1s ago    0        0     ->0      0->    3213    3269
 To  127.0.0.1:9003       5     0.6ms   1s ago    0        0     ->0      0->    6001    6076
From 127.0.0.1:9003       5     0.6ms   1s ago    0        0     ->0      0->    6077    6001
 To  127.0.0.1:9004       5     0.6ms   1s ago    0        0     ->0      0->    3243    3160
From 127.0.0.1:9004       5     0.4ms   1s ago    0        0     ->0      0->    3161    3243
 To  127.0.0.1:9005       5     0.6ms   1s ago    0        0     ->0      0->    3150    3094
From 127.0.0.1:9005       5     0.3ms   1s ago    0        0     ->0      0->    3095    3150
 To  127.0.0.1:9006       5     0.3ms   1s ago    0        0     ->0      0->    3185    3221
From 127.0.0.1:9006       5     0.6ms   1s ago    0        0     ->0      0->    3222    3185

SYNTAX

The command has the following syntax:

mc [GLOBALFLAGS] support top rpc                 \
                             [--airgap]          \
                             [--in value]        \
                             [--interval value]  \
                             [-n value]          \
                             [--nodes value]     \
                             TARGET

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

TARGET: Required
The full path to the alias or prefix where the command should run.

--airgap: Optional
Use in environments without network access to SUBNET.

--in: Optional
Replay a previously saved JSON file. Specify the path to the JSON file to replay, such as one generated by a previous run of this command.

--interval

Optional

The interval in seconds between metric requests.

By default, the command requests metrics every second.

-n

Optional

The number of requests to run before existing. Use 0 for endless.

If not specified, the command does not automatically exit.

--nodes: Optional
Comma-separated list of the node or nodes from which to collect metrics.

Global Flags

This command supports any of the global flags.