Zum Hauptinhalt springen

Skript-Monitor ausführen

Monitor any device condition by running a script and evaluating its output against a threshold or string match.

Einleitung

Überwachen Sie alles, wofür Sie ein Skript schreiben können. Skript-Monitore führen ein Skript auf Zielgeräten nach einem festgelegten Zeitplan aus und werten die Ausgabe anhand einer von Ihnen definierten Bedingung aus – wenn die Bedingung erfüllt ist, löst Level einen Alarm aus.

Während die integrierten Monitor-Typen häufige Bedingungen abdecken (CPU, Arbeitsspeicher, Festplatte, Konnektivität), decken Skript-Monitore alles andere ab: Firewall-Status, Zertifikatablauf, Lizenz-Compliance, benutzerdefinierte Anwendungsintegrität, Konfigurationsabweichungen und alle anderen Geräteeigenschaften, die Sie mit einem Skript ermitteln können. Das Skript wird lokal auf dem Gerät ausgeführt, sodass kein externer Aufruf-Overhead entsteht – nur direkter, effizienter Zugriff auf alles, was das Betriebssystem melden kann.


🎬 VIDEO


Skript-Monitore

Level führt das ausgewählte Skript auf den betroffenen Geräten in der von Ihnen konfigurierten Häufigkeit aus. Nach jedem Durchlauf liest es die vollständige Konsolenausgabe und wertet sie anhand Ihrer Skriptausgabe Bedingung und Wert. Wenn die Bedingung für die Anzahl der durch Ihren Auslöseanzahl, wird ein Alarm ausgelöst.

Die Auswertung ist bewusst einfach gehalten: Das Skript gibt etwas aus, der Monitor prüft, ob diese Ausgabe Ihrer Bedingung entspricht. Das Skript muss nicht mit einem bestimmten Code beendet werden – die Ausgabe ist entscheidend.

ℹ️ HINWEIS: Level wertet die gesamte Ausgabe des Skripts aus, nicht nur die erste oder letzte Zeile. Beachten Sie dies beim Schreiben von Skripten, die mehrzeilige Ausgaben erzeugen.


Skript erstellen

Schreiben und speichern Sie das Skript, bevor Sie den Monitor konfigurieren. Jede unterstützte Sprache funktioniert: PowerShell, Bash, Zsh, Python, Go, Ansible oder osquery.

💡 TIPP: osquery läuft auf Windows, macOS und Linux – ein einziges osquery-Skript kann Monitore auf allen drei Plattformen betreiben, ohne separate Skripte pro Betriebssystem pflegen zu müssen.

Das Skript sollte einen Wert oder Zustand ausgeben, den Level klar auswerten kann – eine Zahl, eine Zeichenkette wie True/False, oder ein bekanntes Wort wie Enabled. Der Monitor vergleicht dann diese Ausgabe mit Ihrem Schwellenwert.

Create Script

💡 TIPP: Bei komplexen Prüfungen, bei denen mehrere Bedingungen innerhalb des Skripts ausgewertet werden müssen, geben Sie ein bekanntes Auslösewort aus (wie ALERT) wenn die Bedingung fehlerhaft ist, und setzen Sie den Monitor auf EnthältALERT. Dadurch bleibt die Bestanden/Nicht-bestanden-Logik im Skript, während die Monitor-Konfiguration einfach bleibt.


Einen Skript-Monitor konfigurieren

Öffnen Sie die Ziel-Monitor-Richtlinie und fügen Sie dann einen Skript-Monitor hinzu oder bearbeiten Sie einen vorhandenen. Der Monitor bearbeiten Bereich öffnet sich auf der rechten Seite.

Name und Typ

  1. Geben Sie einen Namen in das Name Feld. Der Name erscheint im Alarm, also machen Sie ihn aussagekräftig – „Windows Firewall deaktiviert" ist sofort umsetzbar; „Skript-Monitor 4" nicht.

  2. Setzen Sie Typ auf Skript ausführen.

Uptime Monitor

Schweregrad

Setzen Sie Schweregrad basierend auf den Auswirkungen der Bedingung, die dieses Skript erkennt:

  • Information

  • Warnung

  • Kritisch

  • Notfall

