探针对象属性说明

anim start

该属性指定一个仿真时间窗口的起点,在该窗口内运行该探针所描述的动画。它与“anim stop”属性配合使用,用以定义一个仿真时间窗口。默认值 0.0 秒对应仿真时间的起点。

Editing Simulation
Data Type double double
Access read/write read
Default Value 0.0
Units seconds
Constraints 0.0 <= anim start <= anim stop

anim stop

该属性指定一个仿真时间窗口的终点,在该窗口内运行该探针所描述的动画。它与“anim start”属性配合使用,用以定义一个仿真时间窗口。默认值“infinite”对应仿真时间的终点。

Editing Simulation
Data Type double double
Access read/write read
Default Value infinite
Units seconds
Constraints 0.0 <= anim start <= anim stop

attribute

该必填属性指定要从中采集数据的仿真属性或对象属性的名称。若未指定“object”属性,则可以指定网络中进程模型所定义的任何仿真属性。若指定了“object”属性,则只能选择指定对象的属性。

Editing Simulation
Data Type enumerated string
Access read/write read
Default Value
Units
Constraints

background color

该属性指定统计量所在动画面板的外框(围绕绘图区域的边框部分)颜色。该属性的取值形如 RGBnnn,其中每个整数 n 表示一种颜色强度。第一位数字表示红色,第二位表示绿色,第三位表示蓝色。因此,RGB000 对应黑色,RGB333 对应白色,RGB300 对应红色,依此类推。

Editing Simulation
Data Type color color
Access read/write read
Default Value RGB222
Units
Constraints

capture mode

该属性指定在将采集到的值写入仿真输出之前如何处理这些值。在 normal 模式下,所有值都未经处理直接写入。其他模式会修改或丢弃取值,以减少输出数据的体量,或呈现统计量的另一种视角。有关所支持的捕获模式的更多信息,参见第 10 章“Simulation Design”第 375 页。

Editing Simulation
Data Type string string
Access read/write read
Default Value normal
Units
Constraints normal, sample, bucket, glitch removal

channel

该必填属性指定作为统计量来源的信道名称。

Editing Simulation
Data Type enumerated string
Access read/write read
Default Value
Units
Constraints 有效的信道名称

critical low value

该属性指定一个取值,低于该值的统计量取值被视为严重偏低。它与“warning low value”、“warning high value”和“critical high value”属性一起,定义严重偏低、偏低、正常、偏高和严重偏高五个取值范围,统计量图形中将以绿色、黄色和红色背景加以标示。

Editing Simulation
Data Type booldouble booldouble
Access read/write read
Default Value
Units
Constraints 数值或“disabled”

critical high value

该属性指定一个取值,高于该值的统计量取值被视为严重偏高。它与“critical low value”、“warning low value”和“warning high value”属性一起,定义严重偏低、偏低、正常、偏高和严重偏高五个取值范围,统计量图形中将以绿色、黄色和红色背景加以标示。

Editing Simulation
Data Type booldouble booldouble
Access read/write read
Default Value
Units
Constraints 数值或“disabled”

demand

该必填属性指定作为统计量来源的需求名称。

Editing Simulation
Data Type string string
Access read/write read
Default Value
Units
Constraints 有效的需求名称

draw style

该属性指定统计量首次在分析面板中显示时的绘制方式。你也可以在请求采集该统计量时指定绘制样式,即在 Statistic 弹出菜单中指定样式(参见第 3 章“Project Editor”第 89 页)。

Editing Simulation
Data Type enumerated enumerated
Access read/write read
Default Value linear
Units
Constraints sample-hold, bar, discrete, linear, square-wave, bar chart

group

统计量按协议(例如 IP 或以太网)或按应用类型(例如客户端 FTP 或服务器端 Email)分组组织。这一只读属性显示所属组的名称。

统计量浏览器先按类型(全局、模块、节点、链路、动画)显示统计量,再按组显示。浏览器所显示的统计量和分组,取决于你是在工作区中右键单击(显示全局统计量)还是在某个特定对象上右键单击。

Editing Simulation
Data Type string string
Access read read
Default Value none
Units
Constraints

initial width

该属性指定动画面板 x 轴的初始宽度(以秒计)。若“scrolling”属性处于启用状态,宽度将保持该值不变。

