Ir al contenido principal

Resolver conflictos de endpoints en Level

Fix agent identity conflicts caused by device cloning. Check automatic recovery or rotate the ID on Windows, macOS, and Linux when needed.

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 provoca un conflicto: los dos dispositivos compiten por la misma entrada en Level, y uno o ambos mostrarán problemas de conectividad erráticos. Este artículo explica la recuperación automática de identidad y cómo rotar el ID del agente en el dispositivo clonado si el conflicto persiste.

ℹ️ 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 mediante Autopilot son un caso diferente. Los dispositivos Autopilot unidos a Entra con agentes actuales se asignan de nuevo a la misma fila de Level usando el ID de dispositivo unido a Entra a nivel de máquina. No rote el ID del agente para «corregir» una reinscripción de Autopilot. Consulte Instalar mediante Intune en Windows.


Recuperación automática de identidad

En los agentes que admiten recuperación automática de identidad, Level puede solicitar al agente que informa que cambie su ID cuando detecta cambios repetidos tanto en el nombre de host como en el número de serie bajo la misma identidad de agente. El informe que desencadena el restablecimiento debe incluir un número de serie diferente al almacenado actualmente. Un cambio de nombre de host por sí solo no es suficiente.

El agente reemplaza su ID almacenado por un UUID aleatorio. Cuando se registra correctamente usando su clave de instalación existente, aparece como una entrada de dispositivo separada en el espacio de trabajo asociado a esa clave. Esta recuperación no fusiona ni elimina el registro existente.

Si la clave de instalación especifica un grupo, la nueva entrada se asigna a ese grupo. No copia la asignación de grupo actual del registro existente.

La recuperación automática no está garantizada para todos los clones. Es posible que los clones que reportan el mismo nombre de host o número de serie no cumplan los criterios de detección. La recuperación también depende de que el agente reciba la solicitud de restablecimiento y registre correctamente su nueva identidad.

Comprobar si el conflicto se ha resuelto

  1. Identifique el dispositivo original y el clon usando sus nombres de host y detalles de hardware. Abra la Sistema pestaña y verifique la Número de serie en la Sistema sección comparada con la máquina esperada. Consulte Sistema del dispositivo.

  2. Confirme que cada máquina tiene su propia entrada. Revise los informes posteriores para asegurarse de que el nombre de host y el número de serie ya no alternan entre máquinas en una sola entrada. Una nueva entrada por sí sola no prueba que ambos dispositivos se estén comunicando correctamente.

  3. Revise el grupo, las etiquetas y los valores de campos personalizados de la nueva entrada, y aplique la configuración que necesite.

Si las máquinas siguen compartiendo una entrada o sus detalles continúan cambiando, use los procedimientos de rotación de ID que se indican a continuación en el clon confirmado, o contacte con el soporte de Level. Si un dispositivo permanece sin conexión, siga también Solución de problemas del agente en lugar de asumir que el conflicto de identidad es la única causa.

No elimine una entrada solo porque haya aparecido una segunda entrada. Primero confirme qué máquina representa cada registro.

Rotar el ID del agente con un comando

Para un conflicto de clon confirmado que no se ha resuelto, el indicador --new-agent-id regenera la configuración de identidad del agente e intenta reiniciar el servicio del agente.

Ejecute esto en el dispositivo clonado dispositivo:

🖥️ NOTA DE PLATAFORMA:

  • Windows: & 'C:\Program Files\Level\level.exe' --new-agent-id

  • macOS: sudo /usr/local/bin/level --new-agent-id

  • Linux: sudo /usr/local/bin/level --new-agent-id

Cuando el dispositivo clonado se registra con un nuevo ID de agente, aparece como una entrada separada en Level. Use las comprobaciones de recuperación anteriores para verificar el resultado.

En dispositivos Windows unidos a Entra, este comando puede reutilizar el ID de dispositivo Entra a nivel de máquina. Si las entradas siguen en conflicto, use el procedimiento manual que se indica a continuación o contacte con el soporte de Level.

Rotar el ID del agente manualmente

Si no puede ejecutar el binario del agente directamente (por ejemplo, el agente está detenido o el binario es inaccesible), puede editar el ID directamente en la configuración.

⚠️ ADVERTENCIA: Establezca el valor en un UUID v4 válido (generado aleatoriamente). No reutilice un ID de otro dispositivo y no deje el campo en blanco. Después de editar, reinicie el servicio de Level para que el cambio surta efecto.

🖥️ NOTA DE PLATAFORMA:

  • Windows, Clave de registro:

    • Ruta: HKEY_LOCAL_MACHINE\SOFTWARE\Level

    • Nombre de clave: AgentID

    • Cambie el valor a un nuevo UUID.

  • macOS, Archivo de configuración:

    • Ruta: /Library/Application Support/Level/config.yaml

    • Nombre de clave: agent-id

    • Reemplace el valor existente por un nuevo UUID.

  • Linux, Archivo de configuración:

    • Ruta: /etc/level/config.yaml

    • Nombre de clave: agent-id

    • Reemplace el valor existente por un nuevo UUID.

Después de editar, reinicie el servicio de Level:

🖥️ NOTA DE PLATAFORMA:

  • Windows: Restart-Service -Name Level

  • macOS: sudo launchctl kickstart -k system/Level

  • Linux: systemctl restart Level

Cómo 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 clonado (recomendado): Mantenga el agente en su imagen maestra y ejecute --new-agent-id como parte de su paso de aprovisionamiento posterior al clonado (mediante MDM, script de inicio o RMM). Incluya las comprobaciones de recuperación anteriores en su proceso de aprovisionamiento para verificar que cada clon se registre por separado.

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 al clonado. 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 posteriores al clonado.


Preguntas frecuentes

  • ¿En qué dispositivo debo ejecutar --new-agent-id, en el original o en el clon? Ejecútelo en el clon, después de confirmar cuál es la máquina clonada. No rote el ID del dispositivo original como medida general de limpieza.

  • Después de rotar el ID, ¿el dispositivo clonado heredará los grupos, etiquetas y campos personalizados del original? Se registra como un dispositivo nuevo en lugar de copiar el registro original. Si su clave de instalación especifica un grupo, Level lo asigna a ese grupo. Revise el grupo, las etiquetas y los valores de campos personalizados del nuevo registro después del registro.

  • ¿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. Después de la rotación, use las comprobaciones de recuperación anteriores para verificar registros y conexiones separados.

  • ¿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 produce un UUID v4 válido.

  • Mi dispositivo Autopilot creó una segunda fila después de un borrado. ¿Debo rotar el ID del agente? No. Este artículo es para dispositivos clonados que comparten un mismo ID de agente. El borrado y la reinscripción mediante Autopilot utiliza una identidad diferente. Consulte Instalar mediante Intune en Windows.

¿Ha quedado contestada tu pregunta?