storstat volume -get

Gets the statistical and performance data related to storage volumes of a storage system. Selection criteria for the –get function can be specified using the parameters described below.

Please note that the output may be different for different storage systems

Syntax

storstat volume –get –system system [ –format format ] 

Parameters

–system system

Specifies the system name of the storage system the logical volume belongs to. Wildcards (*) are supported.

–format format

Specifies the output format. Refer to the description of the "Format parameter".

Return codes

Error Code	Name	Error Type
0	STORMAN_OK	Function successful.
3	STORMAN_VER_NOT_SUPP	Version not supported.
7	STORMAN_INV_PARAMETERS	Specified parameters invalid.
13	STORMAN_COMMUNIC_ERROR	Error in StorMan communication between client and server.
16	STORMAN_FAULT	Unexpected error in function.
18	STORMAN_NOT_FOUND	Matching object could not be provided.
21	STORMAN_FCT_NOT_POSSIBLE	Function rejected by provider.
22	STORMAN_RESOURCE_NOT_AVAILABLE	Provider or database not available.
36	STORMAN_AUTH_FAILED	User / password for StorMan not valid

Output

The output field DataVersion for ETERNUS DX/AF storage systems contains the information:

• DataVersion = 2: data provided via SMI-S (ETERNUS DX/AF)

The following volume specific metrics are provided for ETERNUS DX/AF (DataVersion = 2):

Name	Description
TimeLastSampled	Absolute point in time of last sampled statistical data. Format: yyyy-mm-dd hh:mm:ss.sss Example: 2016-01-13 13:56:15.000
DeviceID	Device Id of the volume
ReadIOs	Number of read IOs (Counter)
WriteIOs	Number of write IOs (Counter)
MBytesRead	Amount of MB read (Counter)
MBytesWritten	Amount of MB written (Counter)
KBytesRead	Amount of KB read (Counter)
KBytesWritten	Amount of KB written (Counter)
ReadHitIOs	Number of read hit IOs (Counter)
WriteHitIOs	Number of write hit IOs (Counter)
ReadIOTimeCounter	Time counter for read IOs (ms)
ReadHitIOTimeCounter	Time counter for read hit IOs (ms)
WriteIOTimeCounter	Time counter for write  IOs (ms)
WriteHitIOTimeCounter	Time counter for write Hit IOs (ms)

• All Counters are defined as UINT64 (the maximum value being 18446744073709551615). However overflow is handled by the provider. 

Examples

1. Output for logical volumes with –format xmlp (default)

   ETERNUS DX500 S3:

   storstat volume -get -system 4621347002 -format xmlp


   <Response>
   <Response>
     <ReturnCode>
       <Code>STORMAN_OK</Code>
       <CodeNumber>0</CodeNumber>
       <Text>successful</Text>
       <SubCode>0</SubCode>
       <SubCodeText>STORMAN_SUB_NONE</SubCodeText>
       <AdditionalInformation/>
       <MessageID>53</MessageID>
       <ConnectionID>5555D641C8740</ConnectionID>
     </ReturnCode>
     <Result>
       <StorageSystem>
         <StorageSystemName>4621347002</StorageSystemName>
         <StorageModel>STORMAN_STORAGE_MODEL_ETERNUS</StorageModel>
         <StorageVendor>STORMAN_STORAGE_VENDOR_FUJITSU</StorageVendor>
         <DataVersion>2</DataVersion>
         <StatusCode>0</StatusCode>
         <Status>successful</Status>
         <TimeLastSampled>2017-07-28 10:33:23.000</TimeLastSampled>
         <SampleInterval>300</SampleInterval>
         <StatisticsVolumes>
           <StatisticsVolume>
             <DeviceID>0</DeviceID>
             <TimeLastSampled>2017-07-28 10:33:23.000</TimeLastSampled>
             <ReadIOs>27</ReadIOs>
             <WriteIOs>0</WriteIOs>
             <KBytesRead>290</KBytesRead>
             <KBytesWritten>0</KBytesWritten>
             <MBytesRead>0</MBytesRead>
             <MBytesWritten>0</MBytesWritten>
             <ReadHitIOs>23</ReadHitIOs>
             <WriteHitIOs>0</WriteHitIOs>
             <ReadIOTimeCounter>45</ReadIOTimeCounter>
             <ReadHitIOTimeCounter>2</ReadHitIOTimeCounter>
             <WriteIOTimeCounter>0</WriteIOTimeCounter>
             <WriteHitIOTimeCounter>0</WriteHitIOTimeCounter>
           </StatisticsVolume>
           <StatisticsVolume>
             <DeviceID>1</DeviceID>
             <TimeLastSampled>2017-07-28 10:33:23.000</TimeLastSampled>
             <ReadIOs>23</ReadIOs>
             <WriteIOs>0</WriteIOs>
             <KBytesRead>46</KBytesRead>
             <KBytesWritten>0</KBytesWritten>
             <MBytesRead>0</MBytesRead>
             <MBytesWritten>0</MBytesWritten>
             <ReadHitIOs>22</ReadHitIOs>
             <WriteHitIOs>0</WriteHitIOs>
             <ReadIOTimeCounter>8</ReadIOTimeCounter>
             <ReadHitIOTimeCounter>1</ReadHitIOTimeCounter>
             <WriteIOTimeCounter>0</WriteIOTimeCounter>
             <WriteHitIOTimeCounter>0</WriteHitIOTimeCounter>
           </StatisticsVolume>

2. Output for logical volumes with –format std (default)

   ETERNUS DX500 S3:

   storstat volume -get -system 4621347002


   storage system name = 4621347002
     storage vendor      = STORMAN_STORAGE_VENDOR_FUJITSU
     storage model       = STORMAN_STORAGE_MODEL_ETERNUS
     status              = successful
     time last sampled   = 2016-06-06 15:01:42.000
     storage StatisticsVolume(s)
       DeviceID = 857
       TimeLastSampled = 2017-07-28 15:08:24.000
       ReadIOs = 30198
       WriteIOs = 0
       KBytesRead = 15099
       KBytesWritten = 0
       MBytesRead = 14
       MBytesWritten = 0
       ReadHitIOs = 30198
       WriteHitIOs = 0
       ReadIOTimeCounter = 2172
       ReadHitIOTimeCounter = 2172
       WriteIOTimeCounter = 0
       WriteHitIOTimeCounter = 0
    ...