Problemas conocidos de Operaciones de IoT de Azure

En este artículo se enumeran los problemas conocidos actuales que podría surgir al usar Operaciones de IoT de Azure. La guía le ayuda a identificar estos problemas y proporciona soluciones alternativas cuando están disponibles.

Para obtener instrucciones generales de solución de problemas, consulte Troubleshoot Operaciones de IoT de Azure.

Problemas del agente MQTT

En esta sección se enumeran los problemas conocidos actuales del agente MQTT.

Los recursos del agente MQTT no están visibles en el portal de Azure


Identificador de problema: 4257


Firma de registro: N/D


Los recursos del agente MQTT creados en el clúster mediante Kubernetes no están visibles en el portal de Azure. Este resultado se espera porque administrar componentes de Operaciones de IoT de Azure mediante Kubernetes es solo para depuración y pruebas, y actualmente no se admite la sincronización de recursos desde el borde hacia la nube.

Actualmente, no hay ninguna solución alternativa para este problema.

Problemas generales del conector

En esta sección se enumeran los problemas conocidos actuales que afectan a todos los conectores.

Los nombres de endpoint entrantes en mayúsculas impiden la sincronización de salud del dispositivo


ID del problema: 0202


Aplica a: Operaciones de IoT de Azure 2610 vista pública previa, reportada en v1.6.0-preview.57 con el conector para ONVIF.


Solución prevista para la versión 2612.


Firma de registro: En el Registro de Actividad del portal de Azure, Microsoft.DeviceRegistry/namespaces/devices/write falla con InvalidRequestContent:

The request body contains a duplicate JSON key '<endpoint name in lowercase>'. Each property name may appear at most once.

Puedes crear un dispositivo con un nombre de endpoint entrante que contenga letras mayúsculas, pero las escrituras de estado posteriores fallan. El estado de configuración utiliza un nombre del endpoint en minúsculas, mientras que el estado en tiempo de ejecución conserva las mayúsculas y minúsculas originales. Azure rechaza las claves duplicadas resultantes.

La experiencia operativa puede indicar que el dispositivo fue creado y sincronizado mientras su estado sigue siendo desconocido. El estado real y los errores de conectividad del endpoint no son visibles en Azure.

Solución alternativa: Utiliza letras minúsculas, dígitos y guiones en los nombres de los endpoints entrantes. Para un dispositivo afectado existente, guarda su configuración, identifica activos y cargas de trabajo dependientes, y planifica la interrupción antes de eliminar y recrear el dispositivo con un nombre de endpoint en minúscula. Verifica que las escrituras de estado funcionen y que la salud se reporte después de la recreación.

El conector no detecta actualizaciones de las credenciales del dispositivo en Azure Key Vault


Identificador de problema: 6514


N/A


Corregido en la versión 2605 y posteriores


El conector no recibe una notificación cuando se actualizan las credenciales del dispositivo almacenadas en Azure Key Vault. Como resultado, el conector sigue usando las credenciales antiguas hasta que se reinicie.

Solución alternativa: reinicie el conector para obligarlo a recuperar las credenciales actualizadas de Azure Key Vault.

Problemas de conector para OPC UA

En esta sección se enumeran los problemas conocidos actuales del conector para OPC UA.

No se pueden usar caracteres especiales en nombres de eventos


Identificador de problema: 1532


Se corrigió en la versión 1.3.36 (2603) y versiones posteriores.


Firma de registro: 2025-10-22T14:51:59.338Z aio-opc-opc.tcp-1-68ff6d4c59-nj2s4 - Updated schema information for Boiler#1Notifier skipped!


Se produce un error en la generación de esquemas si los nombres de evento contienen caracteres especiales como #, %o &. Evite usar estos caracteres en nombres de eventos para evitar problemas de generación de esquemas.

No se ha encontrado la plantilla del conector OPC


ID del problema: 1330


Corregido en la versión 1.4.73 (2608) y posteriores


Firma de registro: N/D


La implementación de una instancia de Operaciones de IoT de Azure debería instalar un OPC ConnectorTemplate de forma predeterminada. Tras el despliegue, la plantilla del conector falta en el portal de Azure y el ConnectorTemplate recurso no está presente en el clúster.

Problemas de conector para medios y conectores para ONVIF

