Prozentvariablen

Sie können den Meldungstext einer Aktion und bestimmte Konfigurationsinhalte mit Prozentvariablen anpassen.

Note: Eine Tabelle der Variablen für WhatsUp Gold AlertCenter finden Sie im Thema AlertCenter-Prozentvariablen.

Wichtige Richtlinien für den Einsatz von Prozentvariablen

Bei mehreren Aktionen gibt es einzelne Datenfelder in den Konfigurationsdialogen, die Prozentvariablen unterstützen und eine Liste der verfügbaren Variablen enthalten.

Variablen für aktive Monitore

Beschreibung

%ActiveMonitor.Argument

Nummer der SNMP-Instanz. Wird nur verwendet, wenn eine Aktion nur mit einem aktiven Monitor, nicht mit dem Gerät als Ganzem verknüpft ist.

%ActiveMonitor.Comment

Zeichenkettenwert, der den Kommentaren der Monitorbeschreibung entspricht. Wird nur verwendet, wenn eine Aktion direkt mit einem aktiven Monitor, nicht mit dem Gerät als Ganzem verknüpft ist. Hinweis: Bei aktiven Schnittstellenmonitoren verwendet die Erkennung diese Prozentvariable, um die Schnittstellenbeschreibung automatisch zu befüllen.

%ActiveMonitor.Name

 

Der Name des aktiven Monitors, der eine Aktion ausgelöst hat. Wird nur verwendet, wenn eine Aktion nur mit einem aktiven Monitor, nicht mit dem Gerät als Ganzem verknüpft ist.

%ActiveMonitor.NetworkInterfaceAddress

IP-Adresse für die Netzwerkschnittstelle. Wird nur verwendet, wenn eine Aktion nur mit einem aktiven Monitor, nicht mit dem Gerät als Ganzem verknüpft ist.

%ActiveMonitor.Payload

Die Payload, die von einem aktiven WMI-, Exchange-, SQL- oder Active-Script-Monitor ausgegeben wurde. Wird nur verwendet, wenn eine Aktion direkt mit einem aktiven Monitor, nicht mit den Geräten als Ganzen verknüpft ist.

Für Active-Script-Monitore ist die Payload der Text, der an die Methode SetResult() im Skript weitergereicht wird.

%ActiveMonitor.State

 

Aktueller Status des Monitors, z. B. „Mindestens 5 min nicht erreichbar“ Wird nur verwendet, wenn eine Aktion direkt mit einem aktiven Monitor, nicht mit dem Gerät als Ganzem verknüpft ist.

Gerätevariablen

Beschreibung

%Device.ActiveMonitorDownNames

Liste der nicht erreichbaren Dienste mit abgekürztem Namen (falls verfügbar).

%Device.ActiveMonitorDownNamesCSV

Namensliste der nicht erreichbaren aktiven Monitore, mit Komma getrennt.

%Device.ActiveMonitorUpNames

Vollständige Dienstnamen aller erreichbaren überwachten Dienste auf einem Gerät.

%Device.Address

IP-Adresse (aus den Geräteeigenschaften).

%Device.Attribute.[Attribute Name]

Gibt ein Attribut aus den für das Gerät verfügbaren SNMP-Informationen aus (z. B. Kontaktname). Sie können das Attribut genauer definieren, indem Sie den Kategorienamen (s. u.) an die Variable anhängen. Beispiel: %Device.Attribute.Contact gibt den Kontaktnamen aus.

Standardkategorien:

  • *. Alle Attribute ausgeben
  • Info1. Upgrade-Pfad von Version 8
  • Info2. Upgrade-Pfad von Version 8
  • Contact. Kontaktinformationen aus SNMP
  • Standort. Standortinformationen aus SNMP
  • Beschreibung. Beschreibungsinformationen aus SNMP
  • Benutzerdefiniert. Wenn Sie ein benutzerdefiniertes Attribut erstellt haben, können Sie den Namen dieses benutzerdefinierten Attributs in der Prozentvariable verwenden.

Beispiel:

%Device.Attribute.Phone
%Device.Attribute.RackPosition

Tip: Stellen Sie zur Vermeidung von Parsing-Fehlern sicher, dass ein Leerzeichen oder ein Zeilenumbruch am Ende der gesamten eingebetteten Prozentvariable eingeführt wird (d. h. nach dem Attributnamen).  

%Device.DatabaseID

Gibt die Datenbank-ID eines Geräts aus.

%Device.DisplayName

Anzeigename (von der Registerkarte „Allgemein“ in den Geräteeigenschaften)

%Device.HostName

Hostname (von der Registerkarte „Allgemein“ in den Geräteeigenschaften)

%Device.Notes

Kommentare. (Kommentare aus den Geräteeigenschaften > Kommentare)

%Device.Role

Primäre Geräterolle, die auch in den Geräteeigenschaften angezeigt wird.

%Device.RoleGUID

Global Unique Identifier (globale eindeutige ID, GUID) für die primäre Rolle, die dem Gerät zugewiesen wurde.

%Device.SNMPOid

SNMP-Objektkennung.

%Device.State