Betriebssystem

Wählen Sie das Betriebssystem aus, auf dem das Skript ausgeführt werden soll: Windows, macOS, oder Linux. Der Monitor wird nur auf Geräten ausgeführt, die das ausgewählte Betriebssystem verwenden.

OS Selection

Skript

Wählen Sie das auszuführende Skript aus dem Skript Feld. Klicken Sie auf das Link-Symbol, um das Skript zu öffnen und es zu überprüfen oder zu bearbeiten. Klicken Sie auf Skript testen um das Skript sofort auf die Zielgeräte anzuwenden und die Rohausgabe zu prüfen – nützlich, um zu bestätigen, dass das Skript das Erwartete zurückgibt, bevor der Monitor aktiv wird.

Script Selection

Skriptausgabe

Skriptausgabe legt fest, wie Level die Konsolenausgabe des Skripts mit Ihrem Wert. Die vollständige Liste der Operatoren:

  • Gleich – Ausgabe stimmt genau mit dem Wert überein

  • Ungleich – Ausgabe stimmt nicht mit dem Wert überein

  • Enthält – Ausgabe enthält den Wert als Teilzeichenkette

  • Enthält nicht – Ausgabe enthält den Wert nicht

  • Größer als – Ausgabe (numerisch) ist größer als der Wert

  • Größer als oder gleich – Ausgabe (numerisch) ist größer oder gleich dem Wert

  • Kleiner als – Ausgabe (numerisch) ist kleiner als der Wert

  • Kleiner als oder gleich – Ausgabe (numerisch) ist kleiner oder gleich dem Wert

Script Output

ℹ️ HINWEIS: Die vollständige Konsolenausgabe Ihres Skripts wird zur Alarm-Nutzlast. Wenn ein Alarm ausgelöst wird, ist die Skriptausgabe direkt in den Alarmdetails sichtbar – alles, was Sie in die Konsole schreiben (Gerätename, erkannte Werte, Fehlerdetails), erscheint dort. Nützliche Kontextinformationen in die Ausgabe zu schreiben macht Alarme viel leichter bearbeitbar, ohne tiefer nachforschen zu müssen.

ℹ️ HINWEIS: Die Ausführungshäufigkeit steuert, wie oft Level die Skriptausgabe auswertet. Alarm-Nutzlasten sind keine vollständige Zeitreihe jeder Skriptausführung. Um jede Messung zur Analyse zu behalten, lassen Sie Ihr Skript zeitgestempelte Stichproben an eine lokale CSV-Datei auf dem Gerät anhängen und rufen Sie diese Datei nach der Auswertung ab. Berücksichtigen Sie dabei Dateigröße, Berechtigungen und Bereinigung.

Wert

Geben Sie den Wert, mit dem die Skriptausgabe verglichen werden soll, in das Wert Feld. Geben Sie bei numerischen Operatoren eine Zahl ein. Bei Zeichenketten-Operatoren geben Sie die genaue Zeichenkette ein.

Output

💡 TIPP: Das empfohlene Muster ist die Ausgabe von ALERT (mit allen zusätzlichen Details, die für die Untersuchung hilfreich sind), wenn eine Bedingung fehlerhaft ist, und setzen Sie Skriptausgabe auf EnthältALERT. Dies funktioniert gut mit mehrzeiliger Ausgabe, enthält alle Details, die Sie nach dem Schlüsselwort anhängen, und hält den Alarm lesbar. Setzen Sie den Monitor auf Enthält nichtALERT wenn Sie die Logik umkehren möchten.

Ausführungshäufigkeit

Ausführungshäufigkeit steuert, wie oft das Skript auf Zielgeräten ausgeführt wird. Legen Sie die Einheit fest (Minuten oder Stunden) und den Wert mithilfe des Schiebereglers oder der Pfeiltasten nach oben/unten. Bereich ist 1–120 Minuten oder 1–24 Stunden.

Run Frequency

