Compartir a través de

Descripción de los límites y restricciones de Azure IoT Edge

Se aplica a:Marca de verificación de IoT Edge 1.5 IoT Edge 1.5

Importante

IoT Edge 1.5 LTS es la versión compatible. IoT Edge 1.4 LTS finaliza su ciclo de vida el 12 de noviembre de 2024. Si está usando una versión anterior, consulte Actualización de IoT Edge.

En este artículo se explican los límites y restricciones del uso de IoT Edge.

Límites

Número de elementos secundarios en la jerarquía de puertas de enlace

Cada dispositivo primario IoT Edge en jerarquías de puerta de enlace puede tener hasta 100 dispositivos secundarios conectados de forma predeterminada.

Sin embargo, es importante saber que cada dispositivo IoT Edge de una topología anidada debe abrir una conexión lógica independiente al centro de EdgeHub primario (o IoT Hub) en nombre de cada cliente conectado (dispositivo o módulo), más una conexión para sí mismo. Por lo tanto, las conexiones de cada capa no se agregan, sino que se suman.

Por ejemplo, si hay 2 dispositivos secundarios IoT Edge en una capa L4 y cada uno tiene 100 clientes, el dispositivo primario IoT Edge en la capa superior L5 tendría un total de 202 conexiones entrantes desde L4.

Para cambiar este límite, establezca la variable de entorno MaxConnectedClients en el módulo edgeHub del dispositivo primario. Pero IoT Edge puede encontrarse con problemas con la notificación de su estado en las propiedades notificadas del gemelo si el número de clientes supera unos cientos debido al límite de tamaño del gemelo de IoT Hub. En general, tenga cuidado al aumentar el límite mediante el cambio de esta variable de entorno.

Para obtener más información, consulte Creación de una jerarquía de puertas de enlace.

Tamaño de las propiedades deseadas

IoT Hub aplica las restricciones siguientes:

  • Un límite de tamaño de 8 KB en el valor de las etiquetas.
  • Un límite de tamaño de 32 KB en el valor de properties/desired y properties/reported.

Para obtener más información, consulte Tamaño del módulo gemelo.

Número de capas de jerarquía anidada

Un dispositivo IoT Edge tiene un límite de cinco capas de dispositivos IoT Edge vinculados como dispositivos secundarios.

Para obtener más información, consulte Relaciones primarias y secundarias.

Número de módulos en una implementación

IoT Hub tiene las siguientes restricciones para las implementaciones automáticas de IoT Edge:

Restricciones

Certificados

Los certificados de IoT Edge tienen las restricciones siguientes:

  • El nombre común (CN) no puede ser el mismo que el nombre de host que se usa en el archivo de configuración en el dispositivo IoT Edge.
  • El nombre que usan los clientes para conectarse a IoT Edge no puede ser el mismo que el nombre común que se usa en el certificado de entidad de certificación de Edge.

Para obtener más información, consulte Certificados para la seguridad del dispositivo.

Atestación de TPM

Al usar la atestación de TPM con el servicio de aprovisionamiento de dispositivos, debe usar TPM 2.0.

Para obtener más información, consulte los requisitos de los dispositivos para la atestación de TPM.

Sintaxis de enrutamiento

La sintaxis del enrutamiento de IoT Edge y IoT Hub es casi idéntica. Sintaxis de consulta admitida:

Sintaxis de consulta no admitida:

Directivas de reinicio

No use on-unhealthy ni on-failure como valores en la restartPolicy de los módulos porque no se implementan y no inician un reinicio. Solo se implementan las directivas de reinicio never y always.

En esta solución alternativa se indica la manera recomendada de reiniciar automáticamente los módulos de IoT Edge incorrectos. Configure la propiedad Healthcheck en las createOptions del módulo para controlar una comprobación de estado con errores.

Registros de la solución de problemas

El acceso a los registros de módulos desde Azure Portal podría retrasarse mientras se actualizan los módulos.

Si ve la pestaña Solucionar problemas del dispositivo en IoT Edge en el Azure Portal, es posible que vea el mensaje "No se pueden recuperar registros. Error en la solicitud con el código de estado 504". La solicitud agota el tiempo de espera y el estado en tiempo de ejecución podría aparecer como "Error" para todos los módulos.

Esta capacidad de ver los registros se reanudará a tiempo. La razón por la que se retrasa el acceso es que edgeAgent puede estar ocupado iniciando módulos para que no pueda recuperar registros simultáneamente. Los registros se extraen de Moby/Docker, por lo que este proceso tarda tiempo y la solicitud puede agotar el tiempo de espera si edgeAgent está ocupado.

Carga de archivos

IoT Hub solo admite las API de carga de archivos para identidades de dispositivo, no para identidades de módulo. Como IoT Edge usa exclusivamente módulos, la carga de archivos no se admite de forma nativa en IoT Edge.

Para obtener más información sobre la carga de archivos con IoT Hub, consulte Carga de archivos con IoT Hub.

Variables de entorno del agente de Edge

Los cambios realizados en config.toml a las variables de entorno de edgeAgent, como hostname, no se aplican a edgeAgent si el contenedor ya existía. Para aplicar estos cambios, quite el contenedor edgeAgent mediante el comando sudo docker rm -f edgeAgent. El demonio de IoT Edge vuelve a crear el contenedor e inicia edgeAgent en aproximadamente un minuto.

Autenticación NTLM

No se admite la autenticación NTLM. Los servidores proxy configurados con la autenticación NTLM no funcionarán.

IoT Edge tiene compatibilidad limitada con la autenticación de proxy. Solo se admiten los servidores proxy configurados para la autenticación de nombre de usuario y contraseña.

Pasos siguientes

Para obtener más información, consulte los demás límites de IoT Hub.