Problèmes connus pour Opérations Azure IoT

Cet article répertorie les problèmes connus actuels que vous pouvez rencontrer lors de l’utilisation de Opérations Azure IoT. Les conseils vous aident à identifier ces problèmes et à fournir des solutions de contournement le cas échéant.

Pour obtenir des conseils généraux sur la résolution des problèmes, consultez Troubleshoot Opérations Azure IoT.

Problèmes liés au répartiteur MQTT

Cette section répertorie les problèmes connus actuels pour le répartiteur MQTT.

Les ressources du répartiteur MQTT ne sont pas visibles dans le portail Azure


ID du problème : 4257


Signature du journal : N/A


Les ressources broker MQTT créées dans votre cluster à l'aide de Kubernetes ne sont pas visibles dans le portail Azure. Ce résultat est attendu, car la gestion des composants Opérations Azure IoT à l'aide de Kubernetes est uniquement destinée au débogage et au test, et la synchronisation des ressources de la périphérie vers le cloud n'est pas prise en charge actuellement.

Il n’existe actuellement aucun moyen de contourner ce problème.

Problèmes généraux liés au connecteur

Cette section répertorie les problèmes connus actuels qui affectent tous les connecteurs.

Les noms de points de terminaison entrants en majuscules empêchent la synchronisation de la santé des appareils


ID du problème : 0202


S’applique à : aperçu public d’Opérations Azure IoT 2610, signalé sur la version v1.6.0-preview.57 avec le connecteur pour ONVIF.


Correction prévue pour la sortie 2612.


Signature de journal : Dans le journal d’activité du portail Azure, Microsoft.DeviceRegistry/namespaces/devices/write échoue avec InvalidRequestContent:

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

Vous pouvez créer un appareil avec un nom de terminaison entrant contenant des majuscules, mais les écritures d’état ultérieures échouent. L’état de configuration utilise un nom de terminaison en minuscules tandis que l’état d’exécution préserve la casse d’origine. Azure rejette les clés dupliquées résultantes.

L’expérience opérationnelle peut indiquer que l’appareil a été créé et synchronisé alors que son état de santé reste inconnu. Les véritables erreurs de santé et de connectivité du endpoint ne sont pas visibles dans Azure.

Solution de contournement : Utilisez des lettres minuscules, des chiffres et des traits d’union dans les noms des points de terminaison entrants. Pour un appareil affecté existant, sauvegardez sa configuration, identifiez les actifs et charges de travail dépendants, et planifiez les interruptions avant de supprimer et recréer l’appareil avec un nom de point de terminaison en minuscule. Vérifiez que les écritures de statut fonctionnent et que la santé est rapportée après la recréation.

Le connecteur ne détecte pas les mises à jour des informations d'identification de l'appareil dans Azure Key Vault


ID de problème : 6514


N/A


Correction dans la version 2605 et ultérieure


Le connecteur ne reçoit pas de notification lorsque les informations d'identification de l'appareil stockées dans Azure Key Vault sont mises à jour. Par conséquent, le connecteur continue d’utiliser les anciennes informations d’identification jusqu’à ce qu’il soit redémarré.

Solution de contournement : redémarrez le connecteur pour le forcer à récupérer les informations d’identification mises à jour à partir de Azure Key Vault.

URL du connecteur OPC UA

Cette section répertorie les problèmes connus actuels du connecteur pour OPC UA.

Impossible d’utiliser des caractères spéciaux dans les noms d’événements


ID du problème : 1532


Correction dans la version 1.3.36 (2603) et versions ultérieures


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


La génération de schéma échoue si les noms d’événements contiennent des caractères spéciaux tels que #, %ou &. Évitez d’utiliser ces caractères dans les noms d’événements pour empêcher les problèmes de génération de schéma.

Modèle de connecteur OPC manquant


ID du problème : 1330


Corrigé dans la version 1.4.73 (2608) et ultérieure


Signature du journal : N/A


