Einführung

Systemvariablen sind integrierte Variablen, die in jeder Automatisierung und jedem Skript verfügbar sind – ohne Einrichtung. Sie stellen zur Laufzeit aktuelle Geräte- und Gruppenmetadaten bereit: Hostname, IP-Adressen, Gruppenname, Tags und mehr.

Verwenden Sie sie überall dort, wo das Rendern von Variablen unterstützt wird: Skriptaktionen, Shell-Befehle, Benachrichtigungsnachrichten, HTTP-Anfragen oder benutzerdefinierte Feldwerte. Sie können sie auch direkt in einer Bedingung für eine Aktion oder einen ereignisbasierten Auslöser vergleichen.

Systemvariablen

Alle Systemvariablen verwenden das level_ Präfix. Jede hat einen Typ, der die verfügbaren Vergleiche bestimmt, wenn sie in einer Bedingung verwendet wird.

Variable	Typ	Beschreibung
`level_time`	Datum und Uhrzeit	Aktuelle Uhrzeit im ISO 8601-Format
`level_device_id`	Text	Interner eindeutiger Bezeichner für das Gerät
`level_device_hostname`	Text	Der Hostname des Geräts
`level_device_nickname`	Text	Der dem Gerät zugewiesene benutzerdefinierte Spitzname
`level_device_public_ip_address`	Text	Die externe IP-Adresse des Geräts
`level_device_private_ip_addresses`	Text	Kommagetrennte Liste interner IP-Adressen
`level_device_architecture`	Text	CPU-Architektur des Geräts
`level_device_cpu_cores`	Zahl	Anzahl der CPU-Kerne
`level_device_memory`	Zahl	Gesamtspeicher in rohen Bytes
`level_device_memory_formatted`	Text	Gesamtspeicher, menschenlesbar (z. B. `16 GB`)
`level_device_os`	Text	Name des Betriebssystems
`level_device_os_version`	Text	Versionszeichenkette des Betriebssystems
`level_device_manufacturer`	Text	Vom Gerät gemeldeter Hardware-Hersteller (z. B. `Dell Inc.`)
`level_device_model`	Text	Vom Gerät gemeldetes Hardware-Modell (z. B. `OptiPlex 7090`)
`level_device_last_boot_at`	Datum und Uhrzeit	Zeitpunkt des letzten Neustarts im ISO 8601-Format
`level_device_last_seen_at`	Datum und Uhrzeit	Zeitpunkt der letzten Aktivität im ISO 8601-Format
`level_device_first_seen_at`	Datum und Uhrzeit	Zeitpunkt, zu dem das Gerät erstmals zu Level hinzugefügt wurde, im ISO 8601-Format
`level_device_online`	Wahr oder falsch	Ob das Gerät derzeit online ist: `true` oder `false`
`level_device_maintenance_mode`	Wahr oder falsch	Ob sich das Gerät derzeit im Wartungsmodus befindet: `true` oder `false`
`level_device_restart_required`	Wahr oder falsch	Ob das Gerät auf einen Neustart wartet: `true` oder `false`
`level_group_id`	Text	ID der Gruppe, zu der das Gerät gehört
`level_group_name`	Text	Name der Gruppe, zu der das Gerät gehört
`level_group_path`	Text	Vollständiger Pfad der Gruppe (z. B. `HQ / Servers`)
`level_tag_names`	Text	Kommagetrennte Liste der auf das Gerät angewendeten Tag-Namen
`level_tag_ids`	Text	Kommagetrennte Liste der auf das Gerät angewendeten Tag-IDs

ℹ️ HINWEIS: Die drei Ja/Nein-Variablen (level_device_online, level_device_maintenance_mode, level_device_restart_required) werden als Text dargestellt: true oder false, daher sollten Sie sie in Ihren Skripten als Zeichenketten vergleichen. Variablen, die das Gerät noch nicht gemeldet hat, wie z. B. level_device_manufacturer auf einem Gerät ohne Hardware-Inventar werden als leere Zeichenkette dargestellt.

Systemvariablen verwenden