Editing Simulation
Data Type double double
Access read/write read
Default Value 0.0
Units seconds
Constraints

label

为该属性赋予非空取值会改变定制动画探针的功能:它不再普遍启用被探测对象(即子网、节点或模块)内发出的动画请求,而是选择性地启用那些引用特定动画查看器 ID 的动画请求。该动画查看器 ID 与定制动画探针相关联,必须通过 KP op_anim_lprobe_anvid() 获取。该 KP 接受一个参数,该参数必须与探针“label”属性的取值相匹配,才能返回该探针关联的查看器 ID。

通过引用由 op_anim_lprobe_anvid() 获得的查看器 ID,动画 KP 调用建立起对存在适当标注的定制动画探针的依赖。因此,带 label 的定制动画探针可用于启用模型的特定定制动画能力,这些能力由一个约定好的名称来指定。

Editing Simulation
Data Type string string
Access read/write read
Default Value
Units
Constraints

该必填属性指定作为统计量来源的链路名称。

Editing Simulation
Data Type string string
Access read/write read
Default Value
Units
Constraints 有效的链路名称

module

该属性指定作为动画请求来源或被采集统计量来源的模块名称。它必须与“subnet”和“node”属性配合使用,以唯一地指定所关注的模块。如果探针旨在为整个节点或整个子网启用动画或采集统计量,该属性应留空。

统计量探针

“submodule”属性可用于指定模块内的子模块作为统计量的来源。若所希望的统计量是已提升到节点级的模块或子模块统计量,该属性可以留空。

自动动画探针

目前,模块级探针所支持的唯一自动动画表示是“state tracking”,它允许对进程在其 STD 中的转移进行可视化。

Editing Simulation
Data Type string string
Access read/write read
Default Value
Units
Constraints 有效的模块名称

name

该属性是一个用于为探针创建名称的文本字符串。它仅用于组织目的,对探针的运行没有任何影响。它允许你为探针指定名称,从而更容易识别其功能,并便于在报告中加以识别。默认值为“pb_n”,其中 n 是一个整数,从 1 开始,每创建一个新探针便递增 1。

Editing Simulation
Data Type string string
Access read/write read
Default Value “pb_n”:n 为整数
Units
Constraints

node

统计量探针

这是一个必填属性,指定作为被采集统计量来源的节点名称。要直接探测模块或子模块,请为“module”和/或“submodule”属性指定取值。

动画探针

该属性保存作为动画请求来源的节点名称,或待动画模块的父节点名称。若“module”属性留空,探针适用于节点对象本身;否则,探针适用于该节点内指定的模块。如果探针旨在为整个子网启用动画,该属性应留空。

自动动画探针——目前,节点级探针所支持的唯一自动动画表示是“packet flows”,它跟踪模块之间数据包流上的数据包流动。

Editing Simulation
Data Type string string
Access read/write read
Default Value
Units
Constraints 有效的节点名称

object

该属性指定其属性将被探测的对象的名称。“object”属性可以留空,此时探针只能应用于仿真属性。该对象可以是子网、节点、链路、模块或子模块。必须使用标准的层次化对象命名格式来指定该对象。

Editing Simulation
Data Type string string
Access read/write read
Default Value
Units
Constraints

ordinate label

若该属性非空,它指定探针所采集统计量使用的名称。它同时适用于标量统计量和向量统计量。它通常用于覆盖并简化系统自动分配给统计量的默认名称(默认名称基于被探测对象的层次化名称)。

Editing Simulation
Data Type string string
Access read/write read
Default Value
Units
Constraints

panel height

该属性指定统计量所在动画面板的高度(以像素计)。它与“panel width”、“panel x”和“panel y”属性一起,定义动画面板在动画查看器内所占的区域。

Editing Simulation
Data Type integer integer
Access read/write read
Default Value 304
Units pixels
Constraints >= 100

panel name

该属性指定显示统计量的面板名称。如果多个统计量动画探针指定了相同的窗口名称和相同的面板名称,所得的图形将合并到同一个统计量动画面板中。面板的坐标轴会自动按需调整,以显示所有存在的跟踪记录。

Editing Simulation
Data Type string string
Access read/write read
Default Value
Units
Constraints

panel width

该属性指定统计量所在动画面板的宽度(以像素计)。它与“panel height”、“panel x”和“panel y”属性一起,定义动画面板在动画查看器内所占的区域。

