百分比變數

百分比變數

您可以使用百分比變數來自訂動作的訊息和部分組態內容。

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 = 暫停、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.Type

裝置類型（來自裝置屬性的 [一般] 欄位）

被動監控工具變數

說明

%PassiveMonitor.DisplayName

「被動監控工具資料庫」中顯示的監控工具名稱。

%PassiveMonitor.LoggedText

詳細事件說明（SNMP Trap：傳回完整的 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