Zum Hauptinhalt springen

Systemvariablen

Integrierte Variablen, die Geräte- und Gruppenkontexte in jeder Automatisierung oder jedem Skript offenlegen, das Variable Rendering unterstützt.

Einführung

Systemvariablen sind integrierte Variablen, die in jeder Automation und jedem Skript verfügbar sind — keine Einrichtung erforderlich. Sie zeigen Live-Geräte- und Gruppenmetadaten zur Laufzeit an: Hostname, IP-Adressen, Gruppenname, Tags und mehr.

Verwenden Sie sie überall dort, wo Variablendarstellung unterstützt wird: Skriptaktionen, Shell-Befehle, Benachrichtigungsmeldungen, HTTP-Anfragen oder benutzerdefinierte Feldwerte.


Systemvariablen

Alle Systemvariablen verwenden das level_ Präfix.

Variable

Beschreibung

level_time

Aktuelle Uhrzeit im ISO-8601-Format

level_device_id

Interne eindeutige Kennung für das Gerät

level_device_hostname

Der Hostname des Geräts

level_device_nickname

Der dem Gerät zugewiesene benutzerdefinierte Spitzname

level_device_public_ip_address

Die externe IP-Adresse des Geräts

level_device_private_ip_addresses

Kommagetrennte Liste mit internen IP-Adressen

level_device_architecture

CPU-Architektur des Geräts

level_device_cpu_cores

Anzahl der CPU-Kerne

level_device_memory

Gesamtspeicher in Rohbytes

level_device_memory_formatted

Gesamtspeicher, lesbar (z.B. 16 GB)

level_device_os

Name des Betriebssystems

level_device_os_version

Betriebssystem-Versionszeichenfolge

level_device_last_boot_at

Letzte Startzeit im ISO-8601-Format

level_device_last_seen_at

Zuletzt gesehen im ISO-8601-Format

level_group_id

Kennung der Gruppe, zu der das Gerät gehört

level_group_name

Name der Gruppe, zu der das Gerät gehört

level_group_path

Vollständiger Pfad der Gruppe (z.B. HQ/Servers)

level_tag_names

Kommagetrennte Liste mit auf das Gerät angewendeten Tag-Namen

level_tag_ids

Kommagetrennte Liste mit auf das Gerät angewendeten Tag-Kennungen


Verwendung von Systemvariablen

Um eine Systemvariable in eine Aktion einzufügen, klicken Sie auf das Variablensymbol in einem beliebigen Feld, das Variablendarstellung unterstützt, und wählen Sie aus der Liste. Systemvariablen werden neben den für diese Automation definierten Automationsvariablen angezeigt.

Um direkt auf eine Variable in einem Skript zu verweisen, 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 nach Position eines Geräts in Ihrer Gruppenhierarchie unterschiedlich verhalten müssen — ohne dass eine separate Automation pro Gruppe erforderlich ist.


Häufig gestellte Fragen

  • Muss ich Systemvariablen vor der Verwendung definieren? Nein. Systemvariablen sind immer in jeder Automation und jedem Skript verfügbar. Sie werden nicht auf der Registerkarte "Variablen" angezeigt, da sie nicht pro Automation vorliegen — sie sind global.

  • Was ist, wenn ein Gerät keinen Spitznamen hat? level_device_nickname gibt eine leere Zeichenfolge 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. Jedes Feld, das Variablendarstellung unterstützt — einschließlich Bedingungswerte — kann auf Systemvariablen verweisen.

Hat dies deine Frage beantwortet?