Beschreibung des Gerätestatus (zum Beispiel „Mindestens 2 min nicht erreichbar“ oder „Mindestens 5 min erreichbar“)

%Device.BestState

Beschreibung des Gerätestatus mit dem „besten“ Zustand des Geräts. Beispiel: Wenn ein Gerät sich aufgrund fehlgeschlagener Monitore nie im Zustand Erreichbar befunden hat, wäre der beste Zustand Nicht erreichbar.

%Device.WorstState

Beschreibung des Gerätestatus mit dem „schlechtesten“ Zustand des Geräts. Beispiel: Wenn ein Gerät sich nie aufgrund fehlgeschlagener Monitore im Zustand Nicht erreichbar befunden hat, wäre der schlechteste Zustand Erreichbar.

%Device.Status

Die ID des Gerätestatus, gefolgt vom Namen des aktiven Monitors, der eine Aktion ausgelöst hat.

Beispiel:

10 | DNS.

Werte für die ID des Gerätestatus:

0 = Nicht gestartet, 1 = Angehalten, 2 = Abgebrochen, 3 = Wird ausgeführt, 4 = Abgeschlossen, 5 = Hostname wird aufgelöst, 6 = Suche nach Typ,
7 = SNMP-Anmeldeinformationen werden erkannt, 8 = Windows-Anmeldeinformationen werden erkannt, 9 = Gerätedetails werden erkannt, 10 = Benutzerdefinierte Monitore werden erkannt, 12 = Benutzerdefinierte Monitore werden erkannt, 13 = Geräte-VMWare-Host wird erkannt, 14 = SSH-Anmeldeinformationen werden erkannt,
15 = Schicht-2-Suchlauf, 16 = Schicht-2-Topologie wird berechnet, 17 = WLAN-Suchlauf, 18 = Netzwerkschnittstellen werden erkannt,
19 = Prüfung auf doppelt vorhandene Geräte, 21 = Suchlauf für bekannte Adressen

%Device.ManualMaintenanceReason

Benutzerdefinierte Zeichenkette, in dem der Grund angegeben werden kann, warum ein Gerät in den Zustand Wartung versetzt wurde.

%Device.Type

Gerätetyp (von der Registerkarte „Allgemein“ in den Geräteeigenschaften)

Variablen für passive Monitore

Beschreibung

%PassiveMonitor.DisplayName

Der Name des Monitors aus der Bibliothek passiver Monitore.

%PassiveMonitor.LoggedText

Detaillierte Ereignisbeschreibung. (SNMP-Traps – gibt den vollständigen SNMP-Trap-Text aus.) (Windows-Protokolleinträge – Gibt die Informationen in den Windows-Ereignisprotokolleinträgen aus.) (Syslog-Einträge – Gibt den Text der Syslog-Meldung aus.)

%PassiveMonitor.Payload.*

Von einem passiven Monitor generierte Payload.

%PassiveMonitor.Payload.EventType

Die Art des passiven Monitors (Syslog, Windows-Ereignis oder SNMP-Trap)

%PassiveMonitor.Payload.LogicalSource

Die logische IP-Adresse des Geräts.

%PassiveMonitor.Payload.PhysicalSource

Die physische IP-Adresse des Geräts.

Systemvariablen

Beschreibung

%System.Date

Systemdatum anzeigen. (Das Format entspricht dem Format des Betriebssystems, auf dem der WhatsUp Gold-Server ausgeführt wird.)

%System.DisplayNamesDownDevices

Zeigt die Namen von Geräten mit nicht erreichbaren Monitoren an.

%System.DisplayNamesDownMonitors

 

Zeigt den Namen eines Geräts und jeden nicht erreichbaren Monitor auf diesem Gerät an. Das Format der Antwort lautet 'Gerätename':'Monitor 1','Monitor 2','...'

Beispiel: ARNOR: FTP, HTTPs, Ping

%System.DisplayNamesUpDevices

Zeigt die Namen von erreichbaren Geräten an

%System.DisplayNamesUpMonitors

Zeigt den Namen eines Geräts und jeden erreichbaren Monitor auf diesem Gerät an. Das Format der Antwort lautet 'Gerätename':'Monitor 1','Monitor 2','...'

Beispiel: ARNOR: FTP, HTTPs, Ping

%System.InstallDir

Zeigt das Verzeichnis an, in dem WhatsUp Gold installiert ist.

%System.NumberofDownDevices

Die Anzahl nicht erreichbarer Geräte im Netzwerk

%System.NumberOfDownMonitors

Die Anzahl nicht erreichbarer Monitore im Netzwerk

%System.NumberofUpDevices

Die Anzahl erreichbarer Geräte im Netzwerk

%System.NumberOfUpMonitors

Die Anzahl erreichbarer Monitore im Netzwerk

%System.Time

Die aktuelle Systemzeit. Das Format lautet hh:mm:ss

See Also

Erstellen von Aktionen und Aktionsrichtlinien

Integrierte Aktionstypen

Richtlinien für die Erstellung von Aktionsrichtlinien

Bibliothek wiederkehrender Aktionen