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
- 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:
The system displays output similar to this:mmdumpperfdata --remove-treeUsing the following options: StartTime : 2025-09-16 05:40:16 EndTime : rem tree : True Target folder: ./iss_perfdump_20250916_094016 --- Process data for node: remotefs-32.openstacklocal with hostname:remotefs-32 --- [1/60] Dumping data for node=remotefs-32.openstacklocal and query q=cpu file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/cpu [2/60] Dumping data for node=remotefs-32.openstacklocal and query q=nfsThroughput file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/nfsThroughput [3/60] Dumping data for node=remotefs-32.openstacklocal and query q=nfsIORate file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/nfsIORate [4/60] Dumping data for node=remotefs-32.openstacklocal and query q=nfsIOLatency file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/nfsIOLatency [5/60] Dumping data for node=remotefs-32.openstacklocal and query q=nfsErrors file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/nfsErrors [6/60] Dumping data for node=remotefs-32.openstacklocal and query q=nfsQueue file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/nfsQueue [7/60] Dumping data for node=remotefs-32.openstacklocal and query q=nfsThroughputPerOp file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/nfsThroughputPerOp [8/60] Dumping data for node=remotefs-32.openstacklocal and query q=smb2Writes file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/smb2Writes [9/60] Dumping data for node=remotefs-32.openstacklocal and query q=smb2Throughput file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/smb2Throughput [10/60] Dumping data for node=remotefs-32.openstacklocal and query q=smb2IORate file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/smb2IORate [11/60] Dumping data for node=remotefs-32.openstacklocal and query q=smb2IOLatency file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/smb2IOLatency [12/60] Dumping data for node=remotefs-32.openstacklocal and query q=smbConnections file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/smbConnections [13/60] Dumping data for node=remotefs-32.openstacklocal and query q=usage file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/usage [14/60] Dumping data for node=remotefs-32.openstacklocal and query q=gpfsCRUDopsLatency file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/gpfsCRUDopsLatency [15/60] Dumping data for node=remotefs-32.openstacklocal and query q=gpfsNumberOperations file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/gpfsNumberOperations [16/60] Dumping data for node=remotefs-32.openstacklocal and query q=gpfsNSDWaits file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/gpfsNSDWaits [17/60] Dumping data for node=remotefs-32.openstacklocal and query q=gpfsFSWaits file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/gpfsFSWaits [18/60] Dumping data for node=remotefs-32.openstacklocal and query q=gpfsVFSOpCounts file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/gpfsVFSOpCounts [19/60] Dumping data for node=remotefs-32.openstacklocal and query q=gpfsEventProducer file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/gpfsEventProducer [20/60] Dumping data for node=remotefs-32.openstacklocal and query q=netDetails file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/netDetails [21/60] Dumping data for node=remotefs-32.openstacklocal and query q=netErrors file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/netErrors [22/60] Dumping data for node=remotefs-32.openstacklocal and query q=compareNodes file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/compareNodes [23/60] Dumping data for node=remotefs-32.openstacklocal and query q=protocolThroughput file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/protocolThroughput [24/60] Dumping data for node=remotefs-32.openstacklocal and query q=protocolIORate file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/protocolIORate [25/60] Dumping data for node=remotefs-32.openstacklocal and query q=protocolIOLatency file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/protocolIOLatency [26/60] Dumping data for node=remotefs-32.openstacklocal and query q=ctdbHopCounts file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/ctdbHopCounts [27/60] Dumping data for node=remotefs-32.openstacklocal and query q=ctdbHopCountDetails file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/ctdbHopCountDetails [28/60] Dumping data for node=remotefs-32.openstacklocal and query q=ctdbCallLatency file: ./iss_perfdump_20250916_094016/remotefs-32.openstacklocal/ctdbCallLatency Performance data archive created: iss_perfdump_20250916_094016.tgz rm -rf ./iss_perfdump_20250916_094016 # - To archive the performance metric information collected for a specific time period, issue this
command:
The system displays output similar to this:mmdumpperfdata --remove-tree 2015-01-25-04:04:04 2015-01-26-04:04:04Using the following options: StartTime : 2025-11-01 04:04:04 EndTime : 2025-11-15 04:04:04 rem tree : True Target folder: ./iss_perfdump_20250916_094011 --- Process data for node: remotefs-31.openstacklocal with hostname:remotefs-31 --- [1/60] Dumping data for node=remotefs-31.openstacklocal and query q=cpu file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/cpu [2/60] Dumping data for node=remotefs-31.openstacklocal and query q=nfsThroughput file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/nfsThroughput [3/60] Dumping data for node=remotefs-31.openstacklocal and query q=nfsIORate file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/nfsIORate [4/60] Dumping data for node=remotefs-31.openstacklocal and query q=nfsIOLatency file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/nfsIOLatency [5/60] Dumping data for node=remotefs-31.openstacklocal and query q=nfsErrors file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/nfsErrors [6/60] Dumping data for node=remotefs-31.openstacklocal and query q=nfsQueue file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/nfsQueue [7/60] Dumping data for node=remotefs-31.openstacklocal and query q=nfsThroughputPerOp file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/nfsThroughputPerOp [8/60] Dumping data for node=remotefs-31.openstacklocal and query q=smb2Writes file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/smb2Writes [9/60] Dumping data for node=remotefs-31.openstacklocal and query q=smb2Throughput file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/smb2Throughput [10/60] Dumping data for node=remotefs-31.openstacklocal and query q=smb2IORate file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/smb2IORate [11/60] Dumping data for node=remotefs-31.openstacklocal and query q=smb2IOLatency file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/smb2IOLatency [12/60] Dumping data for node=remotefs-31.openstacklocal and query q=smbConnections file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/smbConnections [13/60] Dumping data for node=remotefs-31.openstacklocal and query q=usage file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/usage [14/60] Dumping data for node=remotefs-31.openstacklocal and query q=gpfsCRUDopsLatency file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/gpfsCRUDopsLatency [15/60] Dumping data for node=remotefs-31.openstacklocal and query q=gpfsNumberOperations file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/gpfsNumberOperations [16/60] Dumping data for node=remotefs-31.openstacklocal and query q=gpfsNSDWaits file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/gpfsNSDWaits [17/60] Dumping data for node=remotefs-31.openstacklocal and query q=gpfsFSWaits file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/gpfsFSWaits [18/60] Dumping data for node=remotefs-31.openstacklocal and query q=gpfsVFSOpCounts file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/gpfsVFSOpCounts [19/60] Dumping data for node=remotefs-31.openstacklocal and query q=gpfsEventProducer file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/gpfsEventProducer [20/60] Dumping data for node=remotefs-31.openstacklocal and query q=netDetails file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/netDetails [21/60] Dumping data for node=remotefs-31.openstacklocal and query q=netErrors file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/netErrors [22/60] Dumping data for node=remotefs-31.openstacklocal and query q=compareNodes file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/compareNodes [23/60] Dumping data for node=remotefs-31.openstacklocal and query q=protocolThroughput file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/protocolThroughput [24/60] Dumping data for node=remotefs-31.openstacklocal and query q=protocolIORate file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/protocolIORate [25/60] Dumping data for node=remotefs-31.openstacklocal and query q=protocolIOLatency file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/protocolIOLatency [26/60] Dumping data for node=remotefs-31.openstacklocal and query q=ctdbHopCounts file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/ctdbHopCounts [27/60] Dumping data for node=remotefs-31.openstacklocal and query q=ctdbHopCountDetails file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/ctdbHopCountDetails [28/60] Dumping data for node=remotefs-31.openstacklocal and query q=ctdbCallLatency file: ./iss_perfdump_20250916_094011/remotefs-31.openstacklocal/ctdbCallLatency Performance data archive created: iss_perfdump_20250916_094011.tgz rm -rf ./iss_perfdump_20250916_094011 # - To archive the performance metric information collected in the last 200
seconds, issue this command:
The system displays output similar to this:mmdumpperfdata --remove-tree 200Using the following options: StartTime : EndTime : rem tree : True Target folder: ./iss_perfdump_20250916_094210 --- Process data for node: remotefs-32.openstacklocal with hostname:remotefs-32 --- [1/60] Dumping data for node=remotefs-32.openstacklocal and query q=cpu file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/cpu [2/60] Dumping data for node=remotefs-32.openstacklocal and query q=nfsThroughput file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/nfsThroughput [3/60] Dumping data for node=remotefs-32.openstacklocal and query q=nfsIORate file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/nfsIORate [4/60] Dumping data for node=remotefs-32.openstacklocal and query q=nfsIOLatency file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/nfsIOLatency [5/60] Dumping data for node=remotefs-32.openstacklocal and query q=nfsErrors file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/nfsErrors [6/60] Dumping data for node=remotefs-32.openstacklocal and query q=nfsQueue file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/nfsQueue [7/60] Dumping data for node=remotefs-32.openstacklocal and query q=nfsThroughputPerOp file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/nfsThroughputPerOp [8/60] Dumping data for node=remotefs-32.openstacklocal and query q=smb2Writes file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/smb2Writes [9/60] Dumping data for node=remotefs-32.openstacklocal and query q=smb2Throughput file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/smb2Throughput [10/60] Dumping data for node=remotefs-32.openstacklocal and query q=smb2IORate file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/smb2IORate [11/60] Dumping data for node=remotefs-32.openstacklocal and query q=smb2IOLatency file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/smb2IOLatency [12/60] Dumping data for node=remotefs-32.openstacklocal and query q=smbConnections file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/smbConnections [13/60] Dumping data for node=remotefs-32.openstacklocal and query q=usage file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/usage [14/60] Dumping data for node=remotefs-32.openstacklocal and query q=gpfsCRUDopsLatency file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/gpfsCRUDopsLatency [15/60] Dumping data for node=remotefs-32.openstacklocal and query q=gpfsNumberOperations file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/gpfsNumberOperations [16/60] Dumping data for node=remotefs-32.openstacklocal and query q=gpfsNSDWaits file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/gpfsNSDWaits [17/60] Dumping data for node=remotefs-32.openstacklocal and query q=gpfsFSWaits file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/gpfsFSWaits [18/60] Dumping data for node=remotefs-32.openstacklocal and query q=gpfsVFSOpCounts file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/gpfsVFSOpCounts [19/60] Dumping data for node=remotefs-32.openstacklocal and query q=gpfsEventProducer file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/gpfsEventProducer [20/60] Dumping data for node=remotefs-32.openstacklocal and query q=netDetails file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/netDetails [21/60] Dumping data for node=remotefs-32.openstacklocal and query q=netErrors file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/netErrors [22/60] Dumping data for node=remotefs-32.openstacklocal and query q=compareNodes file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/compareNodes [23/60] Dumping data for node=remotefs-32.openstacklocal and query q=protocolThroughput file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/protocolThroughput [24/60] Dumping data for node=remotefs-32.openstacklocal and query q=protocolIORate file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/protocolIORate [25/60] Dumping data for node=remotefs-32.openstacklocal and query q=protocolIOLatency file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/protocolIOLatency [26/60] Dumping data for node=remotefs-32.openstacklocal and query q=ctdbHopCounts file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/ctdbHopCounts [27/60] Dumping data for node=remotefs-32.openstacklocal and query q=ctdbHopCountDetails file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/ctdbHopCountDetails [28/60] Dumping data for node=remotefs-32.openstacklocal and query q=ctdbCallLatency file: ./iss_perfdump_20250916_094210/remotefs-32.openstacklocal/ctdbCallLatency Performance data archive created: iss_perfdump_20250916_094210.tgz rm -rf ./iss_perfdump_20250916_094210 #
See also
For more information, see mmperfmon command.
Location
/usr/lpp/mmfs/bin