Editing Simulation
Data Type integer integer
Access read/write read
Default Value 442
Units pixels
Constraints >= 100

panel x

该属性指定统计量所在动画面板左上角的 x 坐标(以像素计)。它与“panel width”、“panel height”和“panel y”属性一起,定义动画面板在动画查看器内所占的区域。

Editing Simulation
Data Type integer integer
Access read/write read
Default Value 10
Units pixels
Constraints >= 0

panel y

该属性指定统计量所在动画面板左上角的 y 坐标(以像素计)。它与“panel width”、“panel height”和“panel x”属性一起,定义动画面板在动画查看器内所占的区域。

Editing Simulation
Data Type integer integer
Access read/write read
Default Value 10
Units pixels
Constraints >= 0

path

该必填属性指定作为统计量来源的路径名称。

Editing Simulation
Data Type string string
Access read/write read
Default Value
Units
Constraints 有效的路径名称

representation

该属性指定探针为所关注对象生成的动画形式。在指定该属性取值之前,必须先用“subnet”、“node”和“module”属性的组合来标识所关注对象。“representation”属性的可能取值取决于所指定对象的类型。例如,子网的自动动画可以显示数据包流或节点移动;节点的自动动画可以显示数据包流;模块的自动动画可以显示状态跟踪。

Editing Simulation
Data Type enumerated integer
Access read/write read
Default Value
Units
Constraints 被探测对象的有效表示类型

scalar data

该属性是一个开关,用于启用或阻止受影响统计量的标量数据采集。若启用,“scalar type”属性定义所记录标量数据的性质,“scalar start”和“scalar stop”属性指定用于收集数据以计算标量统计量的时间窗口。被探测的标量数据在仿真结束时基于整个仿真期间收集的数据记录。有关标量统计量的更多信息,参见Modeling Concepts手册的第 11 章“Data Analysis”第 422 页和第 10 章“Simulation Design”第 375 页。

Editing Simulation
Data Type toggle toggle
Access read/write read
Default Value disabled
Units
Constraints

scalar start

若“scalar data”属性的取值为“enabled”,则“scalar start”和“scalar stop”共同指定计算标量统计量所用的仿真时间窗口。具体而言,只有被探测统计量中发生于指定时间区间内的更新,才会被用于计算所得的标量值。

Editing Simulation
Data Type double double
Access read/write read
Default Value 0.0
Units seconds
Constraints scalar start < scalar stop

scalar stop

若“scalar data”属性的取值为“enabled”,则“scalar start”和“scalar stop”共同指定计算标量统计量所用的仿真时间窗口。具体而言,只有被探测统计量中发生于指定时间区间内的更新,才会被用于计算所得的标量值。

Editing Simulation
Data Type double double
Access read/write read
Default Value infinite
Units seconds
Constraints scalar start < scalar stop

scalar type

若“scalar data”属性的取值为“enabled”,则“scalar type”用于计算应用于所关注统计量的这些度量之一。有关这些度量的完整说明,参见第 10 章“Simulation Design”第 375 页。

Editing Simulation
Data Type enumerated integer
Access read/write read
Default Value
Units
Constraints last value, sample mean, time average, variance, min value, max value

scrolling

当该属性启用时,动画面板的宽度保持固定在“initial width”取值。当统计量接收到超出当前显示时间范围的新值时,面板通过将时间轴向增大的方向平移来调整。因此统计量看起来朝取值减小的方向滚动。

若滚动被禁用,分析面板则通过扩展时间轴来调整以显示新数据。这样,统计量的全部历史始终可见,但其绘制分辨率随时间逐渐降低。

Editing Simulation
Data Type boolean boolean
Access read/write read
Default Value 0.0
Units
Constraints

src objid

该属性通过对象 ID 唯一标识被探测的仿真对象。“src objid”的取值由系统分配,并由探针的其他属性决定(并非所有属性都适用于每种探针类型):“subnet”、“node”、“module”、“submodule”、“link”和“channel”。

该属性仅在仿真期间存在,可用于验证探针是否正确配置。

Editing Simulation
Data Type not applicable integer
Access not applicable read
Default Value
Units
Constraints

statistic

