主動監控工具變數

說明

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