包概述
Stat(Statistic)包包含若干内核过程,提供把用户定义和自动计算的统计量写入仿真期间创建的输出数据文件的机制。
仿真输出存储在输出向量(.ov)文件中。这些文件包含两类统计量:
- 向量统计量——动态的、面向事件的度量,随时间跟踪某个统计量;每个数据点都关联一个记录时刻。
- 标量统计量——仿真系统的非动态性能度量,例如统计量的均值、方差或极值。标量以单个值存储,并与一个标量名称相关联。
一个向量文件只能包含一次仿真运行的数据。仿真不能向已经构建好的输出向量文件中添加新数据。
除天线外,所有节点模块都会自动计算内置统计量。这些统计量可以通过统计量连线路由来影响进程,也可以被探测,使其变化的值出现在输出向量文件中。队列模块和处理器模块除了具有内置统计量外,还支持用户定义的输出统计量。这使得进程可以使用任意度量或算法计算单独命名的统计量,并随时间分别记录其值。
由于输出统计量按模块存储,它们适合用于观察模块内部的局部统计量。另一种统计量——全局统计量——不与特定模块关联,仿真中的所有进程都可以访问它。全局统计量可用于观察整体网络行为,例如所有穿越网络的数据包的实测时延,而不论其源或目的。
为方便起见,局部统计量和全局统计量都以字母数字名称引用。
Stat 包提供两种方式为统计量添加补充信息:注释(annotation)和标签(tag)。
- 注释在输出向量文件中为统计量名称附加一个标签。使用内核过程 op_stat_annotate() 添加注释。
- 统计量标签为统计量关联一个 name:value 对。标签提供关于统计量的更多细节,并允许在 Results Browser 中对相关统计量分组,从而更方便地访问仿真结果。使用内核过程 op_stat_tag_add_str()、op_stat_tag_add_int32()、op_stat_tag_add_int64() 和 op_stat_tag_add_dbl() 为统计量添加标签。
内核过程 op_stat_rename() 用于在输出向量文件中重命名统计量。
内核过程 op_stat_reg() 用于把指定名称转换为统计量句柄,供其他内核过程写入进程的局部或全局统计量。
内核过程 op_stat_obj_reg() 与 op_stat_reg() 类似,但不要求处理器上下文,可用于访问任意链路、路径、模块或子模块的局部统计量。
内核过程 op_stat_valid() 用于验证统计量句柄是否有效(即是否已注册)。对于维度化统计量,可能需要为未注册的统计量使用无效句柄。可以用 op_stat_invalid_get() 和 op_stat_invalid_set() 来管理这一点。
内核过程 op_stat_dim_size_get() 用于读取进程局部或全局统计量的维度数组值。
内核过程 op_stat_obj_dim_size_get() 与 op_stat_dim_size_get() 类似,但可以访问进程模型以外的对象(如路径、链路和需求)中的局部统计量。
内核过程 op_stat_write() 把一个与当前时间关联的值写入指定统计量。
变体内核过程 op_stat_write_t() 把一个与指定时间关联的值记录下来。
标量统计量可以在仿真期间的任何时刻记录。每个标量统计量只有一个值,代表整个仿真;标量值不与特定时间关联。内核过程 op_stat_scalar_write() 和 op_stat_scalar_write_symbol() 会自动把标量值记录到向量输出文件,因此无需使用 Probe Editor 指定探针。
除输出统计量外,处理器和队列模块还支持输入统计量,它们是统计量连线的目标点。输入统计量提供了把统计量连线用作一种进程间通信的能力。内核过程 op_stat_local_read() 返回指定统计量连线的当前值。