PDF

Skriptsensoren

Netcrunch bietet Hunderte von Überwachungseinrichtungen, z. B. Monitoring Packs und Sensoren. Wir möchten jedoch, dass Sie nicht darauf beschränkt sind. Skriptsensoren sind unerlässlich, um Lücken bei der Bereitstellung von Überwachungsdaten an NetCrunch zu schließen.

Im Gegensatz zu anderen Systemen zwingen wir Sie nicht, Daten in einem systemeigenen Datenformat bereitzustellen, da bereits Tausende von Skripts für Open-Source-Systeme geschrieben wurden. Wir möchten, dass diese Skripts an NetCrunch angepasst werden können. Dies ist die Aufgabe der Datenparser die für die Übersetzung von Daten verantwortlich sind, die von einem externen Skript in das native Format von NetCrunch zurückgegeben werden.

Script-Sensor

Es führt ein Skript oder ein Programm auf dem lokalen NetCrunch Server-Computer aus und verarbeitet das Ergebnis

Der Sensor kann auf einem beliebigen Knoten konfiguriert werden, das Skript wird jedoch immer auf dem NetCrunch Server-Computer ausgeführt. Es kann auf irgendeine Weise Daten von einem Remote-Computer sammeln und Sie können alle Parameter bezüglich Adresse und Anmeldedaten an das Skript übergeben.

NetCrunch kann den Skripttyp automatisch anhand der Dateierweiterung erkennen oder Sie können den Typ in der Sensorkonfiguration angeben. Wenn das Programm keinen Skripttyp erkennt, wird es mit der Windows-Shell ausgeführt.

Die Ausgabe des Skripts (Standardausgabedatenstrom) wird an den Datenparser übergeben (Sie können einen benutzerdefinierten Datenparser erstellen, um das vorhandene Skript anzupassen), das dann Zähler und Status an NetCrunch zurückgibt. Das auszuführende Skript muss für NetCrunch zugänglich sein und sich auf der lokalen Festplatte des NetCrunch Servers befinden. Beachten Sie, dass der NetCrunch-Server unter dem lokalen Systemkonto ausgeführt wird und richtigen Zugriff auf den Ordner benötigt, in dem sich das Skript befindet.

Unterstützte Skripttypen:
  • Javascript (NodeJS)
  • Windows batch (cmd,bat)
  • VBScript
  • Powershell
  • Python
  • Commandline Application (exe)
Zähler:
  • Sensor/Script Execution Time
  • Counters returned by selected Data Parser
Alarme:
  • Script Execution Error
Verfügbare Alarme:
  • Alarm für Überwachungssensoren-Zähler
  • Alarm für Statusobjektänderung (für vom Datenparser zurückgegebene Status)

Übergabe der Argumente an das Skript

Sie können Parameter mithilfe der Parameterliste im Konfigurationsfenster hinzufügen, in der Sie NetCrunch-Knoteneigenschaften mithilfe von Parametern, denen ein Dollarzeichen vorangestellt ist, Ihre Parameter zuordnen können.

$address
Knoten-IP-Adresse
$name
Knotenname
$credentials/...

Profilpfad (Sie können nur ein Profil pro Sensor verwenden): $credentials/windows/<name>/<property>,
dabei ist der Profilname beispielsweise optional

  • $credentials/windows/default/user - Benutzer aus dem Windows Standardprofil für Anmeldedaten
  • $credentials/windows/user - Benutzername aus dem Windows-Profil für Anmeldedaten, das vom Windows-Monitor verwendet wird

Voraussetzungen

  • Um Javascript-Skripts auszuführen, muss NodeJS auf dem NetCrunch Server-System installiert sein
  • Um Python-Skripts auszuführen, installieren Sie Python zuerst auf dem NetCrunch Server-System
  • Um PowerShell-Skripts ausführen zu können, müssen Sie das Ausführen von PowerShell-Skripts in Ihren Systemeinstellungen auf dem NetCrunch Server-System aktivieren
    z. B. Führen Sie PowerShell als Administrator aus und geben Sie Folgendes ein: Set-ExecutionPolicy AllSigned
    Weitere Informationen finden Sie unter: Microsoft Docs

Einschränkungen

Standardmäßige Monitoring Packs und integrierte Sensoren werden von hochspezialisierten Multithread-Engines ausgeführt, die Tausende von Anforderungen pro Minute verarbeiten können. Externe Scripting-Sensoren werden in einzelnen externen Prozessen ausgeführt, die jeweils instanziiert werden müssen, was für das Betriebssystem eine recht intensive Aufgabe ist. Wir haben die Anzahl der gleichzeitigen Prozesse des Scriptings auf NetCrunch Server auf 5 begrenzt.

Remote SSH Script-Sensor

Der Sensor führt ein Skript mit SSH auf einer Remote-Maschine aus

Das auszuführende Skript muss sich auf einem Remote-System befinden.

Sensoreinstellungen:
  • SSH-Verbindung und Anmeldedaten
  • Ein Pfad zum Skript auf dem Remote-System
  • Timeout für die Skriptausführung
  • [Optional] Skriptparameter

Skriptparameter können mithilfe der Parameterliste im Konfigurationsfenster des Skripts hinzugefügt werden. Sie können Knoteneigenschaften Parametern zuordnen. Weitere Informationen finden Sie unter Script-Sensor.

Alarme:

  • Verbindungsfehler
  • Authentifizierungsfehler
  • Fehler bei der Skriptausführung
Verfügbare Alarme
  • Alarm für Überwachungssensoren-Zähler
  • Alarm für Statusobjektänderung (für vom Datenparser zurückgegebene Status)

Zähler - Sensor/Script Execution Time - Vom Datenparser zurückgegebene Zähler