Introducción

Las variables del sistema son variables integradas disponibles en todas las automatizaciones y scripts, sin necesidad de configuración. 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 direcciones IP internas
`level_device_architecture`	Arquitectura del CPU del dispositivo
`level_device_cpu_cores`	Número de núcleos del CPU
`level_device_memory`	Memoria total en bytes sin procesar
`level_device_memory_formatted`	Memoria total, 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_manufacturer`	Fabricante del hardware reportado por el dispositivo (p. ej. `Dell Inc.`)
`level_device_model`	Modelo del hardware reportado por el dispositivo (p. ej. `OptiPlex 7090`)
`level_device_last_boot_at`	Última hora de reinicio en formato ISO 8601
`level_device_last_seen_at`	Última hora de conexión en formato ISO 8601
`level_device_first_seen_at`	Hora en que el dispositivo fue añadido por primera vez a Level, en formato ISO 8601
`level_device_online`	Si el dispositivo está actualmente en línea: `true` o `false`
`level_device_maintenance_mode`	Si el dispositivo está actualmente en modo de mantenimiento: `true` o `false`
`level_device_restart_required`	Si el dispositivo está esperando un reinicio: `true` o `false`
`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 nombres de etiquetas aplicadas al dispositivo
`level_tag_ids`	Lista separada por comas de IDs de etiquetas aplicadas al dispositivo

ℹ️ NOTA: Las tres variables de sí/no (level_device_online, level_device_maintenance_mode, level_device_restart_required) se representan como el texto true o false, por lo que debes compararlos como cadenas en tus scripts. Las variables que el dispositivo aún no ha reportado, como level_device_manufacturer en un equipo sin inventario de hardware, se representan como una cadena vacía.

Uso de variables del sistema

Para insertar una variable del sistema en una acción, haz clic en el icono de variable en cualquier campo que admita la representación de variables y selecciona de la lista. Las variables del sistema aparecen junto con cualquier variable de automatización definida 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 el lugar donde se encuentra 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 ningún 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.