16.4. 子集合

16.4.1. 统计数据子集合

每个浮动磁盘都包括一个 statistics 子集合来提供与磁盘相关的统计数据。每个 statistic 包括以下项:

表 16.2. 虚拟机磁盘统计数据的项

类型描述
name字符串统计数据记录的唯一标识。
description字符串统计数据的描述。
unit字符串统计数据值所使用的单位。
typeGAUGECOUNTER统计数据类型。
values type=INTEGERDECIMAL统计数据值的数据类型。
value复杂数据包括 datum 的数据集。
datum请参阅 values typevalue 中的一条数据。
disk id=关系与包括 disk 资源的关系。
下表列出了浮动磁盘的统计数据类型信息。

表 16.3. 磁盘统计数据类型

名称
描述
data.current.read
读磁盘操作的数据传输频率(字节/每秒)
data.current.write
写磁盘操作的数据传输频率(字节/每秒)

例 16.3. 虚拟机统计数据子集合的 XML 表述

<statistics>
    <statistic id="33b9212b-f9cb-3fd0-b364-248fb61e1272"
      href="/api/disks/f28ec14c-fc85-43e1-818d-96b49d50e27b/statistics/
      33b9212b-f9cb-3fd0-b364-248fb61e1272">
        <name>data.current.read</name>
        <description>Read data rate</description>
        <values type="DECIMAL">
            <value>
                <datum>0</datum>
            </value>
        </values>
        <type>GAUGE</type>
        <unit>BYTES_PER_SECOND</unit>
        <disk id="f28ec14c-fc85-43e1-818d-96b49d50e27b" 
          href="/api/disks/f28ec14c-fc85-43e1-818d-96b49d50e27b"/>
    </statistic>
    ...
</statistics>

注意

这个 statistics 子集合是只读的。