Le déploiement d’instance Opérations Azure IoT devrait installer par défaut un OPC ConnectorTemplate. Après le déploiement, le modèle de connecteur manque sur le portail Azure et la ConnectorTemplate ressource n'est pas présente dans le cluster.

Connecteur pour médias et connecteur pour les problèmes ONVIF

Cette section répertorie les problèmes connus actuels du connecteur pour le média et le connecteur pour ONVIF.

ContinuousMove rapporte un succès sans déplacer une caméra


ID du problème : 0205


S’applique à : L’expérience des opérations de préproduction utilisée avec l’aperçu public d’Opérations Azure IoT. L’impact sur l’expérience des opérations de production n’a pas été confirmé.


Correction prévue pour la sortie 2612.


Signature de journal : L’action PTZContinuousMove>renvoie Succeeded avec un résultat vide :

{"Result": {}}

Le formulaire d’exécution nécessite Zoom>X même si Velocity.Zoom est facultatif dans le schéma de requête de l’action. Sur une caméra pan-tilt affectée sans zoom optique, soumettre le formulaire indique un succès mais l’appareil ne bouge pas.

Solution de contournement : Invoquez l'action de PTZ>ContinuousMove la ressource via Azure Resource Manager executeAction avec une charge utile qui inclut PanTilt mais omet Zoom. Par exemple, utilisez le corps de requête suivant, remplaçant <media-profile-token> par un jeton retourné par l’action de la Media>GetProfiles caméra :

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

Envoyez payload comme un objet JSON, pas comme une chaîne encodée en JSON. Utilisez les valeurs de mouvement prises en charge par votre caméra et vérifiez le résultat avec PTZ>GetStatus; un résultat vide et réussi ne confirme pas le mouvement.

La découverte de médias dépasse la limite des points de terminaison des appareils découverts


ID du problème : 5382


S’applique à : aperçu public d’Opérations Azure IoT 2610, rapporté sur v1.6.0-preview.57 avec connecteur pour ONVIF v1.6.5.


Correction prévue pour la sortie 2612.


Signature de journal : Dans le journal d’activité du portail Azure, Microsoft.DeviceRegistry/namespaces/discoveredDevices/write échoue avec InvalidRequestContent, avec MaxProperties ciblant properties.endpoints.inbound:

The object must not contain more than 10 properties.

Le connecteur pour ONVIF génère des points de terminaison multimédias pour plusieurs transports par profil média. Azure Device Registry rejette les appareils découverts qui dépassent 10 points de terminaison entrants. Une caméra avec trois profils médias peut dépasser cette limite.

Le point d'extrémité ONVIF de la caméra peut indiquer Disponible et son actif ONVIF découvert peut apparaître, mais l'appareil découvert contenant ses points de terminaison médias n'apparaît pas dans Azure. Vous ne pouvez pas importer ces points de terminaison pour configurer le connecteur média via la découverte.

Solution de contournement : Créez un appareil manuellement avec un Microsoft.Media point d'accès entrant en utilisant l'URL du flux RTSP de la caméra issue de la documentation du fabricant, comme rtsp://<camera-ip>:554/<stream-path>. Configurez les identifiants via les références secrètes supportées, puis créez l’asset média ainsi que les instantanés ou flux de clips dont vous avez besoin. Voir Configurer le connecteur pour les médias.

Conflit de synchronisation des secrets


ID de problème : 0606


Signature du journal : N/A


Lorsque vous utilisez la synchronisation des secrets, vérifiez que les noms de secrets sont globalement uniques. Si un secret local portant le même nom existe, les connecteurs peuvent ne pas récupérer le secret prévu.

Problèmes liés au connecteur pour MQTT

Incompatibilité de version du modèle de connecteur MQTT pendant la mise à jour


ID de problème : 1533


Signature du journal : N/A


Corrigé dans la version 2606 et ultérieure


Lors de la mise à jour vers la version 2605, les modèles de connecteur MQTT existants peuvent afficher des versions de métadonnées incompatibles dans le portail. Pour résoudre, supprimer et recréer le modèle de connecteur. Vous pouvez également utiliser le Azure CLI pour mettre à jour le connecteur.