Öffnen Sie eine Automatisierung oder ein Skript und wählen Sie Variablen, und wählen Sie dann die System Registerkarte, um die in Level verfügbaren integrierten Variablen zu durchsuchen. Suchen Sie nach Variablenname oder Beschreibung, oder filtern Sie die Liste nach Typ. Die Tabelle zeigt Referenz, Beschreibung, Typ und einen Beispielwert jeder Variablen. Systemvariablen sind schreibgeschützt und müssen vor der Verwendung nicht erstellt werden.

System Variables tab with search, type filter, and variable reference columns

Um eine Systemvariable in eine Aktion einzufügen, klicken Sie auf das Variablensymbol in einem beliebigen Feld, das das Rendern von Variablen unterstützt, und wählen Sie aus der Liste. Systemvariablen erscheinen neben allen für diese Automatisierung definierten Automatisierungsvariablen.

Um eine Variable direkt in einem Skript zu referenzieren, verwenden Sie die {{variable_name}} Syntax:

echo "Running on {{level_device_hostname}} in {{level_group_path}}"

💡 TIPP:level_group_path ist nützlich für Skripte, die sich je nachdem, wo ein Gerät in Ihrer Gruppenhierarchie eingeordnet ist, unterschiedlich verhalten sollen – ohne eine separate Automatisierung pro Gruppe zu benötigen.

Systemvariablen in Bedingungen verwenden

Systemvariablen sind auch ein Bedingungstyp. Fügen Sie eine Bedingung hinzu, wählen Sie Systemvariable, wählen Sie die Variable aus und legen Sie dann den Vergleich und den Wert fest. Im Bedingungs-Builder werden die Variablen unter umgangssprachlichen Namen aufgelistet, daher erscheint level_device_restart_required wird angezeigt als Neustart des Geräts erforderlich.

Der Typ der Variablen bestimmt, was verfügbar ist:

Text: Enthält, Enthält nicht, Gleich, Ungleich
Wahr oder falsch: Gleich, Ungleich, mit einer Wahr / Falsch Auswahl
Zahl: Gleich, Ungleich, Größer als, Kleiner als, Größer als oder gleich, Kleiner als oder gleich
Datum und Uhrzeit: Größer als, Kleiner als, Größer als oder gleich, Kleiner als oder gleich, mit einer Datum-und-Uhrzeit-Auswahl

Systemvariablen-Bedingungen funktionieren bei jeder Aktion sowie bei den ereignisbasierten Auslösern (Neues Gerät erkannt, Gerät betritt Gruppe, Gerät verlässt Gruppe, Benutzerdefiniertes Feld geändert, Tag angewendet, Tag entfernt). Vollständige Details finden Sie unter Aktionsbedingungen und Auslöserbedingungen.

💡 TIPP: Vergleichen Sie mit level_device_memory statt level_device_memory_formatted. Der rohe Byte-Wert ist eine Zahl und unterstützt daher Größer-als- und Kleiner-als-Vergleiche, während der formatierte Wert ein Text ist.

Häufig gestellte Fragen

Muss ich Systemvariablen vor der Verwendung definieren? Nein. Systemvariablen sind immer in jeder Automatisierung und jedem Skript verfügbar. Öffnen Sie Variablen und wählen Sie die System Registerkarte, um die schreibgeschützte Referenz zu durchsuchen.
Was passiert, wenn ein Gerät keinen Spitznamen hat?level_device_nickname gibt eine leere Zeichenkette zurück, wenn kein Spitzname festgelegt wurde. Verwenden Sie level_device_hostname als Fallback, wenn Sie einen Wert benötigen, der immer vorhanden ist.
Kann ich Systemvariablen in Aktionsbedingungen verwenden? Ja. Es gibt einen dedizierten Systemvariable Bedingungstyp für Aktionen und ereignisbasierte Auslöser, wobei die Vergleiche dem Typ der Variablen entsprechen. Sie können Systemvariablen auch in jedem Feld referenzieren, das das Rendern von Variablen unterstützt, einschließlich Bedingungswerte.
Wie aktuell sind die Werte von Systemvariablen? Sie stammen aus dem Gerätedatensatz in Level, der aktualisiert wird, wenn das Gerät sich meldet. Ein Wert wie level_device_restart_required kann einige Minuten hinter dem Gerät selbst zurückliegen.

Verwandte Artikel