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.