Introducción
Cuando se clona un dispositivo que ya tiene el agente de Level instalado, tanto el original como el clon comparten el mismo ID de agente. Esto genera 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 explica cómo rotar el ID del 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 del agente automáticamente
La solución más rápida es la --new-agent-id bandera. Genera un nuevo UUID, actualiza la configuración y reinicia el agente en un solo paso.
Ejecute 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 del agente manualmente
Si no puede ejecutar el binario del agente directamente (por ejemplo, el agente está detenido o el binario no es accesible), puede editar el ID directamente en el archivo de configuración.
⚠️ ADVERTENCIA: Establezca el valor en un UUID v4 válido (generado aleatoriamente). No reutilice un ID de otro dispositivo ni deje el campo en blanco. Después de editarlo, reinicie 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:
AgentIDCambie el valor a un nuevo UUID.
macOS — Archivo de configuración:
Ruta:
/Library/Application Support/Level/config.yamlNombre de clave:
agent-idReemplace el valor existente con un nuevo UUID.
Linux — Archivo de configuración:
Ruta:
/etc/level/config.yamlNombre de clave:
agent-idReemplace el valor existente con un nuevo UUID.
Después de editar, reinicie 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 la clonación (recomendado): Mantenga el agente en su imagen maestra y ejecute --new-agent-id como parte de su paso de aprovisionamiento posterior a la clonación (a través de 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: Elimine el agente de Level antes de crear la imagen maestra y, luego, instale Level como paso posterior a la 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 de MDM posteriores a la clonación.
Preguntas frecuentes
¿En qué dispositivo debo ejecutar --new-agent-id: en el original o en el clon? Ejecútelo 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. Deberá 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 confiable cuando dos dispositivos compiten por el mismo ID. El acceso local o el uso de otra herramienta remota es más seguro. Una vez que haya 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 genera un UUID v4 válido.