mc admin cluster stats

The mc admin cluster stats command opens an interactive terminal dashboard that displays realtime and historic statistics for a MinIO AIStor deployment. You can also replay metrics from a previously saved file instead of connecting to a live deployment.

Example Syntax

The command has the following syntax:

mc [GLOBALFLAGS] admin cluster stats     \
                 [--refresh DURATION]    \
                 [--in FILE]             \
                 [ALIAS]

Brackets [] indicate optional parameters.

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 a MinIO AIStor cluster.

ALIAS is optional when you use --in to replay a saved file.

--refresh

Optional

Set the interval at which the dashboard refreshes statistics from the deployment. Specify a duration such as 5s, 10s, or 1m.

Defaults to 5s.

The refresh interval applies only when connected to a live deployment.

--in

Optional

Replay statistics from a previously saved metrics file instead of connecting to a deployment.

When you replay a saved file, the dashboard displays the captured data and disables the live-only actions such as manual refresh and data upload.

Interactive keys

The dashboard is interactive. Use the following keys to navigate and act on the displayed statistics:

Key	Action
`↑` / `↓`	Move the selection or scroll the current view.
`Enter`	Select the highlighted item.
`Esc`	Return to the previous view.
`Home` / `End`	Jump to the first or last item.
`PgUp` / `PgDn`	Page through the current view.
`Ctrl+R`	Refresh statistics from the deployment. Available only when connected to a live deployment.
`Ctrl+U`	Save the current metrics to a compressed file and upload them to SUBNET. Available only when connected to a live deployment.
`q`	Quit the dashboard.

When you press Ctrl+U, the dashboard prompts for an optional SUBNET issue number (up to five digits). Enter an issue number to attach the uploaded metrics to that issue, or press Enter to skip. The command saves the collected metrics to a local compressed file and uploads that file to SUBNET.

Global flags

This command supports any of the global flags.

Examples

View realtime cluster statistics

mc admin cluster stats myaistor

Set a custom refresh interval

mc admin cluster stats --refresh 10s myaistor

Replay statistics from a saved file

mc admin cluster stats --in metrics_26-07-24-15_04.msgp.zst