mmdumpperfdata command

Collects and archives the performance metric information.

Synopsis

mmdumpperfdata [--remove-tree] [StartTime EndTime | Duration]

Availability

Available on all IBM Storage Scale editions.

Description

The mmdumpperfdata command runs all named queries and computed metrics used in the mmperfmon query command for each cluster node, writes the output into CSV files, and archives all the files in a single .tgz file. The file name is in the iss_perfdump_YYYYMMDD_hhmmss.tgz format.

The tar archive file contains a folder for each cluster node and within that folder there is a text file with the output of each named query and computed metric.

If the start and end time, or duration are not given, then by default the last four hours of metrics information is collected and archived.

Parameters

--remove-tree or -r
Removes the folder structure that was created for the TAR archive file.
StartTime
Specifies the start timestamp for query in the YYYY-MM-DD[-hh:mm:ss] format.
EndTime
Specifies the end timestamp for query in the YYYY-MM-DD[-hh:mm:ss] format.
Duration
Specifies the duration in seconds.

Exit status

0
Successful completion.
nonzero
A failure has occurred.

Security

You must have root authority to run the mmdumpperfdata command.

The node on which the command is issued must be able to execute remote shell commands on any other node in the cluster without the use of a password and without producing any extraneous messages. For more information, see Requirements for administering a GPFS file system.

Examples

  1. To archive the performance metric information collected for the default time period of last four hours and also delete the folder structure that the command creates, issue this command:
    mmdumpperfdata --remove-tree
    The system displays output similar to this:
    Using the following options:
tstart  :
tend    :
duration: 14400
rem tree: True
Target folder: ./iss_perfdump_20150513_142420
[1/120] Dumping data for node=fscc-hs21-22 and query q=swiftAccThroughput
  file: ./iss_perfdump_20150513_142420/fscc-hs21-22/swiftAccThroughput
[2/120] Dumping data for node=fscc-hs21-22 and query q=NetDetails
  file: ./iss_perfdump_20150513_142420/fscc-hs21-22/NetDetails
[3/120] Dumping data for node=fscc-hs21-22 and query q=ctdbCallLatency
  file: ./iss_perfdump_20150513_142420/fscc-hs21-22/ctdbCallLatency
[4/120] Dumping data for node=fscc-hs21-22 and query q=usage
  file: ./iss_perfdump_20150513_142420/fscc-hs21-22/usage
  2. To archive the performance metric information collected for a specific time period, issue this command:
    mmdumpperfdata --remove-tree 2015-01-25-04:04:04 2015-01-26-04:04:04
    The system displays output similar to this:
    Using the following options:
tstart  : 2015-01-25 04:04:04
tend    : 2015-01-26 04:04:04
duration:
rem tree: True
Target folder: ./iss_perfdump_20150513_144344
[1/120] Dumping data for node=fscc-hs21-22 and query q=swiftAccThroughput
  file: ./iss_perfdump_20150513_144344/fscc-hs21-22/swiftAccThroughput
[2/120] Dumping data for node=fscc-hs21-22 and query q=NetDetails
  file: ./iss_perfdump_20150513_144344/fscc-hs21-22/NetDetails
  3. To archive the performance metric information collected in the last 200 seconds, issue this command:
    mmdumpperfdata --remove-tree 200
    The system displays output similar to this:
    Using the following options:
tstart  :
tend    :
duration: 200
rem tree: True
Target folder: ./iss_perfdump_20150513_144426
[1/120] Dumping data for node=fscc-hs21-22 and query q=swiftAccThroughput
  file: ./iss_perfdump_20150513_144426/fscc-hs21-22/swiftAccThroughput
[2/120] Dumping data for node=fscc-hs21-22 and query q=NetDetails
  file: ./iss_perfdump_20150513_144426/fscc-hs21-22/NetDetails
[3/120] Dumping data for node=fscc-hs21-22 and query q=ctdbCallLatency
  file: ./iss_perfdump_20150513_144426/fscc-hs21-22/ctdbCallLatency
[4/120] Dumping data for node=fscc-hs21-22 and query q=usage
  file: ./iss_perfdump_20150513_144426/fscc-hs21-22/usage
[5/120] Dumping data for node=fscc-hs21-22 and query q=smb2IORate
  file: ./iss_perfdump_20150513_144426/fscc-hs21-22/smb2IORate
[6/120] Dumping data for node=fscc-hs21-22 and query q=swiftConLatency
  file: ./iss_perfdump_20150513_144426/fscc-hs21-22/swiftConLatency
[7/120] Dumping data for node=fscc-hs21-22 and query q=swiftCon
  file: ./iss_perfdump_20150513_144426/fscc-hs21-22/swiftCon
[8/120] Dumping data for node=fscc-hs21-22 and query q=gpfsNSDWaits
  file: ./iss_perfdump_20150513_144426/fscc-hs21-22/gpfsNSDWaits
[9/120] Dumping data for node=fscc-hs21-22 and query q=smb2Throughput
  file: ./iss_perfdump_20150513_144426/fscc-hs21-22/smb2Throughput

See also

For more information, see mmperfmon command.

Location

/usr/lpp/mmfs/bin