Ir al contenido principal

Variables del Sistema

Built-in variables that expose device and group context in any automation or script that supports variable rendering.

Introducción

Las variables del sistema son variables integradas disponibles en todas las automatizaciones y scripts, sin necesidad de configuración previa. Exponen metadatos en tiempo real del dispositivo y del grupo durante la ejecución: nombre de host, direcciones IP, nombre del grupo, etiquetas y más.

Úsalas en cualquier lugar donde se admita la representación de variables: acciones de script, comandos de shell, mensajes de notificación, solicitudes HTTP o valores de campos personalizados.


Variables del Sistema

Todas las variables del sistema usan el level_ como prefijo.

Variable

Descripción

level_time

Hora actual en formato ISO 8601

level_device_id

Identificador único interno del dispositivo

level_device_hostname

El nombre de host del dispositivo

level_device_nickname

El apodo personalizado asignado al dispositivo

level_device_public_ip_address

La dirección IP externa del dispositivo

level_device_private_ip_addresses

Lista separada por comas de las direcciones IP internas

level_device_architecture

Arquitectura de CPU del dispositivo

level_device_cpu_cores

Número de núcleos de CPU

level_device_memory

Memoria total en bytes sin procesar

level_device_memory_formatted

Memoria total, formato legible por humanos (p. ej. 16 GB)

level_device_os

Nombre del sistema operativo

level_device_os_version

Cadena de versión del sistema operativo

level_device_last_boot_at

Hora del último reinicio en formato ISO 8601

level_device_last_seen_at

Hora de la última conexión en formato ISO 8601

level_group_id

ID del grupo al que pertenece el dispositivo

level_group_name

Nombre del grupo al que pertenece el dispositivo

level_group_path

Ruta completa del grupo (p. ej. HQ/Servers)

level_tag_names

Lista separada por comas de los nombres de etiquetas aplicadas al dispositivo

level_tag_ids

Lista separada por comas de los IDs de etiquetas aplicadas al dispositivo


Uso de las Variables del Sistema

Para insertar una variable del sistema en una acción, haz clic en el ícono de variable en cualquier campo que admita la representación de variables y selecciona de la lista. Las variables del sistema aparecen junto a las variables de automatización definidas para esa automatización.

Para hacer referencia a una variable en un script directamente, usa la {{variable_name}} sintaxis:

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

💡 CONSEJO: level_group_path es útil para scripts que necesitan comportarse de manera diferente según la ubicación de un dispositivo en la jerarquía de grupos, sin necesidad de una automatización separada por grupo.


Preguntas Frecuentes

  • ¿Necesito definir las variables del sistema antes de usarlas? No. Las variables del sistema están siempre disponibles en todas las automatizaciones y scripts. No aparecen en la pestaña Variables porque no son por automatización, sino globales.

  • ¿Qué ocurre si un dispositivo no tiene apodo? level_device_nickname devuelve una cadena vacía si no se ha establecido un apodo. Usa level_device_hostname como alternativa si necesitas un valor que esté siempre presente.

  • ¿Puedo usar variables del sistema en condiciones de acción? Sí. Cualquier campo que admita la representación de variables, incluidos los valores de condición, puede hacer referencia a variables del sistema.

¿Ha quedado contestada tu pregunta?