⚠️ WARNUNG: Das Ausführen von Skripten mit sehr hoher Häufigkeit kann die Geräteleistung beeinträchtigen, insbesondere bei weniger leistungsstarker Hardware oder wenn das Skript selbst ressourcenintensiv ist. Beginnen Sie mit einem längeren Intervall und reduzieren Sie es nur, wenn Ihr Anwendungsfall tatsächlich eine schnellere Erkennung erfordert.

Auslöseanzahl

Auslöseanzahl legt fest, wie viele aufeinanderfolgende Skriptausführungen die Bedingung erfüllen müssen, bevor Level einen Alarm erstellt. Verwenden Sie die Pfeiltasten, um den Wert festzulegen.

Eine Auslöseanzahl von 1 löst einen Alarm beim ersten übereinstimmenden Durchlauf aus. Höhere Werte erfordern, dass die Bedingung über mehrere Durchläufe hinweg anhält, bevor ein Alarm ausgelöst wird – nützlich für Bedingungen, die aufgrund von Timing kurzzeitig auftreten können (z. B. ein Skript, das mitten in einem Vorgang läuft).

Trigger Count

Automatische Auflösung

Alarm automatisch auflösen, wenn er nicht mehr zutrifft schließt den Alarm automatisch, wenn ein nachfolgender Skriptdurchlauf die Bedingung nicht mehr erfüllt. Standardmäßig aktiviert.

Lassen Sie diese Option für Bedingungen aktiviert, die sich tatsächlich klären (ein Wert, der wieder unter einen Schwellenwert fällt, eine Zeichenkette, die nicht mehr in der Ausgabe erscheint). Deaktivieren Sie sie, wenn Alarme zur manuellen Überprüfung bestehen bleiben sollen.

Auto-Resolve

Behebung

Hängen Sie eine oder mehrere Automatisierungen an, die ausgeführt werden sollen, wenn dieser Monitor auslöst – eine Konfigurationskorrektur übertragen, einen Dienst neu starten oder Ihr Team benachrichtigen.

  1. Klicken Sie in das Behebung Feld und wählen Sie eine Automatisierung aus.

  2. Um weitere hinzuzufügen, klicken Sie auf + Weitere Behebung hinzufügen.

  3. Um eine zu entfernen, klicken Sie auf das × daneben.

Run script monitor Remediation controls

ℹ️ HINWEIS: Behebungen werden ausgeführt, wenn der Alarm erstellt wird, nicht wenn er aufgelöst wird.


Benachrichtigungen

  • Benachrichtigungen bei Alarmerstellung senden – Richtlinienempfänger erhalten eine E-Mail, wenn der Alarm ausgelöst wird

  • Benachrichtigungen bei Alarmauflösung senden – Richtlinienempfänger erhalten eine E-Mail, wenn der Alarm aufgelöst wird

Empfänger werden auf Ebene der Monitor-Richtlinie verwaltet, im Empfänger Abschnitt.

Notifications

Monitor speichern

Klicken Sie auf Monitor aktualisieren um Änderungen zu speichern, oder Monitor hinzufügen beim Hinzufügen eines neuen. Der Monitor beginnt sofort mit der Ausführung, wobei nachfolgende Durchläufe ab dem Erstellungszeitpunkt basierend auf Ihrer konfigurierten Häufigkeit geplant werden.


Beispiele und Inspiration

Für vollständige, durchgängige Beispiele, die zeigen, wie man ein Skript schreibt und den Monitor darum konfiguriert, siehe Skript-Monitor-Beispiele.

Die Level Library unter level.io/library verfügt über eine kuratierte Sammlung einsatzbereiter Skripte und Monitor-Richtlinien, die Sie mit einem Klick in Ihr Konto importieren können. Dies ist ein guter Ausgangspunkt, ob Sie sofort etwas einsetzen möchten oder einfach sehen wollen, wie andere ein bestimmtes Überwachungsproblem angegangen sind.


Bewährte Vorgehensweisen

