Introducción
Cuando clonas un dispositivo que ya tiene instalado el agente de Level, 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 explica 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.
ℹ️ NOTA: El borrado y la reinscripción con Autopilot es un caso diferente. Los dispositivos Autopilot unidos a Entra con agentes actuales se mapean de vuelta a la misma fila de Level usando el ID de dispositivo unido a Entra a nivel de máquina. No rotes el ID de agente para «corregir» una reinscripción de Autopilot. Consulta Instalar mediante Intune en Windows.
Rotar el ID de agente automáticamente
La solución más rápida es el --new-agent-id indicador. Genera un nuevo UUID, actualiza la configuración y reinicia el agente en un solo paso.
Ejecuta esto en el dispositivo 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 ni 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 tras la clonación (recomendado): Mantén el agente en tu imagen maestra y ejecuta --new-agent-id como parte de tu paso de aprovisionamiento posterior a la 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 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 aptos para scripts de implementación y flujos de trabajo de 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. Deberás 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 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 usarlo en una rotación de ID manual? En Windows:
[guid]::NewGuid().ToString()en PowerShell. En macOS/Linux:uuidgen. Cualquiera de los dos genera un UUID v4 válido.Mi dispositivo Autopilot creó una segunda fila después de un borrado. ¿Debo rotar el ID de agente? No. Este artículo es para dispositivos clonados que comparten un mismo ID de agente. El borrado y la reinscripción con Autopilot utiliza una identidad diferente. Consulta Instalar mediante Intune en Windows.