百分号标识的变量

百分号标识的变量

您可以使用百分号变量，对操作的消息和特定配置内容进行自定义。

Note: 如需 WhatsUp Gold 警报中心特定变量的表格，请参阅警报中心百分号变量。

使用百分号变量的重要指南

主动监控工具变量

描述

%ActiveMonitor.Argument

SNMP 实例编号。只在操作直接对应到主动监控工具 (而非整台设备) 时才用得到。

%ActiveMonitor.Comment

与监控器关联注释一致的字符串值。只在操作直接对应到主动监控工具 (而非整台设备) 时才用得到。请注意，对于接口主动监控器，发现使用这个百分比变量自动填充接口描述。

%ActiveMonitor.Name

 

触发操作的主动监控工具名称。只在操作直接对应到主动监控工具 (而非整台设备) 时才用得到。

%ActiveMonitor.NetworkInterfaceAddress

网络接口的 IP 地址。只在操作直接对应到主动监控工具 (而非整台设备) 时才用得到。

%ActiveMonitor.Payload

WMI、Exchange、SQL、SNMP 或活动脚本主动监控工具返回的承载数据。只在操作直接对应到主动监控工具 (而非整台设备) 时才用得到。

活动脚本主动监控工具的承载数据，就是以脚本传递到 SetResult() 方法的文本。

%ActiveMonitor.State

 

监控工具的当前状态，例如“脱机至少 5 分钟”。只在操作直接对应到主动监控工具 (而非整台设备) 时才用得到。

设备变量

描述

%Device.ActiveMonitorDownNames

使用缩写名称的脱机服务列表 (若有)。

%Device.ActiveMonitorUpNames

设备所有上线服务 (接受监控) 的完整服务名称。

%Device.Address

IP 地址 (来自设备属性)。

%Device.Attribute.“属性名称”

返回取自设备的 SNMP 信息属性，例如联络人姓名。若要指定属性，请将类别名称（如下所列）加到变量后面。例如，%Device.Attribute.Contact，返回联络人姓名。

预设类别：

  • *。返回所有属性
  • Info1。从 v8 升级的方式
  • Info2。从 v8 升级的方式
  • 联系人。SNMP 的联络人信息
  • 地点。SNMP 的位置信息
  • 描述。SNMP 的说明信息
  • 自定义。若您已建立自定义属性，则可使用百分号标识的变量格式的自定义属性名称。

范例：

%Device.Attribute.Phone
%Device.Attribute.RackPosition

Tip: 为避免解析错误，请务必在整个嵌入百分号变量的末尾加上空格或换行符号（也就是在属性名称之后）。 

%Device.DatabaseID

返回设备的数据库 ID。

%Device.DisplayName

显示名称 (来自设备属性的 “一般” 字段)

%Device.HostName

主机名 (来自设备属性的 “一般” 字段)

%Device.Notes

注意事项：(来自设备属性 “注意事项” 字段的注意事项)。

%Device.SNMPOid

SNMP 对象标识符。

%Device.State

设备状态说明（例如“脱机至少 2 分钟”或“上线至少 5 分钟”）

%Device.Status

显示主动监控工具的名称，接在设备状态标识符后面：

示例：

10 | DNS.

设备状态标识符值可涵盖：

0 未知
1 脱机至少 5 分钟
2 脱机至少 2 分钟
3 脱机
4 维护
5
6 联机至少 5 分钟
10 脱机至少 20 分钟

%Device.Type

设备类型（来自设备属性的 “一般” 字段）

被动监控工具变量

描述

%PassiveMonitor.DisplayName

“被动监控工具库”中显示的监控工具名称。

%PassiveMonitor.LoggedText

详细事件说明（SNMP traps：返回完整 SNMP trap 文本）（Windows 记录文件项目：返回 Windows 事件记录文件项目内的信息。）（Syslog 项目：返回 Syslog 消息内的文本。）

%PassiveMonitor.Payload.*

被动监控工具生成的承载数据。

%PassiveMonitor.Payload.EventType

被动监控工具类型 (Syslog、Windows 事件或 SNMP Trap)

%PassiveMonitor.Payload.LogicalSource

显示设备的逻辑 IP 地址。

%PassiveMonitor.Payload.PhysicalSource

显示设备的实体 IP 地址。

系统变量

描述

%System.Date

目前的系统日期。配置 “地区选项” 中的日期格式 (在 “程序选项” 中)

%System.DisplayNamesDownDevices

监控工具脱机的设备显示名称

%System.DisplayNamesDownMonitors

 

显示设备名称及该设备所有脱机监控工具的名称。回应格式为 '设备名称':'监控工具 1','监控工具 2','...'

示例：ARNOR:FTP, HTTPS, Ping

%System.DisplayNamesUpDevices

上线设备的显示名称

%System.DisplayNamesUpMonitors

显示设备名称及该设备所有上线监控工具的名称。回应格式为 '设备名称':'监控工具 1','监控工具 2','...'

范例：ARNOR:FTP, HTTPS, Ping

%System.InstallDir

显示 WhatsUp Gold 的安装目录

%System.NumberofDownDevices

网络中的脱机设备数目

%System.NumberOfDownMonitors

显示网络中脱机监控工具的数目

%System.NumberofUpDevices

网络中的上线设备数目

%System.NumberOfUpMonitors

显示网络中上线监控工具的数目

%System.Time

目前的系统 时间。格式为 hh:mm:ss