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 temps réel de l'appareil et du groupe au moment de l'exécution : nom d'hôte, adresses IP, nom du groupe, balises, et bien plus.

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_ comme 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 d'adresses IP internes séparées par des virgules
`level_device_architecture`	Architecture du processeur de l'appareil
`level_device_cpu_cores`	Nombre de cœurs du processeur
`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_manufacturer`	Fabricant du matériel tel que rapporté par l'appareil (p. ex. `Dell Inc.`)
`level_device_model`	Modèle du matériel tel que rapporté par l'appareil (p. ex. `OptiPlex 7090`)
`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_device_first_seen_at`	Heure à laquelle l'appareil a été ajouté pour la première fois à Level, au format ISO 8601
`level_device_online`	Indique si l'appareil est actuellement en ligne : `true` ou `false`
`level_device_maintenance_mode`	Indique si l'appareil est actuellement en mode maintenance : `true` ou `false`
`level_device_restart_required`	Indique si l'appareil attend un redémarrage : `true` ou `false`
`level_group_id`	Identifiant 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 de noms de balises appliquées à l'appareil, séparées par des virgules
`level_tag_ids`	Liste d'identifiants de balises appliquées à l'appareil, séparées par des virgules

ℹ️ REMARQUE : Les trois variables oui/non (level_device_online, level_device_maintenance_mode, level_device_restart_required) s'affichent sous la forme du texte true ou false, donc comparez-les en tant que chaînes dans vos scripts. Les variables que l'appareil n'a pas encore signalées, telles que level_device_manufacturer sur une machine sans inventaire matériel, s'affichent comme une chaîne vide.

Utilisation des 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-en une dans la liste. Les variables système apparaissent aux côtés de toute variable d'automatisation définie pour cette automatisation.

Pour référencer une variable directement dans un script, 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 la position d'un appareil dans la hiérarchie de vos groupes — sans avoir besoin d'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 propres à une automatisation — 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 valeur de substitution 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.