百分比變數

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

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