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.
The following command opens the realtime statistics dashboard for the myaistor MinIO AIStor cluster:
mc admin cluster stats myaistorThe 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 unless you specify --in
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 myaistorSet a custom refresh interval
mc admin cluster stats --refresh 10s myaistorReplay statistics from a saved file
mc admin cluster stats --in metrics_26-07-24-15_04.msgp.zst