百分号标识的变量

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

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.ActiveMonitorDownNamesCSV

脱机主动监控器名称列表,由逗号分隔。

%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.Role

设备属性界面中显示的主要设备角色。

%Device.RoleGUID

分配给设备的主要角色的全局唯一标识符。

%Device.SNMPOid

SNMP 对象标识符。

%Device.State

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

%Device.BestState

设备状态描述,包含设备的“最佳”状态。例如,如果由于监控器失败,设备从未处于联机状态,最佳状态可能是脱机

%Device.WorstState

设备状态描述,包含设备的“最差”状态。例如,如果由于监控器失败,设备从未处于脱机状态,最差状态可能是联机

%Device.Status

显示主动监控器的名称,接在设备状态标识符后面:

示例

10 | DNS.

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

0 = 未启动、1 = 暂停、2 = 已取消、3 = 执行中、4 = 完成、5 = 解析主机名、6 = 寻找类型、
7 = 扫描寻找 SNMP 认证、8 = 扫描寻找 Windows 认证、9 = 设备详细数据扫描、10 = 扫描自定义监控器、12 = 扫描自定义监控器、13 = 扫描设备 VMware 主机、14 = 扫描SSH 认证、
15 = 第 2 层扫描、16 = 计算第 2 层网络架构、17 = 扫描无线网络、18 = 扫描网络接口、
19 = 检查有无重复设备、21 = 扫描寻找已知地址

%Device.ManualMaintenanceReason

自定义您填充的字符串,并提供将设备置于维护状态的原因。

%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.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