[LU-11837] iokit-lstats example should be modified Created: 07/Jan/19  Updated: 07/Jan/19

Status: Open
Project: Lustre
Component/s: None
Affects Version/s: Lustre 2.12.0, Lustre 2.13.0
Fix Version/s: None

Type: Improvement Priority: Minor
Reporter: James Nunez (Inactive) Assignee: WC Triage
Resolution: Unresolved Votes: 0
Labels: None

Issue Links:
Related
is related to LU-11732 stats collection script Closed
Rank (Obsolete): 9223372036854775807

 Description   

Looking at the iokit-lstats script, we see the example

very short example:
#
# to start collection:
#   VMSTAT_INTERVAL=0 SERVICE_INTERVAL=2 SDIO_INTERVAL=0 iokit-lstats start
#

Yet, if you run this command on a client, you’ll get errors

# VMSTAT_INTERVAL=0 SERVICE_INTERVAL=2 SDIO_INTERVAL=0 iokit-lstats start
error: list_param: param_path 'ost/*': No such file or directory
error: list_param: listing 'ost/*': No such file or directory
error: list_param: param_path 'mdt/*': No such file or directory
error: list_param: listing 'mdt/*': No such file or directory
error: list_param: param_path 'obdfilter/*': No such file or directory
error: list_param: listing 'obdfilter/*': No such file or directory
error: list_param: param_path 'mds/*': No such file or directory
error: list_param: listing 'mds/*': No such file or directory

A process is started, but the errors might concern the user.

The example doesn’t even run without complaining on a server. On an MDS, we see

# VMSTAT_INTERVAL=0 SERVICE_INTERVAL=2 SDIO_INTERVAL=0 iokit-lstats start
error: list_param: param_path 'ost/*': No such file or directory
error: list_param: listing 'ost/*': No such file or directory
error: list_param: param_path 'obdfilter/*': No such file or directory
error: list_param: listing 'obdfilter/*': No such file or directory

It seems like the example needs to be modified and/or some clarification should be added on where the command should be run.

Also, it would be nice to add a help flag to this script if we allow users to run it

# VMSTAT_INTERVAL=0 SERVICE_INTERVAL=2 SDIO_INTERVAL=0 iokit-lstats --help
Unknown command
# VMSTAT_INTERVAL=0 SERVICE_INTERVAL=2 SDIO_INTERVAL=0 iokit-lstats -help
Unknown command

Generated at Sat Feb 10 02:47:21 UTC 2024 using Jira 9.4.14#940014-sha1:734e6822bbf0d45eff9af51f82432957f73aa32c.