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

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.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
  • Location. Standortinformationen aus SNMP
  • Description. 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.SNMPOid

SNMP-Objektkennung.

%Device.State

Beschreibung des Gerätestatus (zum Beispiel „Mindestens 2 min nicht erreichbar“ oder „Mindestens 5 min 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 Unbekannt
1 Mindestens 5 min nicht erreichbar
2 Mindestens 2 min nicht erreichbar
3 Nicht erreichbar
4 Wartung
5 Erreichbar
6 Mindestens 5 min erreichbar
10 Mindestens 20 min nicht erreichbar

%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

Das aktuelle Systemdatum. Das Datumsformat kann in den Regionalen Einstellungen (über Programmoptionen) konfiguriert werden.

%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