该属性表示要采集或动画的统计量的名称。大多数模块和子模块类型都支持一组描述其行为或性能的预定义统计量。此外,处理器和队列支持一组通用统计量,其取值由用户定义的进程模型驱动。有关可用统计量的更多信息,参见第 2 章“Node Reference”第 8 页。

统计量动画探针

该属性的取值必须引用同一探针列表内统计量探针中所指定的统计量。如果被引用的统计量探针使用了“ordinate label”属性,则应使用该取值而非统计量的原始名称来引用该统计量。

Editing Simulation
Data Type string string
Access read/write read
Default Value
Units
Constraints

submodule

该属性可用于指定作为被采集统计量来源的子模块名称。“submodule”与“subnet”、“node”和“module”属性配合使用,以唯一地指定该子模块。对于直接关联于模块或已提升到节点级的统计量的探针,该属性可设为取值 NONE 或留空。

为统计量指定该属性仅适用于支持子模块的模块,例如队列模块、发送器模块和接收器模块。

Editing Simulation
Data Type string string
Access read/write read
Default Value
Units
Constraints 有效的子模块名称

subnet

对于统计量探针,该必填属性指定包含作为统计量来源的节点、模块、子模块或链路的子网名称。对于动画探针,该属性指定一个子网络的名称,该子网络本身即是、或其中包含一个作为动画请求来源的对象。子网名称是层次化的,由将其所有父子网的各个名称以句点分隔拼接而成,末尾是其自身名称。

若“node”和“module”属性留空,探针适用于子网对象本身;否则,探针适用于该子网内指定的节点或模块。子网对象支持两种动画表示:

  • 数据包流动画可可视化数据包在通信链路上的传输
  • 节点移动动画动态显示移动节点和卫星节点的位移
Editing Simulation
Data Type string string
Access read/write read
Default Value
Units
Constraints 有效的子网名称

tag

仅当你对同一统计量使用多个探针时,才为该属性输入取值。此时,“tag”用于区分分析中显示的各个结果统计量。当你选择 View Results 时,你所指定的 tag 字符串将成为统计量树形视图列表中的一个额外层次。

Editing Simulation
Data Type string string
Access read/write read
Default Value 用户选择
Units
Constraints

threshold comparison

该属性指定为判断统计量是否违反服务级别协议(SLA)中定义的规则而执行的比较。有关服务级别协议的详细信息,参见第 3 章“Project Editor”第 89 页。

Editing Simulation
Data Type enumerated string
Access read/write read
Default Value disabled
Units
Constraints disabled, <, >, >=, <=

threshold percent

该属性指定桶内预期符合阈值判据的取值百分比,只有达到该比例,该桶才被视为符合阈值。例如,假设你的 SLA 要求 FTP Download Response Time 在不到 75% 的时间内为 0.5 秒。你会将“threshold percent”指定为 75。如果你采集的取值中有 75% 不超过 0.5 秒,则该桶符合阈值;如果只有 70% 的取值不超过 0.5 秒,则该桶不符合阈值。

取值被分组到桶中,并计算违反阈值取值的数量(ViolationCount)。由 ViolationCount 可以推导出违反阈值的取值百分比。该百分比将与阈值百分比进行比较。

根据指定的采集模式,统计量取值被分组到多个桶或一个桶中。

Editing Simulation
Data Type double double
Access read/write read
Default Value 90.0
Units
Constraints

threshold value

该属性指定用于判断统计量取值是否构成阈值违反的取值。该属性与“threshold comparison”配合工作。例如,假设对于 FTP 下载响应时间,“threshold value”为 0.5 秒且“threshold comparison”为“greater than”。在这种情况下,大于 0.5 秒的统计量取值即为阈值违反。

Editing Simulation
Data Type double double
Access read/write read
Default Value 0.0
Units
Constraints

trace color

该属性指定统计量动画时跟踪记录使用的颜色。该属性的取值形如 RGBnnn,其中每个整数 n 表示一种颜色强度。第一位数字表示红色,第二位表示绿色,第三位表示蓝色。因此,RGB000 对应黑色,RGB333 对应白色,RGB300 对应红色,依此类推。

Editing Simulation
Data Type color color
Access read/write read
Default Value RGB030(绿色)
Units
Constraints

trace style

该属性指定正在动画的统计量的绘制样式。

Editing Simulation
Data Type enumerated enumerated
Access read/write read
Default Value linear
Units
Constraints sample-hold, bar, discrete, linear, square-wave, bar chart