En esta sección se enumeran los problemas conocidos actuales del conector para medios y el conector para ONVIF.

ContinuousMove indica que la operación se ha realizado correctamente sin mover una cámara


ID del problema: 0205


Aplica a: La experiencia de operaciones de preproducción utilizada con la vista previa pública de Operaciones de IoT de Azure. El impacto en la experiencia de operaciones de producción no ha sido confirmado.


Solución prevista para la versión 2612.


Firma de log: La PTZ>ContinuousMove acción devuelve Succeeded con un resultado vacío:

{"Result": {}}

El formulario de ejecución requiere Zoom>X aunque Velocity.Zoom sea opcional en el esquema de petición de la acción. En una cámara pan-tilt afectada sin zoom óptico, enviar el formulario indica éxito, pero la cámara no se mueve.

Solución alternativa: Invoca la acción del PTZ>ContinuousMove activo a través de Azure Resource Manager executeAction con una carga útil que incluya PanTilt pero omita Zoom. Por ejemplo, utiliza el siguiente cuerpo de la solicitud, reemplazando <media-profile-token> por un token devuelto por la acción Media>GetProfiles de la cámara:

{
  "managementGroupName": "PTZ",
  "managementActionName": "ContinuousMove",
  "payload": {
    "ContinuousMove": {
      "ProfileToken": "<media-profile-token>",
      "Velocity": {
        "PanTilt": {
          "x": 0.3,
          "y": 0
        }
      },
      "Timeout": "PT1S"
    }
  }
}

Envía payload como objeto JSON, no como cadena codificada en JSON. Usa valores de movimiento soportados por tu cámara y verifica el resultado con PTZ>GetStatus; un resultado exitoso vacío por sí solo no confirma el movimiento.

El descubrimiento de medios supera el límite de endpoint de dispositivos descubiertos


Id. del problema: 5382


Aplica a: Operaciones de IoT de Azure 2610 public preview, reportado en v1.6.0-preview.57 con conector para ONVIF v1.6.5.


Solución prevista para la versión 2612.


Firma de registro: En el Registro de Actividad del portal de Azure, Microsoft.DeviceRegistry/namespaces/discoveredDevices/write falla con InvalidRequestContent, con MaxProperties la dirección properties.endpoints.inbound:

The object must not contain more than 10 properties.

El conector para ONVIF genera puntos finales multimedia para múltiples transportes por perfil de medios. Azure Device Registry rechaza dispositivos descubiertos que superen los 10 endpoints entrantes. Una cámara con tres perfiles multimedia puede superar este límite.

El endpoint ONVIF de la cámara puede informar de Disponible y su activo ONVIF descubierto puede aparecer, pero el dispositivo descubierto que contiene sus endpoints multimedia no aparece en Azure. No puedes importar esos endpoints para configurar el conector multimedia a través de Discovery.

Solución alternativa: Crea un dispositivo manualmente con un Microsoft.Media punto final entrante usando la URL del flujo RTSP de la cámara de la documentación del fabricante, como rtsp://<camera-ip>:554/<stream-path>. Configura las credenciales a través de las referencias a secretos admitidas, luego crea el recurso multimedia y los flujos de instantáneas o clips que necesites. Consulta la configuración del conector para medios.

Conflicto de sincronización de secretos


Identificador de problema: 0606


Firma de registro: N/D


Al usar la sincronización de secretos, asegúrese de que los nombres de secreto sean únicos globalmente. Si existe un secreto local con el mismo nombre, es posible que los conectores no recuperen el secreto previsto.

Conector para problemas de MQTT

Error de coincidencia de la versión de la plantilla del conector MQTT durante la actualización


Identificador de problema: 1533


Firma de registro: N/D


Corregido en la versión 2606 y posteriores


Al actualizar a la versión 2605, las plantillas de conector MQTT existentes pueden mostrar versiones de metadatos no coincidente en el portal. Para resolverlo, elimine y vuelva a crear la plantilla del conector. Como alternativa, use el CLI de Azure para actualizar el conector.

El conector MQTT no se puede conectar a agentes MQTT externos que tienen direcciones IP privadas


Identificador de problema: 7791


Firma de registro: N/D


Corregido en la versión 2607 y posteriores


A partir de la versión 2605, el conector MQTT no puede conectarse a brokers MQTT externos que usan direcciones IP privadas.

