Systemvariablen sind integrierte Variablen, die in jeder Automatisierung und jedem Skript verfügbar sind — keine Einrichtung erforderlich. Sie zeigen Live-Metadaten zum Gerät und zur Gruppe zur Laufzeit: Hostname, IP-Adressen, Gruppenname, Tags und mehr.
Verwenden Sie sie überall dort, wo das Rendern von Variablen unterstützt wird: Skriptaktionen, Shell-Befehle, Benachrichtigungsmeldungen, HTTP-Anfragen oder benutzerdefinierte Feldwerte.
Systemvariablen
Alle Systemvariablen verwenden das Präfix level_.
Variable | Beschreibung |
| Aktuelle Zeit im ISO-8601-Format |
| Interne eindeutige Kennung für das Gerät |
| Der Hostname des Geräts |
| Der dem Gerät zugewiesene benutzerdefinierte Spitzname |
| Die externe IP-Adresse des Geräts |
| Durch Kommas getrennte Liste der internen IP-Adressen |
| CPU-Architektur des Geräts |
| Anzahl der CPU-Kerne |
| Gesamter Speicher in rohen Bytes |
| Gesamter Speicher, menschenlesbar (z. B. |
| Name des Betriebssystems |
| Versionscode des Betriebssystems |
| Zeit des letzten Neustarts im ISO-8601-Format |
| Zuletzt angesehene Zeit im ISO-8601-Format |
| Kennung der Gruppe, zu der das Gerät gehört |
| Name der Gruppe, zu der das Gerät gehört |
| Vollständiger Pfad der Gruppe (z. B. |
| Durch Kommas getrennte Liste der auf das Gerät angewendeten Tag-Namen |
| Durch Kommas getrennte Liste der auf das Gerät angewendeten Tag-IDs |
Verwendung von Systemvariablen
Um eine Systemvariable in eine Aktion einzufügen, klicken Sie auf das Variablensymbol in jedem Feld, das das Rendern von Variablen unterstützt, und wählen Sie aus der Liste. Systemvariablen werden zusammen mit allen für diese Automatisierung definierten Automatisierungsvariablen angezeigt.
Um auf eine Variable in einem Skript direkt zu verweisen, verwenden Sie die Syntax ##{{variable_name}}:
echo "Running on ##{{level_device_hostname}} in ##{{level_group_path}}"💡 TIPP: level_group_path ist nützlich für Skripte, die sich unterschiedlich verhalten müssen, je nachdem, wo sich ein Gerät in Ihrer Gruppenhierarchie befindet — ohne dass Sie für jede Gruppe eine separate Automatisierung benötigen.
FAQ
Muss ich Systemvariablen definieren, bevor ich sie verwende? Nein. Systemvariablen sind in jeder Automatisierung und jedem Skript immer verfügbar. Sie erscheinen nicht auf der Registerkarte Variablen, da sie nicht pro Automatisierung gelten — sie sind global.
Was ist, wenn ein Gerät keinen Spitznamen hat?
level_device_nicknamegibt eine leere Zeichenkette zurück, wenn kein Spitzname festgelegt wurde. Verwenden Sielevel_device_hostnameals Fallback, wenn Sie einen Wert benötigen, der immer vorhanden ist.Kann ich Systemvariablen in Aktionsbedingungen verwenden? Ja. Jedes Feld, das das Rendern von Variablen unterstützt — einschließlich Bedingungswerte — kann auf Systemvariablen verweisen.