If the -f parameter is specified for the dlmperfinfo utility, performance information will be output to the specified file#. The output item names and values are enclosed in double quotation marks (") and delimited by commas (CSV format). For details on the information that is output, see Table 1.
- #
If you specify 0 for the -c parameter, _YYYYMMDDhhmmss.csv will be added to the end of the name of the specified CSV file to which the performance information is to be output. YYYYMMDDhhmmss indicates the time (coordinated universal time) at which the file was created.
An example of an output CSV file is provided below.
Example: Executing the utility
# /opt/DynamicLinkManager/bin/dlmperfinfo -i 300 -c 2 -f file-name KAPL13031-I The utility for displaying HDLM performance information (dlmperfinfo) will now start. Start time = 2017/08/30 13:34:55 KAPL13047-I Performance information is now being measured. (1 / 2) KAPL13047-I Performance information is now being measured. (2 / 2) KAPL13032-I The utility for displaying HDLM performance information (dlmperfinfo) finished. End time = 2017/08/30 13:44:56
Example: Outputting a CSV file
[Paths:000008] "UTC","Date","Time","LDEV","HDevName","Device","PathID","Count_R/s","Count_W/s","MB_R/s","MB_W/s","Time_R","Time_W" "20170830T044335","20170830","134335","VSP_5000.39303.000034","sddlmaa","/dev/sdn","000000","30","3","0.1173","0.0134","166.2703","625.4919" "20170830T044335","20170830","134335","VSP_5000.39303.000034","sddlmaa","/dev/sdj","000001","25","9","0.0970","0.0366","180.1263","637.2924" "20170830T044335","20170830","134335","VSP_5000.39303.000035","sddlmab","/dev/sdo","000002","29","4","0.1137","0.0154","179.5969","663.3387" "20170830T044335","20170830","134335","VSP_5000.39303.000035","sddlmab","/dev/sdk","000003","24","9","0.0952","0.0335","229.5274","683.1288" "20170830T044335","20170830","134335","VSP_Ex00.416044.0000DC","sddlmac","/dev/sdp","000004","28","7","0.1083","0.0254","186.9855","627.8596" "20170830T044335","20170830","134335","VSP_Ex00.416044.0000DC","sddlmac","/dev/sdl","000005","27","6","0.1049","0.0245","195.8313","586.1036" "20170830T044335","20170830","134335","VSP_Ex00.416044.0000DD","sddlmad","/dev/sdq","000006","27","6","0.1073","0.0240","172.0459","632.1648" "20170830T044335","20170830","134335","VSP_Ex00.416044.0000DD","sddlmad","/dev/sdm","000007","27","7","0.1059","0.0259","189.1432","605.9836" "UTC","Date","Time","LDEV","HDevName","Device","PathID","Count_R/s","Count_W/s","MB_R/s","MB_W/s","Time_R","Time_W" "20170830T044835","20170830","134835","VSP_5000.39303.000034","sddlmaa","/dev/sdn","000000","27","5","0.1069","0.0193","176.7588","657.4251" "20170830T044835","20170830","134835","VSP_5000.39303.000034","sddlmaa","/dev/sdj","000001","26","8","0.1007","0.0296","193.0229","576.9321" "20170830T044835","20170830","134835","VSP_5000.39303.000035","sddlmab","/dev/sdo","000002","28","4","0.1100","0.0168","165.8784","586.8735" "20170830T044835","20170830","134835","VSP_5000.39303.000035","sddlmab","/dev/sdk","000003","25","8","0.0975","0.0320","181.1106","594.3750" "20170830T044835","20170830","134835","VSP_Ex00.416044.0000DC","sddlmac","/dev/sdp","000004","26","7","0.1021","0.0267","168.9082","620.6742" "20170830T044835","20170830","134835","VSP_Ex00.416044.0000DC","sddlmac","/dev/sdl","000005","27","6","0.1055","0.0220","182.2214","582.3260" "20170830T044835","20170830","134835","VSP_Ex00.416044.0000DD","sddlmad","/dev/sdq","000006","26","7","0.1020","0.0264","183.5498","1642.2365" "20170830T044835","20170830","134835","VSP_Ex00.416044.0000DD","sddlmad","/dev/sdm","000007","27","6","0.1043","0.0223","192.6760","570.5610"
Note
If you specify 0 for the -c parameter, the utility will be executed in succession until the user stops the execution. To stop the utility, press Ctrl+C to terminate the processing.
Before outputting a CSV file, calculate the necessary disk capacity by using the following formula to ensure that there is sufficient space on the disk to which the CSV file is to be output. In addition, delete CSV files that are no longer required.
When 0 is specified in the -c parameter:
When the -a parameter is specified:
1025 bytes * ((number-of-paths + 1) * value-specified-for-the-m-parameter) + 1 * value-specified-for-the-r-parameter (bytes)
When the -a parameter is not specified:
671 bytes * ((number-of-paths + 1) * value-specified-for-the-m-parameter) + 1 * value-specified-for-the-r-parameter (bytes)
When 0 is not specified in the -c parameter:
When the -a parameter is specified:
1025 bytes * ((number-of-paths + 1) * value-specified-for-the-c-parameter + 1) (bytes)
When the -a parameter is not specified:
671 bytes * ((number-of-paths + 1) * value-specified-for-the-c-parameter + 1) (bytes)
- Example 1: When collecting performance information 288 times with the -a parameter specified in an environment with 3,060 paths
When dlmperfinfo -c 288 -f CSV-file-name -a is executed, the file size is as follows:
1025 * ((3060 + 1) * 288 + 1) = 903608225 (bytes) (approx. 862 MB)
- Example 2: When collecting files for one year by assuming that the data collected in intervals of one minute in a single day is one file, with the-a parameter specified in an environment with 500 paths
The -m parameter is calculated as follows: 60 minutes * 24 hours = 1440, and the -r parameter is calculated as follows: the number of days in a year + 1 = 366. Therefore, when dlmperfinfo -i 60 -c 0 -f CSV-file-name -m 1440 -r 366 -a is executed, the file size is as follows:
1025 * (500 + 1) * (1440+1) * 366 = 270836166150 (bytes) (approx. 252.2 GB)
- Example 3: When keeping the total size of files to no more than 2 TB by assuming the number of measurements for a single file to be 1,440, with the -a parameter specified in an environment with the 1,000 paths
Value of the -r parameter = 2 * 10244 / (1025 * 1001 * 1441) ≈ 1487.3 (files)
This means that you can create up to 1,487 files to keep the total size of the files to no more than 2 TB, and dlmperfinfo -c 0 -f CSV-file-name -m 1440 -r 1487 -a can be executed.
Use the following formula to obtain the number of lines to be output in a CSV file. Calculate the number of lines to be output in a single file to adjust the number of measurements.
When 0 is specified in the -c parameter:
(number-of-paths + 1) * value-specified-for-the-m-parameter + 1
Note that, if you execute the utility with the -t parameter specified to hide the header, the number of lines will be as follows:
number-of-paths * value-specified-for-the-m-parameter
When 0 is not specified in the -c parameter:
(number-of-paths + 1) * value-specified-for-the-c-parameter + 1
Note that, if you execute the utility with the -t parameter specified to hide the header, the number of lines will be as follows:
number-of-paths * value-specified-for-the-c-parameter