ipmctl-show-performance - Man Page
Shows performance metrics for one or more PMem modules
Synopsis
ipmctl show [OPTIONS] -performance [METRICS] [TARGETS]
Description
Shows performance metrics for one or more PMem modules.
Options
- -h, ā-help
Displays help for the command.
- -ddrt
Used to specify DDRT as the desired transport protocol for the current invocation of ipmctl.
- -smbus
Used to specify SMBUS as the desired transport protocol for the current invocation of ipmctl.
NoteThe -ddrt and -smbus options are mutually exclusive and may not be used together.
- -o (text|nvmxml), -output (text|nvmxml)
Changes the output format. One of: "text" (default) or "nvmxml".
Metrics
Restricts output to a specific performance metric by supplying the metric name. See Return Data for more information. One of:
- MediaReads
- MediaWrites
- ReadRequests
- WriteRequests
- TotalMediaReads
- TotalMediaWrites
- TotalReadRequests
- TotalWriteRequests
The default is to display all performance metrics.
Targets
- -dimm [DimmIDs]
Restricts output to the performance metrics for specific PMem module by supplying one or more comma separated PMem module identifiers. The default is to display performance metrics for all manageable PMem module.
Examples
Shows all performance metrics for all PMem modules in the server.
ipmctl show -dimm -performance
Shows the number of 64 byte reads since last AC cycle for all PMem modules in the server.
ipmctl show -dimm -performance MediaReads
Limitations
In order to successfully execute this command:
- The caller must have the appropriate privileges.
- The specified PMem modules must be manageable by the host software.
Return Data
This command displays a table of the specified metrics for each specified PMem module. Applying a specific PMem module target limits the rows in the table. Applying a specific metric name target limits the columns in the table.
- DimmID
The PMem module identifier
- MediaReads
Number of 64 byte reads from media on the PMem module since last AC cycle.
- MediaWrites
Number of 64 byte writes to media on the PMem module since last AC cycle.
- ReadRequests
Number of DDRT read transactions the PMem module has serviced since last AC cycle.
- WriteRequests
Number of DDRT write transactions the PMem module has serviced since last AC cycle.
- TotalMediaReads
Number of 64 byte reads from media on the PMem module over its lifetime.
- TotalMediaWrites
Number of 64 byte writes to media on the PMem module over its lifetime.
- TotalReadRequest
Number of DDRT read transactions the PMem module has serviced over its lifetime.
- TotalWriteRequest
Number of DDRT write transactions the PMem module has serviced over its lifetime.