Cuando clona un dispositivo que ya tiene el agente Level instalado, tanto el original como el clon comparten la misma ID de agente. Eso causa un conflicto — los dos dispositivos compiten por la misma entrada en Level, y uno o ambos mostrarán conectividad errática. Este artículo muestra cómo rotar la ID de agente en el dispositivo clonado para resolverlo.
ℹ️ NOTA: Esto solo afecta a dispositivos clonados. Reinstalar el agente en un dispositivo existente no cambia su ID — Level preserva la ID original a través de reinstalaciones para evitar entradas duplicadas.
Rotar la ID de Agente Automáticamente
La solución más rápida es el flag --new-agent-id. Genera un nuevo UUID, actualiza la configuración y reinicia el agente en un solo paso.
Ejecute esto en el dispositivo clonado:
🖥️ 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 ve afectado.
Rotar la ID de Agente Manualmente
Si no puede ejecutar la binaria del agente directamente (por ejemplo, el agente está detenido o la binaria es inaccesible), puede editar la ID directamente en la configuración.
⚠️ ADVERTENCIA: Establezca el valor en un UUID v4 válido (generado aleatoriamente). No reutilice una ID de otro dispositivo y no deje el campo en blanco. Después de editar, reinicie el servicio 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 Level:
🖥️ NOTA DE PLATAFORMA:
Windows:
Restart-Service -Name LevelmacOS:
sudo launchctl kickstart -k system/LevelLinux:
systemctl restart Level
Evitar Esto en el Futuro
Dos opciones para flujos de trabajo de aprovisionamiento basados en clones:
Opción 1 — Rotar el UUID después del clon (recomendado): Mantenga el agente en su imagen maestra y ejecute --new-agent-id como parte de su paso de aprovisionamiento después del clon (a través de MDM, script de inicio o RMM). Cada dispositivo clonado obtiene una ID nueva automáticamente en el primer inicio sin ninguna intervención manual.
Opción 2 — Desinstalar antes de crear la imagen: Elimine el agente Level antes de crear la imagen maestra, luego instale Level como un paso después del clon. Cada dispositivo obtiene una ID de agente nueva de 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 clones posteriores a MDM.
Preguntas Frecuentes
¿En qué dispositivo debo ejecutar --new-agent-id — en el original o en el clon? Ejecutelo en el clon. El dispositivo original tiene la ID "correcta" que ya está registrada en Level. Rotar la ID del clon lo registra como un nuevo dispositivo sin perturbar el original.
Después de rotar la 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 apropiados. Los valores de campos personalizados del original no se transferirán.
¿Puedo enviar --new-agent-id a través de Level si ambos dispositivos se muestran de forma intermitente? No es confiable cuando dos dispositivos compiten por la misma ID. El acceso local u otra herramienta remota es más seguro. Una vez que haya rotado la ID en el clon, ambos dispositivos tendrán conexiones estables y separadas.
¿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. Ambos generan un UUID v4 válido.