Introducción
Cuando clonas un dispositivo que ya tiene el agente de Level instalado, tanto el original como el clon comparten el mismo ID de agente. Esto provoca un conflicto: los dos dispositivos compiten por la misma entrada en Level y uno o ambos mostrarán una conectividad errática. Este artículo muestra cómo rotar el ID de agente en el dispositivo clonado para resolverlo.
ℹ️ NOTA: Esto solo afecta a los dispositivos clonados. Reinstalar el agente en un dispositivo existente no cambia su ID — Level conserva el ID original durante las reinstalaciones para evitar entradas duplicadas.
Rotar el ID de agente automáticamente
La solución más rápida es el --new-agent-id flag. Genera un nuevo UUID, actualiza la configuración y reinicia el agente en un solo paso.
Ejecuta esto en el clonado dispositivo:
🖥️ NOTA DE PLATAFORMA:
Windows:
& 'C:\Program Files\Level\level.exe' --new-agent-idmacOS:
sudo /usr/local/bin/level --new-agent-idLinux:
sudo /usr/local/bin/level --new-agent-id
Después de que el agente se reinicie, el dispositivo clonado se registrará como una nueva entrada en Level. El dispositivo original no se verá afectado.
Rotar el ID de agente manualmente
Si no puedes ejecutar el binario del agente directamente (p. ej., el agente está detenido o el binario no es accesible), puedes editar el ID directamente en la configuración.
⚠️ ADVERTENCIA: Establece el valor en un UUID v4 válido (generado aleatoriamente). No reutilices un ID de otro dispositivo y no dejes el campo en blanco. Después de editar, reinicia el servicio de Level para que el cambio surta efecto.
🖥️ NOTA DE PLATAFORMA:
Windows — Clave de registro:
Ruta:
HKEY_LOCAL_MACHINE\SOFTWARE\LevelNombre de clave:
AgentIDCambia el valor a un nuevo UUID.
macOS — Archivo de configuración:
Ruta:
/Library/Application Support/Level/config.yamlNombre de clave:
agent-idReemplaza el valor existente por un nuevo UUID.
Linux — Archivo de configuración:
Ruta:
/etc/level/config.yamlNombre de clave:
agent-idReemplaza el valor existente por un nuevo UUID.
Después de editar, reinicia el servicio de Level:
🖥️ NOTA DE PLATAFORMA:
Windows:
Restart-Service -Name LevelmacOS:
sudo launchctl kickstart -k system/LevelLinux:
systemctl restart Level
Cómo evitar esto en el futuro
Dos opciones para flujos de trabajo de aprovisionamiento basados en clonación:
Opción 1 — Rotar el UUID después de clonar (recomendado): Mantén el agente en tu imagen maestra y ejecuta --new-agent-id como parte de tu paso de aprovisionamiento post-clonación (mediante MDM, script de inicio o RMM). Cada dispositivo clonado obtiene un ID nuevo automáticamente en el primer arranque sin ninguna intervención manual.
Opción 2 — Desinstalar antes de crear la imagen: Elimina el agente de Level antes de crear la imagen maestra y, luego, instala Level como paso post-clonación. Cada dispositivo obtiene un ID de agente nuevo desde la instalación.
💡 CONSEJO: Las guías de instalación de Level para Windows, macOS y Linux incluyen comandos de instalación silenciosa adecuados para scripts de implementación y flujos de trabajo MDM post-clonación.
Preguntas frecuentes
¿En qué dispositivo debo ejecutar --new-agent-id, en el original o en el clon? Ejecútalo en el clon. El dispositivo original tiene el ID «correcto» que ya está registrado en Level. Rotar el ID del clon lo registra como un nuevo dispositivo sin afectar al original.
Después de rotar el ID, ¿el dispositivo clonado heredará los grupos, etiquetas y campos personalizados del original? No. El dispositivo clonado se registra como un dispositivo completamente nuevo en Level. Tendrás que asignarlo a los grupos y etiquetas correspondientes. Los valores de campos personalizados del original no se transferirán.
¿Puedo enviar --new-agent-id a través de Level si ambos dispositivos aparecen de forma intermitente? No es fiable cuando dos dispositivos compiten por el mismo ID. El acceso local u otra herramienta remota es más seguro. Una vez que hayas rotado el ID en el clon, ambos dispositivos tendrán conexiones estables e independientes.
¿Cómo genero un UUID válido para usar en una rotación manual de ID? En Windows:
[guid]::NewGuid().ToString()en PowerShell. En macOS/Linux:uuidgen. Cualquiera de los dos produce un UUID v4 válido.