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, étiquettes, et bien 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. Vous pouvez également les comparer directement dans une condition sur une action ou un déclencheur basé sur un événement.

Variables Système

Toutes les variables système utilisent le level_ préfixe. Chacune possède un type, qui détermine les comparaisons disponibles lorsque vous l'utilisez dans une condition.

Variable	Type	Description
`level_time`	Date et heure	Heure actuelle au format ISO 8601
`level_device_id`	Texte	Identifiant unique interne de l'appareil
`level_device_hostname`	Texte	Le nom d'hôte de l'appareil
`level_device_nickname`	Texte	Le surnom personnalisé attribué à l'appareil
`level_device_public_ip_address`	Texte	L'adresse IP externe de l'appareil
`level_device_private_ip_addresses`	Texte	Liste séparée par des virgules des adresses IP internes
`level_device_architecture`	Texte	Architecture du processeur de l'appareil
`level_device_cpu_cores`	Nombre	Nombre de cœurs du processeur
`level_device_memory`	Nombre	Mémoire totale en octets bruts
`level_device_memory_formatted`	Texte	Mémoire totale, lisible par l'humain (p. ex. `16 GB`)
`level_device_os`	Texte	Nom du système d'exploitation
`level_device_os_version`	Texte	Chaîne de version du système d'exploitation
`level_device_manufacturer`	Texte	Fabricant du matériel rapporté par l'appareil (p. ex. `Dell Inc.`)
`level_device_model`	Texte	Modèle du matériel rapporté par l'appareil (p. ex. `OptiPlex 7090`)
`level_device_last_boot_at`	Date et heure	Heure du dernier redémarrage au format ISO 8601
`level_device_last_seen_at`	Date et heure	Heure de dernière connexion au format ISO 8601
`level_device_first_seen_at`	Date et heure	Heure à laquelle l'appareil a été ajouté pour la première fois à Level, au format ISO 8601
`level_device_online`	Vrai ou faux	Si l'appareil est actuellement en ligne : `true` ou `false`
`level_device_maintenance_mode`	Vrai ou faux	Si l'appareil est actuellement en mode maintenance : `true` ou `false`
`level_device_restart_required`	Vrai ou faux	Si l'appareil attend un redémarrage : `true` ou `false`
`level_group_id`	Texte	Identifiant du groupe auquel appartient l'appareil
`level_group_name`	Texte	Nom du groupe auquel appartient l'appareil
`level_group_path`	Texte	Chemin complet du groupe (p. ex. `HQ / Servers`)
`level_tag_names`	Texte	Liste séparée par des virgules des noms d'étiquettes appliquées à l'appareil
`level_tag_ids`	Texte	Liste séparée par des virgules des identifiants d'étiquettes appliquées à l'appareil

ℹ️ REMARQUE : Les trois variables oui/non (level_device_online, level_device_maintenance_mode, level_device_restart_required) s'affichent comme le texte true ou false, donc comparez-les comme des 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

Ouvrez une automatisation ou un script et sélectionnez Variables, puis sélectionnez l'onglet Système onglet pour parcourir les variables intégrées disponibles dans Level. Recherchez par nom de variable ou par description, ou filtrez la liste par type. Le tableau affiche la référence, la description, le type et un exemple de valeur pour chaque variable. Les variables système sont en lecture seule et n'ont pas besoin d'être créées avant utilisation.

System Variables tab with search, type filter, and variable reference columns

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 des 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 avoir besoin d'une automatisation distincte par groupe.

Utilisation des Variables Système dans les Conditions

Les variables système sont également un type de condition. Ajoutez une condition, choisissez Variable système, choisissez la variable, puis définissez la comparaison et la valeur. Dans le générateur de conditions, les variables sont listées sous des noms en langage courant, donc level_device_restart_required apparaît comme Redémarrage de l'appareil requis.

Le type de la variable détermine ce que vous obtenez :

Texte: Contient, Ne contient pas, Égal à, Différent de
Vrai ou faux: Égal à, Différent de, avec un Vrai / Faux sélecteur
Nombre: Égal à, Différent de, Supérieur à, Inférieur à, Supérieur ou égal à, Inférieur ou égal à
Date et heure: Supérieur à, Inférieur à, Supérieur ou égal à, Inférieur ou égal à, avec un sélecteur de date et heure

Les conditions de variables système fonctionnent sur toutes les actions, et sur les déclencheurs basés sur des événements (Nouvel appareil détecté, L'appareil entre dans le groupe, L'appareil quitte le groupe, Champ personnalisé modifié, Étiquette appliquée, Étiquette supprimée). Pour plus de détails, voir Conditions d'Action et Conditions de Déclencheur.

💡 CONSEIL : Comparez sur level_device_memory plutôt que level_device_memory_formatted. La valeur en octets bruts est un nombre, elle prend donc en charge supérieur à et inférieur à, tandis que la valeur formatée est du texte.

Questions fréquentes

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. Ouvrez Variables et sélectionnez l'onglet Système onglet pour rechercher dans la référence en lecture seule.
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 secours si vous avez besoin d'une valeur toujours présente.
Puis-je utiliser des variables système dans les conditions d'action ? Oui. Il existe un type Variable système type de condition sur les actions et sur les déclencheurs basés sur des événements, avec des comparaisons adaptées au type de la variable. Vous pouvez également référencer des variables système dans tout champ prenant en charge le rendu de variables, y compris les valeurs de condition.
Dans quelle mesure les valeurs des variables système sont-elles à jour ? Elles proviennent de l'enregistrement de l'appareil dans Level, qui se met à jour lorsque l'appareil se connecte. Une valeur telle que level_device_restart_required peut avoir quelques minutes de retard par rapport à l'appareil lui-même.