统计量线的配置
统计量线是一种物理连接,它将一个模块的源端口连接到同一节点中另一个模块的目的地端口。统计量线的源端口称为输出统计量,目的地端口称为输入统计量。统计量线的源模块可以是任何生成统计量的模块。然而,只有处理器和队列模块可以作为统计量线的目的地,因为这些是唯一能够包含接收统计量值的进程的模块。
在图形界面上,统计量线的表示方式与数据包流类似,但以虚线连接路径加以区分(数据包流使用实线表示)。统计量线的输入端口以整数索引表示,索引范围为 0 到 99。
图 222:具有扇出与扇入的统计量线连接

输入统计量可以接受多条统计量线,将经由多个输出统计量(可能来自不同模块)发送的各个值序列合并成一个值序列,供本地模块使用。
统计量线可以用于传输仿真内核所知的预定义输出统计量中的任何值。在大多数情况下,这些值与通过统计量探针在仿真输出向量文件中收集的值相同。对于处理器以外的所有模块,输出统计量可以是由仿真内核自动计算的预定义值,每当发生变化时就传输一个新值。例如,队列模块生成的统计量包括它包含的数据包数量或数据包在队列中停留的平均时间;接收机模块为它的每个信道生成吞吐量、利用率等统计量。关于每种模块可用的预定义统计量的完整定义,见第 2 章“节点参考”第 8 页。
由于队列模块和进程模块的意义与行为可以通过指派用户定义的进程模型来完全通用地指定,因此为自定义应用提供了通用输出统计量。对于每个队列或处理器模块,你可以声明任意数量的输出统计量。这些输出统计量可以作为统计量线的源,应源模块内进程的请求向目的地传送新值。进程可以通过调用内核过程 op_stat_write() 并指定统计量线所连接的输出统计量的索引,在特定的统计量线上发起一个新统计量值的传输。任何浮点数都可以通过这种方式发送到统计量线的目的地。
除了新值的生成方式之外,无论由预定义统计量还是通用统计量驱动,统计量线的工作方式完全相同。当统计量线的源生成一个新值时,根据统计量线的“intrpt method”属性所赋的值,可能出现两种行为。如果中断方式为“forced”,则统计量传输不可能有延迟,目的地模块的输入统计量会立即发生变化。但如果中断方式为“scheduled”(默认值),则目的地模块输入统计量处的到达时间基于统计量线的“delay”属性计算。
当新的统计量值到达目的地模块时,它被存入输入统计量,取代先前的值。此后,目的地模块中的任何进程都可以随时(直到下一次替换)使用内核过程 op_stat_local_read() 获取该值。调用该内核过程时必须指定输入统计量的整数索引。请注意,先前的值已无法获取,因为它已被覆盖。
除了每次更新时向目的地模块提供新的统计量值之外,统计量线还可以提供对变化的主动通知。当满足适当条件时,会为目的地模块生成一个统计量事件,以此形式进行通知。如果启用了相应的中断,该统计量事件随后可能导致模块中某个进程的中断。有关限制中断的更多信息,见第 4 章“建模框架”第 80 页。
统计量线可以配置为仅当其目的地的输入统计量值发生特定类型的变化时才生成事件。一组称为触发器的判据用于决定何时生成事件。触发器作为统计量线对象的属性来指定,刻画六种类型的值变化。要使统计量值的变化产生事件,统计量线已启用的触发器所代表的条件的逻辑或必须为真;换句话说,下面详列的触发条件中至少有一个必须满足,且相应的触发器属性不得设置为“disabled”值。
- 上升沿触发——新接收的值严格大于先前接收的值。
- 下降沿触发——新接收的值严格小于先前接收的值。
- 重复值触发——新接收的值与先前接收的值完全相同。
- 过零触发——新接收的值与先前接收的值符号相反,或者新接收的值恰好为零。
- 低阈值触发——新接收的值小于或等于用户指定的低阈值。
- 高阈值触发——新接收的值大于或等于用户指定的高阈值。
统计量线触发器的默认配置是启用上升沿和下降沿触发器,禁用其余全部。这意味着只要输入统计量的值发生任何变化就会生成统计量事件;但如果收到的统计量更新与先前值相同,则不会生成事件。另一种常见配置是在下降沿和上升沿触发之外启用重复值触发,使任何接收到的统计量值都能产生主动通知。最后,第三种常见配置是禁用全部触发器,实现被动的统计量传输;换句话说,目的地模块可以观察统计量线源处生成的统计量值,但永远不会因此收到中断。