Qustat information.

File format

Header Section

The Header section contain the Stornext version / hostname / filesystem name / Time stamp

# QuStat Rev,4.3.2
# Host,alpo1.mdh.quantum.com
# Module,FSM
# Group,alpo
# Recorded, time_t, 1363212001, date, 2013-03-13 17:00:01 CDT

Table Section

The rest of the file is separated in table groups. Each table contain a header and series of keys with data.

 
# Table,1,Name,VOPS
# Last Reset, Secs, 3601, time_t, 1363208400, date, 2013-03-13 16:00:00 CDT
# NAME,TYP,COUNT,MIN,MAX,TOT/LVL,AVG
VOP Lookup,TIM,97312,10,129778,26453704,272
VOP Open,TIM,292934,7,1086,7280427,25
VOP Close,TIM,292944,7,1596,6928432,24
VOP FullPthRvV2,TIM,6,40,123,548,91
VOP Mkdir V6,TIM,15,57,230,2130,142
VOP Create V6,TIM,9,280,1715,5819,647
VOP Remove,TIM,8,525,2472,10316,1290
VOP Rename,TIM,2,186,350,536,268
VOP Get AttrV4,TIM,38,15,916,3547,93
VOP Read DirV2,TIM,6270,15,269,401481,64
VOP Read Link,TIM,4701,7,301,141128,30
VOP Set Attr,TIM,6347,19,2654,407260,64
VOP GtResynAtV2,TIM,31,11,859,3098,100
VOP Flsh 2 PC,TIM,10648,4,1149,1965733,185
VOP PnchHoleAPI,TIM,4,124,178,629,157

Table Header

The table header contain the name, time since last snapshot and the key description.

Key section.

Each entry is a csv line with the field defined in the key description

Exemple: We have the VOP Open of type TIM which have a COUNT value of 292934.

#   NAME,TYP,  COUNT, MIN,  MAX, TOT/LVL, AVG
VOP Open,TIM, 292934,   7, 1086, 7280427, 25

Key value

Each key usually have the following values TYPE,COUNT,MIN,MAX,TOT/LVL,AVG

TYPE:

The following type are available.

CNT => QUSTAT_TYPE_CNT /**< Count-type events (Cnt) */

* - Cnt = Incremented once for each occurrence.                                          
* - Min = Zero                                                                           
* - Max = Zero                                                                           
* - Tot = Incremented once for each occurrence.

LVL => QUSTAT_TYPE_LVL /**< Level-type events (Lvl) */

* - Cnt = Incremented once for each occurrence.                                          
* - Min = The smallest value recorded                                                    
* - Max = The largest value recorded                                                     
* - Tot = The most recent value recorded

SUM => QUSTAT_TYPE_SUM /**< Sum-type events (Sum) */

* - Cnt = Incremented once for each occurrence.                                          
* - Min = The smallest value recorded                                                    
* - Max = The largest value recorded                                                     
* - Tot = The sum of all qustat_val's

TIM => QUSTAT_TYPE_TIME /**< Timed-type events (Tm) */

* - Cnt = Incremented once for each occurrence.                                          
* - Min = Fastest transaction.                                                           
* - Max = Slowest transaction.                                                           
* - Tot = Total accumulated time for all transactions.

Tools to Process QuStat

The tools to work analyze qustat data are maintained with SVN. You can dowload them from http://bo.quantum.com/viewvc/trunk/tools/stornext_sustaining/qustat/?root=jo

qustatsparser.pl(v1.1.5)

The qustatsparser.pl was created by Mark Cookson. It merge all the qustat in a directory into a single csv. Each Columns is a field and each row are value at a given timestamp.

qustat_converter.pl(v2.0.5)

Here is an example of running the script on alpo.

$ qustat_converter.pl -S 2013-04-15 alpo1.mdh.quantum.com result
Will skip all data before epoch(1365998400) 2013-04-15 00:00:00
Source directory: 'alpo1.mdh.quantum.com' 
Destination directory: 'result' 
Processing timestamp [1368806401] 
File Creation: .................... DONE.

qustat_plotgraph.sh(0.9.0)

If you want to compare in the PhysIO the read and the write on Jan 18th you can do this.

$ ./qustat_plotgraph.sh  -j -S 2013-01-18 -E 2013-01-19 toto/4.3.0-Phys_IO_HBA_5_LUN_0_alpo_meta01.csv 12,22
Will create 4.3.0-Phys_IO_HBA_5_LUN_0_alpo_meta01-12_22.jpg File