Problemas de flujos de datos

En esta sección se enumeran los problemas conocidos actuales de los flujos de datos.

La actualización falla por una discrepancia de audiencia en el endpoint del registro ACR


ID del problema: 3245


Firma de registro: N/D


Una actualización de Operaciones de IoT de Azure puede fallar y revertirse si un grafo de flujo de datos utiliza un punto final de registro de Azure Container Registry (ACR) con una audiencia o alcance de Azure Resource Manager (ARM) configurado explícitamente. Ejemplos de documentación anteriores usaban la audiencia ARM, por lo que una configuración existente que funcionaba antes de la actualización puede verse afectada.

El operador Dataflows registra un error de desajuste de audiencia similar a:

audience 'https://management.azure.com/' does not match the expected audience 'https://containerregistry.azure.net'

Solución alternativa: Actualizar el recurso de Azure del endpoint del registro existente a través de Azure Resource Manager antes de volver a intentar la actualización:

  • Para la autenticación de identidad gestionada asignada por el sistema, cambia properties.authentication.systemAssignedManagedIdentitySettings.audience de https://management.azure.com/ a https://containerregistry.azure.net.
  • Para la autenticación de identidad gestionada asignada por el usuario, cambia properties.authentication.userAssignedManagedIdentitySettings.scope de https://management.azure.com/.default a https://containerregistry.azure.net/.default.

Conserva las propiedades del otro punto final del registro y la configuración de autenticación. Actualiza el recurso existente en lugar de solo cambiar un archivo de despliegue local o omitir un argumento de un comando de actualización. Después de que el recurso de Azure y su configuración correspondiente de clúster reflejen el nuevo valor, vuelve a intentar la actualización.

Para ejemplos de configuración de puntos finales de registro, véase Configurar extremos de registro.

La interfaz de usuario web de la experiencia de operaciones solo muestra artefactos del gráfico de flujo de datos procedentes de Azure Container Registry (ACR) y mcr.microsoft.com.


ID de incidencia: 8895


Firma de registro: N/D


Incluso si configuras un punto final de registro de contenedores para un registro de contenedores que no sea ACR, como GHCR:

  • Los artefactos del gráfico de flujo de datos procedentes de un registro distinto de ACR no aparecen en la interfaz de usuario web de la experiencia de operaciones, por lo que no es posible crear un gráfico de flujo de datos que los utilice.

  • Seleccionar un grafo de flujo de datos de la lista de flujos de datos en la interfaz web de experiencia de operaciones que contiene elementos de un registro no ACR produce un error similar a: Can't load data flow graph. The contents of this data flow graph are unavailable. Please ensure that it still exists, then work with your administrator to get 'AcrPull' access to required registry endpoints.

Solución alternativa: Tienes dos opciones:

  • Si no necesitas usar la interfaz de usuario de la experiencia de operaciones, usa la CLI de Azure para realizar operaciones CRUD en grafos de flujo de datos definidos en archivos JSON o Bicep que contengan artefactos procedentes de registros que no sean ACR.

  • Si quieres usar la interfaz web de experiencia operativa, importa artefactos y gráficos de flujo de datos de registros no ACR a un registro ACR. Para saber más, consulta Enviar módulos a tu registro.

Los recursos de flujo de datos creados con Kubernetes no son visibles en la interfaz web de la experiencia operativa


Identificador de problema: 8724


Firma de registro: N/D


Los recursos personalizados de flujo de datos creados en el clúster mediante Kubernetes no son visibles en la interfaz de usuario web de la experiencia de operaciones. Este resultado se espera porque administrar componentes de Operaciones de IoT de Azure mediante Kubernetes es solo para depuración y pruebas, y actualmente no se admite la sincronización de recursos desde el borde hacia la nube.

Actualmente, no hay ninguna solución alternativa para este problema.

No se puede usar la misma definición de grafo varias veces en un escenario de grafo encadenado


Identificador de problema: 1352


Se corrigió en la versión 1.3.36 (2603) y versiones posteriores.


No se pudo enviar la configuración


