Passer au contenu principal

Variables système

Variables intégrées qui exposent le contexte de l'appareil et du groupe dans n'importe quelle automatisation ou script qui prend en charge le rendu des variables.

Mis à jour il y a moins d’une heure

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 du dispositif et du groupe au moment de l'exécution : nom d'hôte, adresses IP, nom du groupe, tags, et plus.

Utilisez-les partout où le rendu de variable est pris en charge : actions de script, commandes shell, messages de notification, requêtes HTTP, ou valeurs de champ personnalisé.


Variables système

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

Variable

Description

level_time

Heure actuelle au format ISO 8601

level_device_id

Identifiant unique interne pour le dispositif

level_device_hostname

Le nom d'hôte du dispositif

level_device_nickname

Le surnom personnalisé assigné au dispositif

level_device_public_ip_address

L'adresse IP externe du dispositif

level_device_private_ip_addresses

Liste séparée par des virgules des adresses IP internes

level_device_architecture

Architecture CPU du dispositif

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 exemple 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 la dernière visualisation au format ISO 8601

level_group_id

ID du groupe auquel appartient le dispositif

level_group_name

Nom du groupe auquel appartient le dispositif

level_group_path

Chemin complet du groupe (par exemple HQ/Servers)

level_tag_names

Liste séparée par des virgules des noms de tags appliqués au dispositif

level_tag_ids

Liste séparée par des virgules des ID de tags appliqués au dispositif


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 de variable et sélectionnez 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 dans un script directement, utilisez la syntaxe ##{{variable_name}} :

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

💡 CONSEIL : level_group_path est utile pour les scripts qui ont besoin de se comporter différemment selon où se trouve un dispositif dans votre hiérarchie de groupes — sans avoir besoin d'une automatisation séparée 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 parce qu'elles ne sont pas par automatisation — elles sont globales.

  • Que se passe-t-il si un dispositif 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 des variables système dans les conditions d'action ? Oui. N'importe quel champ qui prend en charge le rendu de variable — y compris les valeurs de condition — peut référencer les variables système.

Avez-vous trouvé la réponse à votre question ?