包概述

应用延迟跟踪包是一组内核过程,可用于在离散事件仿真中跟踪应用延迟。你可以使用这些内核过程为自定义进程模型添加应用延迟跟踪。

应用延迟跟踪(ADT)通过对指定应用生成的数据包打标签来工作。这样,当数据包在网络中传输时,应用延迟就会被记录下来。在仿真执行期间,应用延迟跟踪会将原始数据写入若干临时文件。这些文件是

  • 对象 ID 文件(<base_name>.0.adt.tmp)
  • 应用类型文件(<base_name>.1.adt.tmp)
  • 应用实例文件(<base_name>.2.adt.tmp)
  • 消息文件(<base_name>.3.adt.tmp)
  • 事件文件(<base_name>.4.adt.tmp)

这些文件由 op_apptrack_create() 创建(路径与基础名称也在该过程中指定)。

仿真结束后,应用延迟跟踪会处理这些临时文件,生成可供 Application Segment Tracking Viewer 显示的最终文件(<base_name>.adt)。

工作流程

以下是进程模型实现应用延迟跟踪通常应包含的步骤。

  1. 调用 op_apptrack_create() 初始化应用延迟跟踪。
  2. 对每个将被跟踪的应用类型(如 HTTP),调用 op_apptrack_type_register() 进行注册。
  3. 对每个要跟踪的应用实例(即特定节点上的特定应用类型),调用 op_apptrack_instance_create() 获取用于跟踪的 ID。
  4. 每当进程模型创建与某个被跟踪应用实例相关的数据包时,调用 op_apptrack_pk_tag() 为其打上标记。
  5. 当数据包到达目的地时,调用 op_apptrack_pk_reception_record() 记录结束时间。
  6. 若要在仿真结束前停止跟踪某个应用实例的延迟,调用 op_apptrack_instance_complete()。
  7. 在仿真结束时,调用 op_apptrack_destroy() 销毁 ADT 状态,并将收集到的数据处理为 Application Segment Tracking Viewer 可显示的格式。

除标准工作流中的内核过程外,本包还提供一些用于特殊需求的内核过程。

使用 op_apptrack_pk_type_info_get() 可以了解已打标签的数据包中包含哪些应用类型(以 ID 表示)。要获取与某个 ID 对应的应用类型名称,可使用 op_apptrack_type_name_get()。

万一需要停止跟踪某个数据包,可以用 op_apptrack_pk_tag_clear() 取消其标签。

ADT 跟踪的时间假设数据包的发送与接收按常规方式在 MAC 层处理。如果发送与接收在其他位置处理(例如,数据包接收由更高层而非 RCVR 模块处理),可以使用 op_apptrack_tx_enqueue_flag()、op_apptrack_rx_processing_disable() 和 op_apptrack_rx_record() 来确保记录有效的发送与接收时间。

应用延迟跟踪的示例实现,参见 <install_dir>\<reldir>\models\std\applications\apptrack_support.ex.c。