Introduction

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

Utilisez-les partout où le rendu de 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 de l'appareil
`level_device_hostname`	Le nom d'hôte de l'appareil
`level_device_nickname`	Le surnom personnalisé attribué à 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'humain (p. 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`	Heure du dernier redémarrage au format ISO 8601
`level_device_last_seen_at`	Heure de dernière connexion 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 (p. ex. `HQ/Servers`)
`level_tag_names`	Liste séparée par des virgules des noms de balises appliquées à l'appareil
`level_tag_ids`	Liste séparée par des virgules des ID de balises appliquées à l'appareil

Utiliser les Variables Système

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

Pour référencer une variable dans un script directement, utilisez la {{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 l'emplacement d'un appareil dans la hiérarchie de vos groupes — sans nécessiter une automatisation 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 automatisation et script. Elles n'apparaissent pas dans l'onglet Variables car elles ne sont pas spécifiques à une automatisation — elles sont globales.
Que se passe-t-il si un appareil n'a pas de surnom ? level_device_nickname renvoie une chaîne vide si aucun surnom n'a été défini. Utilisez level_device_hostname comme valeur de repli si vous avez besoin d'une valeur toujours présente.
Puis-je utiliser des variables système dans les conditions d'action ? Oui. Tout champ prenant en charge le rendu de variables — y compris les valeurs de condition — peut référencer des variables système.