Para crear un escenario de grafo encadenado, use la salida de un gráfico de flujo de datos como entrada en otro gráfico de flujo de datos. Sin embargo, si intenta usar la misma definición de grafo varias veces en este escenario, actualmente no funciona según lo previsto. Por ejemplo, se produce un error en el código siguiente al usar la misma definición de grafo (graph-passthrough:1.3.6) para tanto graph-1 como graph-2.

      {
          nodeType: 'Graph'
          name: 'graph-1'
          graphSettings: {
            registryEndpointRef: dataflowRegistryEndpoint.name
            artifact: 'graph-passthrough:1.3.6'
            configuration: []
            }
      }
      {
          nodeType: 'Graph'
          name: 'graph-2'
          graphSettings: {
            registryEndpointRef: dataflowRegistryEndpoint.name
            artifact: 'graph-passthrough:1.3.6'
            configuration: graphConfiguration
            }
      }
  nodeConnections: [
      {
          from: {name: 'source'}
          to: {name: 'graph-1'}
      }
      {
          from: {name: 'graph-1'}
          to: {name: 'graph-2'}
      }
      {
          from: {name: 'graph-2'}
          to: {name: 'destination'}
      }
  ]

Para resolver este error, inserte la definición del gráfico en el ACR tantas veces como sea necesario, utilizando un escenario con un nombre o una etiqueta diferentes cada vez. Por ejemplo, en el escenario descrito, la definición del grafo debe insertarse dos veces con un nombre diferente o una etiqueta diferente, como graph-passthrough-one:1.3.6 y graph-passthrough-two:1.3.6.

Problemas con Edge registry

Esta sección enumera los problemas conocidos actuales del registro perimetral.

La configuración de identidad asignada por el usuario utiliza la cuenta de servicio del registro incorrecta


ID del problema: 3467


Aplica a: Operaciones de IoT de Azure 2610 preview. Reportado en v1.6.0-preview.57; la discrepancia de CLI también existe en la extensión CLI v2.11.2, cuyo perfil de despliegue de vista previa utiliza v1.6.0-preview.60.


Solución prevista para la versión 2612.


Firma de registro: N/D


Cuando ejecutas az iot ops identity assign --usage schema en una instancia de vista previa afectada, la CLI crea una credencial federada con el sujeto system:serviceaccount:azure-iot-operations:adr-schema-registry. El registro de previsualización en el borde se ejecuta como cuenta aio-edge-registryde servicio, así que la credencial no coincide con la carga de trabajo.

El comando puede informar de éxito aunque la cuenta de servicio del registro de borde no tenga credenciales federadas coincidentes. El registro puede seguir usando su identidad asignada por el sistema existente, enmascarando la incompatibilidad de configuración.

Solución alternativa:

  1. En la identidad gestionada asignada por el usuario destinada al registro de borde, añade una credencial federada con estos valores:
    • Emisor: La URL del emisor OIDC del clúster conectado.
    • Asunto:system:serviceaccount:azure-iot-operations:aio-edge-registry para el espacio de nombres por defecto. Si usas otro espacio de nombres, sustituye el espacio de nombres específico.
    • Audiencia:api://AzureADTokenExchange.
  2. Verifica que la credencial coincida con la cuenta de servicio utilizada por el pod del registro edge. Si necesitas reiniciar el registro de vista previa, su StatefulSet es aio-edge-registry, no adr-schema-registry.

Añadir esta credencial corrige la descoordinación de la confianza, pero la adopción de un cambio de identidad por parte del registro en funcionamiento está bajo investigación por separado. Añadir la credencial no confirma que el registry haya cambiado de identidad. También se está investigando la selección entre múltiples identidades asignadas por el usuario.

Problemas de las acciones de administración

Esta sección enumera los problemas actuales conocidos para las acciones de administración.

La suscripción a Event Grid no está lista inmediatamente después de activarse las acciones de gestión


ID del problema: 0208


Aplica a: extensión CLI v2.11.0 en Operaciones de IoT de Azure 2610 vista pública previa, reportada en v1.6.0-preview.57.


Solución prevista para la versión 2612.


Firma de registro: El pod de flujo de datos registra fallos de suscripción y la métrica Mqtt.FailedSubscriptionOperations del espacio de nombres Event Grid informa Error=AuthorizationError.


