百分号标识的变量

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

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

显示系统日期(使用与运行 WhatsUp Gold 服务器的操作系统相同的格式)。

%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

See Also

WhatsUp Gold 语言帮助

WhatsUp Gold 简介

发现

设备角色

凭证

架构图

设备

监控器

仪表板

操作与警报

警报中心数据库

报告

日志

日志管理

WhatsUp Gold 代理

无线

虚拟

应用程序

存储和云

网络传输流量分析

配置管理

工具

设置

MIB

用户和用户组

管理员控制台

可扩展性轮询器

故障复原

分布式

短信操作通知

短信直送通知

电子邮件通知

管理通知策略

上报计划可视化

预定报告库

系统状态与属性

选择工作时间

定义日期范围

启用 WhatsVirtual 事件侦听器 (VMware)

启用 WhatsVirtual 事件侦听器 (Hyper-V)

可视化、打印、共享和导出

通过电子邮件发送报告和日志

导出日志和报告数据

共享报告

接口报告设置

列排序和选择器

筛选行和搜索

网络流量报告设置

预订维护时间

网络接口

加入/编辑网络接口

浏览操作目录

测试 LDAP 认证

全局 SMTP 设置

短信服务提供商

短信服务提供商详情

选择计算机

电子邮件主动监控器的高级属性

工具:第 2 层追踪

IP/MAC 地址查找

使用电子邮件通知消息设置

选择一个设备

选择设备主群组

欢迎向导游览

设置 Active Directory/LDAP 凭据

设定 Cisco ACS 认证

发现百分号变量

变更大量字段:主动监控工具属性

警报中心百分号标识的变量

设定被动监控工具的操作

监控应用程序性能

配置监控器:Windows 事件日志设置

SNMP MIB 浏览器对话框

被动监控工具属性

重新扫描选项

JMX 浏览器

依存关系总览

OS 库

JSONPath 查询和 JSONPath Builder

使用动态组筛选条件编辑器

在 WhatsUp Gold 中使用收藏夹

版权声明