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.

Introducción

Las variables del sistema son variables integradas disponibles en cada automatización y script — sin configuración requerida. Exponen metadatos de dispositivo y grupo en vivo en tiempo de 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 shell, mensajes de notificación, solicitudes HTTP o valores de campos personalizados.


Variables del Sistema

Todas las variables del sistema utilizan el level_ 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 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, legible por humanos (p. ej. 16 GB)

level_device_os

Nombre del sistema operativo

level_device_os_version

Cadena de versión del SO

level_device_last_boot_at

Última hora de reinicio en formato ISO 8601

level_device_last_seen_at

Última vez visto 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 nombres de etiquetas aplicadas al dispositivo

level_tag_ids

Lista separada por comas de IDs de etiquetas aplicadas al dispositivo


Uso de Variables del Sistema

Para insertar una variable del sistema en una acción, haga clic en el icono de variable en cualquier campo que admita la 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 hacer referencia a 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 diferente según dónde se encuentre un dispositivo en su jerarquía de grupo — sin necesidad de una automatización separada por grupo.


Preguntas Frecuentes

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

  • ¿Qué pasa si un dispositivo no tiene un 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 siempre esté 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?