Le connecteur MQTT ne peut pas se connecter à des répartiteurs MQTT externes qui ont des adresses IP privées


ID de problème : 7791


Signature du journal : N/A


Corrigé dans la version 2607 et ultérieure


À partir de la version 2605, le connecteur MQTT ne peut plus se connecter aux courtiers MQTT externes qui utilisent des adresses IP privées.

Problèmes liés aux flux de données

Cette section répertorie les problèmes connus actuels pour les flux de données.

Échec de mise à niveau avec un décalage d’audience du point de terminaison du registre ACR


ID du problème : 3245


Signature du journal : N/A


Une mise à niveau Opérations Azure IoT peut échouer et revenir en arrière si un graphe de flux de données utilise un point de terminaison de registre Azure Container Registry (ACR) avec une audience ou une portée Azure Resource Manager (ARM) configurée explicitement. Des exemples de documentation antérieurs utilisaient l’audience ARM, donc une configuration existante fonctionnant avant la mise à niveau peut être affectée.

L’opérateur Dataflows enregistre une erreur de désappariement d’audience similaire à :

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

Solution de contournement : Mettez à jour la ressource Azure existante du point de terminaison du registre via Azure Resource Manager avant de réessayer la mise à jour :

  • Pour l’authentification d’identité managée assignée par le système, faites passer properties.authentication.systemAssignedManagedIdentitySettings.audience de https://management.azure.com/ à https://containerregistry.azure.net.
  • Pour l’authentification par identité gérée attribuée par l’utilisateur, changez properties.authentication.userAssignedManagedIdentitySettings.scope de https://management.azure.com/.default à https://containerregistry.azure.net/.default.

Conservez les autres propriétés du point de terminaison du registre et les paramètres d’authentification. Mettez à jour la ressource existante plutôt que de simplement modifier un fichier de déploiement local ou d’omettre un argument d’une commande update. Une fois que la ressource Azure et sa configuration de cluster correspondante auront pris en compte la nouvelle valeur, réessayez la mise à niveau.

Pour des exemples de configuration de points de terminaison du registre, voir Configurer les points de terminaison du registre.

L’interface utilisateur web d’Operations Experience affiche uniquement les artefacts du graphe de flux de données issus d’Azure Container Registry (ACR) et de mcr.microsoft.com


ID de numéro : 8895


Signature du journal : N/A


Même si vous configurez un point de terminaison de registre conteneur pour un registre de conteneurs non-ACR, comme GHCR :

  • Les artefacts des graphes de flux de données provenant du registre non-ACR n’apparaissent pas dans l’interface web de l’expérience d’opérations, donc vous ne pouvez pas créer un graphe de flux de données qui les utilise.

  • Sélectionner un graphe de flux de données dans la liste des flux de données dans l’interface web d’expérience d’opérations qui contient des éléments provenant d’un registre non-ACR produit une erreur similaire à : 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.

Solution de contournement : Vous avez deux options :

  • Si vous n’avez pas besoin d’utiliser l’interface utilisateur de l’expérience des opérations, utilisez Azure CLI pour effectuer des opérations CRUD sur des graphes de flux de données définis dans des fichiers JSON ou Bicep contenant des artefacts provenant de registres non ACR.

  • Si vous souhaitez utiliser l’interface web d’expérience des opérations, importez des artefacts de flux de données et des graphes provenant de registres non-ACR dans un registre ACR. Pour en savoir plus, consultez Transférer des modules vers votre registre.

Les ressources de flux de données créées avec Kubernetes ne sont pas visibles dans l’interface web de l’expérience d’opérations


ID de problème : 8724


Signature du journal : N/A


Les ressources personnalisées de flux de données créées dans votre cluster à l’aide de Kubernetes ne sont pas visibles dans l’interface utilisateur web de l’expérience des opérations. Ce résultat est attendu, car la gestion des composants Opérations Azure IoT à l'aide de Kubernetes est uniquement destinée au débogage et au test, et la synchronisation des ressources de la périphérie vers le cloud n'est pas prise en charge actuellement.

