Ir al contenido principal

Variables del sistema

Variables integradas que exponen el contexto del dispositivo y grupo en cualquier automatización o script que admita renderizado de variables.

Actualizado en la última hora

Las variables del sistema son variables integradas disponibles en cada automatización y script — no se requiere configuración. Exponen metadatos en vivo del dispositivo y del grupo en tiempo de ejecución: nombre de host, direcciones IP, nombre del grupo, tags, y más.

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


Variables del sistema

Todas las variables del sistema utilizan el prefijo level_.

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 de CPU del dispositivo

level_device_cpu_cores

Número de núcleos de CPU

level_device_memory

Memoria total en bytes brutos

level_device_memory_formatted

Memoria total, legible para humanos (por ejemplo 16 GB)

level_device_os

Nombre del sistema operativo

level_device_os_version

Cadena de versión del SO

level_device_last_boot_at

Hora del último reinicio en formato ISO 8601

level_device_last_seen_at

Hora del último acceso 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 (por ejemplo HQ/Servers)

level_tag_names

Lista separada por comas de nombres de tags aplicados al dispositivo

level_tag_ids

Lista separada por comas de IDs de tags aplicados al dispositivo


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, utiliza la sintaxis ##{{variable_name}}:

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 encuentra un dispositivo en tu jerarquía de grupos — sin necesidad de una automatización separada por grupo.


Preguntas frecuentes

  • ¿Necesito definir variables del sistema antes de usarlas? No. Las variables del sistema están siempre disponibles en cada automatización y script. No aparecen en la pestaña Variables porque no son por automatización — son globales.

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

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

¿Ha quedado contestada tu pregunta?