Collecting details of the issues from performance monitoring tools
This topic describes how to collect details of issues that you might encounter in IBM Storage Scale by using performance monitoring tools.
With IBM Storage Scale, system administrators can monitor the performance of GPFS and the communications protocols that it uses. Issue the mmperfmon query command to query performance data.
Note: If you issue the mmperfmon query command without any additional
parameters, you can see a list of options for querying performance-related information, as shown in
the following sample output:
Usage:
mmperfmon query Metric[,Metric...] | Key[,Key...] | NamedQuery [StartTime EndTime | Duration] [Options]
OR
mmperfmon query compareNodes ComparisonMetric [StartTime EndTime | Duration] [Options]
where
Metric metric name
Key a key consisting of node name, sensor group, optional additional filters,
metric name, separated by pipe symbol
e.g.: "cluster1.ibm.com|CTDBStats|locking|db_hop_count_bucket_00"
NamedQuery name of a pre-defined query
ComparisonMetric name of a metric to be compared if using CompareNodes
StartTime Start timestamp for query
Format: YYYY-MM-DD-hh:mm:ss
EndTime End timestamp for query. Omitted means: execution time
Format: YYYY-MM-DD-hh:mm:ss
Duration Number of seconds into the past from today or <EndTime>
Options:
-h, --help show this help message and exit
-N NodeName, --Node=NodeName
Defines the node that metrics should be retrieved from
-b BucketSize, --bucket-size=BucketSize
Defines a bucket size (number of seconds), default is
1
-n NumberBuckets, --number-buckets=NumberBuckets
Number of buckets ( records ) to show, default is 10
--filter=Filter Filter criteria for the query to run
--format=Format Common format for all columns
--csv Provides output in csv format.
--raw Provides output in raw format rather than a pretty
table format.
--nice Use colors and other text attributes for output.
--resolve Resolve computed metrics, show metrics used
--short Shorten column names if there are too many to fit into
one row.
--list=List Show list of specified values (overrides other
options). Values are all, metrics, computed, queries,
keys.
Possible named queries are:
compareNodes - Compares a single metric across all nodes running sensors
cpu - Show CPU utilization in system and user space, and context switches
ctdbCallLatency - Show CTDB call latency.
ctdbHopCountDetails - Show CTDB hop count buckets 0 to 5 for one database.
ctdbHopCounts - Show CTDB hop counts (bucket 00 = 1-3 hops) for all databases.
gpfsCRUDopsLatency - Show GPFS CRUD operations latency
gpfsFSWaits - Display max waits for read and write operations for all file systems
gpfsNSDWaits - Display max waits for read and write operations for all disks
gpfsNumberOperations - Get the number of operations to the GPFS file system.
gpfsVFSOpCounts - Display VFS operation counts
netDetails - Get details about the network.
netErrors - Show network problems for all available networks: collisions, drops, errors
nfsErrors - Get the NFS error count for read and write operations
nfsIOLatency - Get the NFS IO Latency in nanoseconds per second
nfsIORate - Get the NFS IOps per second
nfsQueue - Get the NFS read and write queue size in bytes
nfsThroughput - Get the NFS Throughput in bytes per second
nfsThroughputPerOp - Get the NFS read and write throughput per op in bytes
objAcc - Object account overall performance.
objAccIO - Object account IO details.
objAccLatency - Object proxy Latency.
objAccThroughput - Object account overall Throughput.
objCon - Object container overall performance.
objConIO - Object container IO details.
objConLatency - Object container Latency.
objConThroughput - Object container overall Throughput.
objObj - Object overall performance.
objObjIO - Object overall IO details.
objObjLatency - Object Latency.
objObjThroughput - Object overall Throughput.
objPro - Object proxy overall performance.
objProIO - Object proxy IO details.
objProThroughput - Object proxy overall Throughput.
protocolIOLatency - Compare latency per protocol (smb, nfs, object).
protocolIORate - Get the percentage of total I/O rate per protocol (smb, nfs, object).
protocolThroughput - Get the percentage of total throughput per protocol (smb, nfs, object).
smb2IOLatency - Get the SMB2 I/O latencies per bucket size ( default 1 sec )
smb2IORate - Get the SMB2 I/O rate in number of operations per bucket size ( default 1 sec )
smb2Throughput - Get the SMB2 Throughput in bytes per bucket size ( default 1 sec )
smb2Writes - Count, # of idle calls, bytes in and out and operation time for smb2 writes
smbConnections - Number of smb connections
usage - Show CPU, memory, storage and network usage
For more information on monitoring performance and analyzing performance-related issues, see mmperfmon command and Using the performance monitoring tool.