El az iot ops mgmt-actions enable comando crea el grafo de flujo de datos de solicitud antes de asignar los roles de Publisher y Subscriber de TopicSpaces en Event Grid. El grafo puede intentar suscribirse antes de ser autorizado. Se vuelve a intentar con retroceso, y los fallos de autorización pueden continuar brevemente después de que la CLI informe éxito.

Las acciones de gestión pueden no alcanzar el borde hasta que la suscripción al request graph tenga éxito.

Solución alternativa: Espera aproximadamente un minuto después de que az iot ops mgmt-actions enable devuelva antes de enviar la primera acción. Consulta los registros del grafo de solicitudes para confirmar que su suscripción se realiza correctamente. Si continúan los fallos de autorización, verifica las asignaciones de roles requeridas y permite tiempo adicional para la propagación de roles. No reproduzcas automáticamente acciones no idempotentes cuyo resultado de ejecución es desconocido.

Cuestiones de identidad federada

Esta sección enumera los problemas conocidos actuales para la identidad federada.

La descoordinación entre emisores de credenciales de identidad federadas puede causar fallos en la autenticación de sincronización secreta


ID de la edición: 1190


Corregido en la versión 2607 y posteriores


Firma de registro: similar a AADSTS700211: No matching federated identity record found for presented assertion issuer 'https://northamerica.oic.prod-arc.azure.com/1f5f7baf-633d-4eb5-9be1-8cf1e9c6fcc9/f512e8f6-0c47-48a1-91f3-aeb5422dd766'. Please check your federated identity credential Subject, Audience and Issuer against the presented assertion.


Operaciones de IoT de Azure encuentra errores 401 de tipo «No autorizado» al recuperar secretos de Azure Key Vault.

Causa raíz: El error ocurre porque la URL del emisor de credenciales de identidad federada no coincide con la reclamación del emisor (iss) en el token de cuenta de servicio Kubernetes.

Cuando el az iot ops secretsync enable comando crea una credencial de identidad federada (FIC) en la identidad gestionada asignada por el usuario que Operaciones de IoT de Azure utiliza para acceder a Azure Key Vault, establece la URL del emisor FIC a la URL del emisor OIDC del clúster. En algunas implementaciones, esta URL incluye una barra diagonal final ('/') que se omite en el campo `iss` (emisor) del token de cuenta de servicio emitido por el clúster.

Debido a que el problema afecta al intercambio de tokens durante la recuperación secreta, el fallo normalmente no ocurre cuando ejecutas az iot ops secretsync enable. En cambio, aparece más adelante cuando Operaciones de IoT de Azure intenta acceder a un secreto, lo que puede dificultar la identificación de la causa raíz.

Solución alternativa: Verifica que la URL del emisor configurada en la credencial de identidad federada no termine con una barra. Si es así, actualiza la credencial de identidad federada para quitar la barra diagonal final.

Puedes usar los comandos de la CLI de Azure az identity federated-credential para consultar y, si es necesario, actualizar el valor del emisor de la credencial de identidad federada, por ejemplo:

az identity federated-credential show --name <fic-name> --identity-name <managed-identity-name> --resource-group <resource-group-name>

az identity federated-credential update --name <fic-name> --identity-name <managed-identity-name> --resource-group <resource-group> --issuer <new-issuer-url-without-trailing-slash>

Como mejor práctica, realiza esta validación durante la configuración después de ejecutar el az iot ops secretsync enable comando para ayudar a evitar posibles fallos de autenticación difíciles de diagnosticar más adelante.

Problemas con el Protocolo de Contexto del Modelo (MCP)

Esta sección enumera los problemas conocidos actuales para MCP.

El despliegue con certificados gestionados por el cliente falla cuando MCP está habilitado


ID del problema: 3314


Aplica a: Operaciones de IoT de Azure 2610 preview.


Solución prevista para la versión 2612.


Firma de registro: N/D


Cuando traes tu propio emisor de certificados, el despliegue de Operaciones de IoT de Azure falla si MCP está habilitado. Los componentes MCP hacen referencia al emisor de certificados por defecto y al paquete de confianza en lugar de tus recursos configurados.

Solución alternativa: Para evaluar otras funciones de Operaciones de IoT de Azure con certificados gestionados por el cliente, establece features.mcp.mode explícitamente en Disabled en tu configuración de despliegue antes de desplegar. MCP está activado por defecto. Consulta Desactivar MCP para ver la opción de configuración.