Il n’existe actuellement aucun moyen de contourner ce problème.

Impossible d’utiliser la même définition de graphe plusieurs fois dans un scénario de graphique chaîné


ID du problème : 1352


Correction dans la version 1.3.36 (2603) et versions ultérieures


Échec de l’envoi de la configuration


Vous créez un scénario de graphique chaîné à l’aide de la sortie d’un graphique de flux de données comme entrée vers un autre graphique de flux de données. Toutefois, si vous essayez d’utiliser la même définition de graphique plusieurs fois dans ce scénario, elle ne fonctionne actuellement pas comme prévu. Par exemple, le code suivant échoue lors de l’utilisation de la même définition de graphe (graph-passthrough:1.3.6) pour les deux graph-1 et 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'}
      }
  ]

Pour résoudre cette erreur, poussez la définition du graphe vers l'ACR autant de fois que nécessaire, chaque fois avec un scénario portant un nom ou une balise différent. Par exemple, dans le scénario décrit, la définition de graphique doit être envoyée deux fois avec un nom différent ou une balise différente, comme graph-passthrough-one:1.3.6 et graph-passthrough-two:1.3.6.

Problèmes liés au registre Edge

Cette section répertorie les problèmes actuellement connus concernant le registre Edge.

La configuration d’identité attribuée par l’utilisateur utilise le mauvais compte de service du registre


ID du problème : 3467


S’applique à : Opérations Azure IoT 2610 aperçu public. Rapporté sur v1.6.0-preview.57 ; le décalage de CLI existe également dans l’extension CLI v2.11.2, dont le profil de déploiement preview utilise v1.6.0-preview.60.


Correction prévue pour la sortie 2612.


Signature du journal : N/A


Lorsque vous exécutez az iot ops identity assign --usage schema sur une instance d’aperçu affectée, la CLI crée une identifiante fédérée avec le sujet system:serviceaccount:azure-iot-operations:adr-schema-registry. Le registre edge en préversion s’exécute sous le compte de service aio-edge-registry, donc les informations d’identification ne correspondent pas à la charge de travail.

La commande peut signaler un succès même si le compte de service du registre edge ne possède pas d’information d’identification fédérée correspondante. Le registre peut continuer à utiliser son identité existante attribuée par le système, masquant ainsi le décalage de configuration.

Contournement :

  1. Sur l’identité managée affectée par l’utilisateur destinée au registre Edge, ajoutez une information d’identification fédérée avec ces valeurs :
    • Émetteur : L’URL de l’émetteur OIDC du cluster connecté.
    • Objet :system:serviceaccount:azure-iot-operations:aio-edge-registry pour l’espace de noms par défaut. Si vous utilisez un autre espace de noms, remplacez-le par l’espace de noms réel.
    • Audience :api://AzureADTokenExchange.
  2. Vérifiez que les informations d’identification correspondent au compte de service utilisé par le pod du registre Edge. Si vous devez redémarrer le registre de prévisualisation, son StatefulSet est aio-edge-registry, non adr-schema-registry.

L’ajout de ces informations d’identification corrige le décalage de confiance, mais l’adoption d’un changement d’identité par le registre en cours d’exécution fait l’objet d’une enquête séparée. Ajouter l’identifiant ne confirme pas que le registre a changé d’identité. La sélection parmi plusieurs identités attribuées par l’utilisateur est également en cours d’étude.

Problèmes liés aux actions de gestion

Cette section liste les problèmes actuels connus concernant les actions de gestion.

L’abonnement Event Grid n’est pas prêt immédiatement après l’activation des actions de gestion


ID du problème : 0208


S’applique à : extension CLI v2.11.0 sur Opérations Azure IoT 2610 public preview, rapportée sur v1.6.0-preview.57.


Correction prévue pour la sortie 2612.


Signature dans les journaux : Le pod de flux de données enregistre des échecs d’abonnement, et la métrique Mqtt.FailedSubscriptionOperations de l’espace de noms Event Grid indique Error=AuthorizationError.


