Introduction

Les variables système sont des variables intégrées disponibles dans chaque automation et script — aucune configuration requise. Elles exposent les métadonnées d'appareil et de groupe en direct lors de l'exécution : nom d'hôte, adresses IP, nom du groupe, balises, et bien plus.

Utilisez-les n'importe où le rendu des variables est pris en charge : actions de script, commandes shell, messages de notification, requêtes HTTP ou valeurs de champs personnalisés.

Variables Système

Toutes les variables système utilisent le level_ préfixe.

Variable	Description
`level_time`	Heure actuelle au format ISO 8601
`level_device_id`	Identifiant unique interne pour l'appareil
`level_device_hostname`	Le nom d'hôte de l'appareil
`level_device_nickname`	Le surnom personnalisé assigné à l'appareil
`level_device_public_ip_address`	L'adresse IP externe de l'appareil
`level_device_private_ip_addresses`	Liste séparée par des virgules des adresses IP internes
`level_device_architecture`	Architecture CPU de l'appareil
`level_device_cpu_cores`	Nombre de cœurs CPU
`level_device_memory`	Mémoire totale en octets bruts
`level_device_memory_formatted`	Mémoire totale, lisible par l'homme (par ex. `16 GB`)
`level_device_os`	Nom du système d'exploitation
`level_device_os_version`	Chaîne de version du système d'exploitation
`level_device_last_boot_at`	Dernier redémarrage au format ISO 8601
`level_device_last_seen_at`	Dernière fois vu au format ISO 8601
`level_group_id`	ID du groupe auquel appartient l'appareil
`level_group_name`	Nom du groupe auquel appartient l'appareil
`level_group_path`	Chemin complet du groupe (par ex. `HQ/Servers`)
`level_tag_names`	Liste séparée par des virgules des noms de balises appliqués à l'appareil
`level_tag_ids`	Liste séparée par des virgules des ID de balises appliqués à l'appareil

Utilisation des Variables Système

Pour insérer une variable système dans une action, cliquez sur l'icône de variable dans n'importe quel champ qui prend en charge le rendu des variables et sélectionnez dans la liste. Les variables système apparaissent aux côtés de toutes les variables d'automation définies pour cette automation.

Pour référencer une variable dans un script directement, utilisez le ##{{variable_name}} syntaxe :

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

💡 CONSEIL : level_group_path est utile pour les scripts qui doivent se comporter différemment selon la position d'un appareil dans votre hiérarchie de groupe — sans avoir besoin d'une automation distincte par groupe.

FAQ

Dois-je définir les variables système avant de les utiliser ? Non. Les variables système sont toujours disponibles dans chaque automation et script. Elles n'apparaissent pas dans l'onglet Variables car elles ne sont pas par automation — elles sont globales.
Que se passe-t-il si un appareil n'a pas de surnom ? level_device_nickname retourne une chaîne vide si aucun surnom n'a été défini. Utilisez level_device_hostname comme secours si vous avez besoin d'une valeur toujours présente.
Puis-je utiliser les variables système dans les conditions d'action ? Oui. N'importe quel champ qui prend en charge le rendu des variables — y compris les valeurs de condition — peut référencer les variables système.