Introducción

Las variables del sistema son variables integradas disponibles en cada automatización y script, sin necesidad de configuración. Exponen metadatos en tiempo real del dispositivo y del grupo: nombre de host, direcciones IP, nombre del grupo, etiquetas y más.

Úselas 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. También puede compararlas directamente en una condición sobre una acción o un desencadenador basado en eventos.

Variables del sistema

Todas las variables del sistema usan el level_ prefijo. Cada una tiene un tipo, que determina las comparaciones disponibles cuando se usa en una condición.

Variable	Tipo	Descripción
`level_time`	Fecha y hora	Hora actual en formato ISO 8601
`level_device_id`	Texto	Identificador único interno del dispositivo
`level_device_hostname`	Texto	El nombre de host del dispositivo
`level_device_nickname`	Texto	El apodo personalizado asignado al dispositivo
`level_device_public_ip_address`	Texto	La dirección IP externa del dispositivo
`level_device_private_ip_addresses`	Texto	Lista separada por comas de direcciones IP internas
`level_device_architecture`	Texto	Arquitectura de CPU del dispositivo
`level_device_cpu_cores`	Número	Número de núcleos de CPU
`level_device_memory`	Número	Memoria total en bytes sin procesar
`level_device_memory_formatted`	Texto	Memoria total, legible por humanos (p. ej. `16 GB`)
`level_device_os`	Texto	Nombre del sistema operativo
`level_device_os_version`	Texto	Cadena de versión del sistema operativo
`level_device_manufacturer`	Texto	Fabricante de hardware reportado por el dispositivo (p. ej. `Dell Inc.`)
`level_device_model`	Texto	Modelo de hardware reportado por el dispositivo (p. ej. `OptiPlex 7090`)
`level_device_last_boot_at`	Fecha y hora	Hora del último reinicio en formato ISO 8601
`level_device_last_seen_at`	Fecha y hora	Hora de la última vez visto en formato ISO 8601
`level_device_first_seen_at`	Fecha y hora	Hora en que el dispositivo fue añadido por primera vez a Level, en formato ISO 8601
`level_device_online`	Verdadero o falso	Si el dispositivo está actualmente en línea: `true` o `false`
`level_device_maintenance_mode`	Verdadero o falso	Si el dispositivo está actualmente en modo de mantenimiento: `true` o `false`
`level_device_restart_required`	Verdadero o falso	Si el dispositivo está esperando un reinicio: `true` o `false`
`level_group_id`	Texto	ID del grupo al que pertenece el dispositivo
`level_group_name`	Texto	Nombre del grupo al que pertenece el dispositivo
`level_group_path`	Texto	Ruta completa del grupo (p. ej. `HQ / Servers`)
`level_tag_names`	Texto	Lista separada por comas de nombres de etiquetas aplicadas al dispositivo
`level_tag_ids`	Texto	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 compárelas como cadenas en sus 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

Abra una automatización o script y seleccione Variables, luego seleccione la Sistema pestaña para explorar las variables integradas disponibles en Level. Busque por nombre de variable o descripción, o filtre la lista por tipo. La tabla muestra la referencia, descripción, tipo y un valor de ejemplo de cada variable. Las variables del sistema son de solo lectura y no necesitan crearse antes de usarse.

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

Para insertar una variable del sistema en una acción, haga clic en el ícono de variable en cualquier campo que admita representación de variables y seleccione de la lista. Las variables del sistema aparecen junto con cualquier variable de automatización definida para esa automatización.

Para referenciar una variable en un script directamente, use 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 dónde se encuentre un dispositivo en la jerarquía de grupos, sin necesidad de una automatización separada por grupo.

Uso de variables del sistema en condiciones

Las variables del sistema también son un tipo de condición. Agregue una condición, elija Variable del sistema, elija la variable, luego establezca la comparación y el valor. En el constructor de condiciones, las variables se enumeran bajo nombres en lenguaje sencillo, por lo que level_device_restart_required aparece como Reinicio del dispositivo requerido.

El tipo de la variable controla lo que obtiene:

Texto: Contiene, No contiene, Igual a, No igual a
Verdadero o falso: Igual a, No igual a, con un Verdadero / Falso selector
Número: Igual a, No igual a, Mayor que, Menor que, Mayor o igual que, Menor o igual que
Fecha y hora: Mayor que, Menor que, Mayor o igual que, Menor o igual que, con un selector de fecha y hora

Las condiciones de variables del sistema funcionan en todas las acciones y en los desencadenadores basados en eventos (Nuevo dispositivo detectado, El dispositivo entra en el grupo, El dispositivo sale del grupo, Campo personalizado modificado, Etiqueta aplicada, Etiqueta eliminada). Para más detalles, consulte Condiciones de acción y Condiciones de desencadenador.

💡 CONSEJO: Compare sobre level_device_memory en lugar de level_device_memory_formatted. El valor en bytes sin procesar es un número, por lo que admite mayor que y menor que, mientras que el valor formateado es texto.

Preguntas frecuentes

¿Necesito definir las variables del sistema antes de usarlas? No. Las variables del sistema están siempre disponibles en cada automatización y script. Abra Variables y seleccione la Sistema pestaña para buscar en la referencia de solo lectura.
¿Qué ocurre si un dispositivo no tiene apodo?level_device_nickname devuelve una cadena vacía si no se ha establecido ningún apodo. Use level_device_hostname como alternativa si necesita un valor que siempre esté presente.
¿Puedo usar variables del sistema en condiciones de acción? Sí. Existe un tipo dedicado Variable del sistema tipo de condición en acciones y en desencadenadores basados en eventos, con las comparaciones ajustadas al tipo de la variable. También puede referenciar variables del sistema dentro de cualquier campo que admita representación de variables, incluidos los valores de condición.
¿Qué tan actualizados son los valores de las variables del sistema? Provienen del registro del dispositivo en Level, que se actualiza cuando el dispositivo informa. Un valor como level_device_restart_required puede estar unos minutos por detrás del dispositivo en sí.