La commande az iot ops mgmt-actions enable crée le graphe de flux de données de requête avant d’attribuer les rôles Publisher et Subscriber de TopicSpaces Event Grid. Le graphe peut tenter de s’abonner avant d’être autorisé. Il réessaie avec temporisation croissante, et les échecs d’autorisation peuvent se poursuivre brièvement après que la CLI a signalé la réussite.

Les actions de gestion peuvent ne pas atteindre la périphérie tant que l’abonnement au graphe de requête n’a pas réussi.

Solution de contournement : Attendez environ une minute après le retour de az iot ops mgmt-actions enable avant d’envoyer la première action. Vérifiez les journaux du request graph pour confirmer que son abonnement a réussi. Si les échecs d’autorisation se poursuivent, vérifiez les attributions de rôles requises et prévoyez un temps supplémentaire pour la propagation des rôles. Ne rejouez pas automatiquement des actions non idempotentes dont le résultat d’exécution est inconnu.

Questions d’identité fédérée

Cette section énumère les problèmes actuels connus concernant l’identité fédérée.

Le désaccord entre les émetteurs d’identifiants d’identité fédérés peut provoquer des échecs d’authentification par synchronisation secrète


ID du problème : 1190


Corrigé dans la version 2607 et ultérieure


Signature de journal : similaire à 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.


Opérations Azure IoT rencontre 401 erreurs non autorisées lors de la récupération de secrets depuis Azure Key Vault.

Cause principale : L’erreur survient parce que l’URL émetteur fédérée de l’identifiant d’identité ne correspond pas à la revendication de l’émetteur (iss) dans le jeton de compte de service Kubernetes.

Lorsque la az iot ops secretsync enable commande crée une identifiante fédérée (FIC) sur l'identité managée attribuée par l'utilisateur que Opérations Azure IoT utilise pour accéder à Azure Key Vault, elle règle l'URL de l'émetteur FIC à celle de l'émetteur OIDC du cluster. Dans certains déploiements, cette URL comporte une barre oblique finale (« / ») qui ne figure pas dans la revendication iss (émetteur) du jeton de compte de service émis par le cluster.

Comme le problème affecte l’échange de jetons lors de la récupération du secret, l’échec ne se produit généralement pas lorsque vous exécutez az iot ops secretsync enable. Au lieu de cela, il refait surface plus tard lorsque Opérations Azure IoT tente d’accéder à un secret, ce qui peut rendre difficile l’identification de la cause profonde.

Solution de contournement : Vérifiez que l’URL de l’émetteur configurée dans les informations d’identification d’identité fédérée ne se termine pas par une barre oblique. Le cas échéant, mettez à jour les informations d’identification d’identité fédérée pour supprimer la barre oblique finale.

Vous pouvez utiliser les commandes Azure CLI az identity federated-credential pour afficher et, si nécessaire, mettre à jour la valeur de l’émetteur des informations d’identification d’identité fédérée, par exemple :

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>

En guise de bonne pratique, effectuez cette validation lors de la configuration après avoir lancé la az iot ops secretsync enable commande afin d’éviter des échecs d’authentification potentiellement difficiles à diagnostiquer ultérieurement.

Problèmes liés au protocole de contexte modèle (MCP)

Cette section répertorie les problèmes actuels connus pour MCP.

Le déploiement avec les certificats gérés par le client échoue lorsque le MCP est activé


ID du problème : 3314


S’applique à : Opérations Azure IoT 2610 aperçu public.


Correctif prévu pour la version 2612.


Signature du journal : N/A


Lorsque vous utilisez votre propre émetteur de certificats, le déploiement d’Opérations Azure IoT échoue si le MCP est activé. Les composants MCP font référence à l’émetteur de certificat par défaut et au bundle de confiance au lieu de vos ressources configurées.

Solution de contournement : Pour évaluer d’autres fonctionnalités d’Opérations Azure IoT avec des certificats gérés par le client, définissez explicitement features.mcp.mode sur Disabled dans votre configuration de déploiement avant le déploiement. MCP est activé par défaut. Voir Désactiver MCP pour le paramètre de configuration.