vector data

该属性是一个开关,用于启用或阻止受影响统计量的向量数据采集。若启用,“vector start”和“vector stop”属性定义记录所关注统计量更新的时间区间。一般而言,“vector data”或“scalar data”两个属性中至少有一个处于启用状态。

Editing Simulation
Data Type toggle toggle
Access read/write read
Default Value enabled
Units
Constraints

vector start

若“vector data”属性的取值为“enabled”,则“vector start”和“vector stop”属性共同指定一个仿真时间窗口,在该窗口内对被探测统计量的更新将被记录到所得的输出向量中。

Editing Simulation
Data Type double double
Access read/write read
Default Value 0.0
Units seconds
Constraints vector start < vector stop

vector stop

若“vector data”属性的取值为“enabled”,则“vector start”和“vector stop”属性共同指定一个仿真时间窗口,在该窗口内对被探测统计量的更新将被记录到所得的输出向量中。

Editing Simulation
Data Type double double
Access read/write read
Default Value infinite
Units seconds
Constraints vector start < vector stop

warning low value

该属性指定一个取值,低于该值的统计量取值被视为偏低。它与“critical low value”、“warning high value”和“critical high value”属性一起,定义严重偏低、偏低、正常、偏高和严重偏高五个取值范围,统计量图形中将以绿色、黄色和红色背景加以标示。

Editing Simulation
Data Type booldouble booldouble
Access read/write read
Default Value
Units
Constraints 数值或“disabled”

warning high value

该属性指定一个取值,高于该值的统计量取值被视为偏高。它与“critical low value”、“warning low value”和“critical high value”属性一起,定义严重偏低、偏低、正常、偏高和严重偏高五个取值范围,统计量图形中将以绿色、黄色和红色背景加以标示。

Editing Simulation
Data Type booldouble booldouble
Access read/write read
Default Value
Units
Constraints 数值或“disabled”

window height

该属性指定探针关联的动画查看器的高度(以像素计)。它与“window x”、“window y”和“window width”属性一起,完整定义动画查看器所占的区域。

Editing Simulation
Data Type integer integer
Access read/write read
Default Value 300
Units pixels
Constraints >= 100

window name

该属性指定探针动画将要出现的窗口名称;这使你能够区分多个动画线程。此外,它还可以作为一种会合机制的基础:多个具有相同“window name”的动画探针将它们生成的动画请求发送到同一个动画查看器。

Editing Simulation
Data Type string string
Access read/write read
Default Value
Units
Constraints

window width

该属性指定探针关联的动画查看器的宽度(以像素计)。它与“window x”、“window y”和“window height”属性一起,定义动画查看器的轮廓。

Editing Simulation
Data Type integer integer
Access read/write read
Default Value 500
Units pixels
Constraints >= 100

window x

该属性指定探针关联的动画查看器左上角的 x 坐标(以像素计)。它与“window y”、“window width”和“window height”属性一起,定义动画查看器所占的区域。

Editing Simulation
Data Type integer integer
Access read/write read
Default Value 10
Units pixels
Constraints >= 0

window y

该属性指定探针关联的动画查看器左上角的 y 坐标(以像素计)。它与“window x”、“window width”和“window height”属性一起,定义动画查看器所占的区域。

Editing Simulation
Data Type integer integer
Access read/write read
Default Value 10
Units pixels
Constraints >= 0

zone color

该属性指定绘制统计量所在的绘图区域(zone)的颜色。该属性的取值形如 RGBnnn,其中每个整数 n 表示一种颜色强度。第一位数字表示红色,第二位表示绿色,第三位表示蓝色。因此,RGB000 对应黑色,RGB333 对应白色,RGB300 对应红色,依此类推。

Editing Simulation
Data Type color color
Access read/write read
Default Value RGB111
Units
Constraints

zone height

该属性指定统计量图形所在动画 zone 的高度(以像素计)。

Editing Simulation
Data Type integer
Access read/write read
Default Value 274
Units pixels
Constraints

zone number

该属性指定统计量图形所在的 zone。所有具有相同窗口名称和 zone 编号的图形都显示在同一个 zone 中。

Editing Simulation
Data Type integer integer
Access read/write read
Default Value 1
Units
Constraints

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com