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.
Systemvariablen
Alle Systemvariablen verwenden das level_ Präfix.
Variable | Beschreibung |
| Aktuelle Uhrzeit im ISO 8601-Format |
| Interner eindeutiger Bezeichner des Geräts |
| Der Hostname des Geräts |
| Der dem Gerät zugewiesene benutzerdefinierte Spitzname |
| Die externe IP-Adresse des Geräts |
| Kommagetrennte Liste interner IP-Adressen |
| CPU-Architektur des Geräts |
| Anzahl der CPU-Kerne |
| Gesamtspeicher in rohen Bytes |
| Gesamtspeicher, lesbar (z. B. |
| Name des Betriebssystems |
| Versionsstring des Betriebssystems |
| Letzter Neustartzeitpunkt im ISO 8601-Format |
| Zuletzt gesehen-Zeitpunkt im ISO 8601-Format |
| ID 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. |
| Kommagetrennte Liste der auf das Gerät angewendeten Tag-Namen |
| Kommagetrennte Liste der auf das Gerät angewendeten Tag-IDs |
Systemvariablen verwenden
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 aus. Systemvariablen werden zusammen mit allen für die jeweilige Automatisierung definierten Automatisierungsvariablen angezeigt.
Um eine Variable in einem Skript direkt 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 unterschiedlich verhalten müssen, je nachdem, wo ein Gerät in Ihrer Gruppenhierarchie angesiedelt ist – ohne eine separate Automatisierung pro Gruppe zu benötigen.
FAQ
Muss ich Systemvariablen vor der Verwendung definieren? Nein. Systemvariablen sind immer in jeder Automatisierung und jedem Skript verfügbar. Sie erscheinen nicht im Tab „Variablen", da sie nicht automatisierungsspezifisch sind – sie sind global.
Was passiert, wenn ein Gerät keinen Spitznamen hat?
level_device_nicknamegibt einen leeren String zurück, wenn kein Spitzname festgelegt wurde. Verwenden Sielevel_device_hostnameals Fallback verwenden, wenn Sie einen immer vorhandenen Wert benötigen.Kann ich Systemvariablen in Aktionsbedingungen verwenden? Ja. Jedes Feld, das das Rendern von Variablen unterstützt – einschließlich Bedingungswerte –, kann Systemvariablen referenzieren.