Verwenden Sie einen ALERT Sentinel als Ihr Standard-Ausgabemuster. Der empfohlene Ansatz: Schreiben Sie Skripte so, dass sie ALERT (mit beliebigen zusätzlichen Details danach), wenn sich das Gerät in einem fehlerhaften Zustand befindet, dann setzen Sie den Monitor auf EnthältALERT. Dies funktioniert zuverlässig mit mehrzeiliger Ausgabe, ist in der Alarmliste leicht zu scannen und hält die Bestanden/Nicht-bestanden-Logik dort, wo sie hingehört – im Skript.

PowerShell-Skript

if ($condition) {
Write-Output "ALERT: $details"
} else {
Write-Output "OK"
}

Halten Sie die Auswertungslogik für einfache Prüfungen im Monitor. Wenn ein Skript einen einzelnen klaren Wert erzeugt – eine Zahl, True/False, Enabled/Disabled – konfigurieren Sie den Vergleich im Monitor statt im Skript. So ist der Monitor leichter zu verstehen und anzupassen, ohne das Skript anfassen zu müssen.

Beginnen Sie mit einer längeren Ausführungshäufigkeit. Ein Intervall zu reduzieren ist einfach; mit den Leistungsauswirkungen eines zu häufig laufenden Skripts umzugehen ist schwieriger. Hochfrequente Ausführung kann Geräte mit geringerer Leistung beeinträchtigen, besonders wenn das Skript bedeutende Arbeit leistet.

Verwenden Sie osquery für plattformübergreifende Abdeckung. osquery läuft auf Windows, macOS und Linux und stellt den Gerätezustand über eine SQL-ähnliche Schnittstelle bereit. Ein einziges osquery-Skript kann häufig drei separate betriebssystemspezifische Skripte ersetzen.

Vor der Bereitstellung testen. Verwenden Sie Skript testen um das Skript auf einem Zielgerät auszuführen und die Rohausgabe zu prüfen, bevor der Monitor aktiv wird. Dies erkennt Überraschungen beim Ausgabeformat – zusätzliche Leerzeichen, unerwartete Zeilenumbrüche, mehrzeilige Ausgabe – bevor sie Ihren Monitor stillschweigend außer Betrieb setzen.


Häufig gestellte Fragen

  • Wer kann Skript-Monitore erstellen und bearbeiten? Techniker mit Zugriff auf die entsprechende Monitor-Richtlinie. Berechtigungseinstellungen werden verwaltet in Arbeitsbereich → Berechtigungen.

  • Wie unterscheidet sich ein Skript-Monitor vom Ausführen eines Skripts über eine Automatisierung? Eine Automatisierung führt ein Skript als Reaktion auf einen Auslöser aus (einen Zeitplan, einen Alarm, eine manuelle Aktion). Ein Skript-Monitor führt ein Skript nach einem wiederkehrenden Zeitplan aus, speziell um die Geräteintegrität zu bewerten und einen Alarm auszulösen, wenn eine Bedingung erfüllt ist. Verwenden Sie Monitore für laufende Integritätsprüfungen, Automatisierungen für reaktive oder einmalige Aufgaben.

  • Kann ich dasselbe Skript in mehreren Monitoren verwenden? Ja. Ein einzelnes Skript kann von beliebig vielen Monitoren in verschiedenen Richtlinien referenziert werden. Wenn Sie das Skript aktualisieren, übernehmen alle Monitore, die es verwenden, die Änderung bei ihrem nächsten Durchlauf.

  • Mein Skript-Monitor löst keinen Alarm aus, obwohl ich weiß, dass die Bedingung wahr ist. Was sollte ich prüfen? Verwenden Sie Skript testen um das Skript auf einem Zielgerät auszuführen und die Rohausgabe zu prüfen. Häufige Probleme: Die Ausgabe hat führende/nachfolgende Leerzeichen, die ein exaktes Gleich übereinstimmen, die Ausgabe mehrzeilig ist und der übereinstimmende Wert verloren geht, oder das Skript gegen Geräte ausgeführt wird, die nicht dem erwarteten Betriebssystem entsprechen.

  • Was passiert mit offenen Skript-Monitor-Alarmen, wenn ich den Monitor lösche? Bestehende Alarme bleiben bestehen. Das Löschen eines Monitors schließt keine bereits erstellten Alarme – lösen Sie diese manuell auf.

Hat dies deine Frage beantwortet?