Bekannte Probleme für Azure IoT Einsatz

In diesem Artikel werden die aktuellen bekannten Probleme aufgeführt, die bei der Verwendung von Azure IoT Einsatz auftreten können. Die Anleitung hilft Ihnen bei der Identifizierung dieser Probleme und bietet Problemumgehungen, sofern verfügbar.

Allgemeine Anleitungen zur Problembehandlung finden Sie unter Troubleshoot Azure IoT Einsatz.

Azure Geräteregistrierungsprobleme

In diesem Abschnitt werden aktuelle bekannte Probleme für die Azure Geräteregistrierung aufgeführt.

ADR-Namespace-Objekt-Integritätszustand-Ressourcen werden nicht vom Edge zur Cloud synchronisiert.

Problem-ID: 1235

Protokollsignatur: N/A

Azure Device Registry Namespace-Asset-Healthstate-Ressourcen werden nicht mit der Cloud synchronisiert, wenn sie mit einer API-Version erstellt wurden, die älter als 2026-04-01 ist. Dieser Fehler tritt auf, da eine erforderliche Kubernetes-Ressourcenanmerkung fehlt.

Problemumgehung: Verwenden Sie den arc-Proxy, um eine Verbindung mit Ihrem Kubernetes-Cluster herzustellen, und führen Sie dann das Skript remediation für die verwendete Shell (PowerShell oder Bash) aus. Die Skripts enthalten alle veralteten Namespaceressourcen und fordern eine Bestätigung an, bevor sie die fehlenden Anmerkungen hinzufügen.

MQTT-Broker-Probleme

In diesem Abschnitt werden aktuelle bekannte Probleme für den MQTT-Broker aufgeführt.

MQTT-Brokerressourcen sind im Azure-Portal nicht sichtbar.

Problem-ID: 4257

Protokollsignatur: N/A

MQTT-Brokerressourcen, die in Ihrem Cluster mithilfe von Kubernetes erstellt wurden, sind im Azure-Portal nicht sichtbar. Dieses Ergebnis wird erwartet, da das Managing Azure IoT Einsatz-Komponenten mit Kubernetes nur zum Debuggen und Testen dient, und das Synchronisieren von Ressourcen vom Edge in die Cloud wird derzeit nicht unterstützt.

Für dieses Problem gibt es derzeit keine Problemumgehung.

Allgemeine Connectorprobleme

In diesem Abschnitt werden aktuelle bekannte Probleme aufgeführt, die sich auf alle Connectors auswirken.

Connector erkennt keine Updates für Geräteanmeldeinformationen in Azure Key Vault

Problem-ID: 6514

N/A

Behoben in Version 2605 und höher

Der Connector empfängt keine Benachrichtigung, wenn geräteanmeldeinformationen, die in Azure Key Vault gespeichert sind, aktualisiert werden. Daher verwendet der Connector weiterhin die alten Anmeldeinformationen, bis er neu gestartet wird.

Problemumgehung: Starten Sie den Connector neu, um zu erzwingen, dass die aktualisierten Anmeldeinformationen aus Azure Key Vault abgerufen werden.

Für Akri-Connectors ist der einzige unterstützte Authentifizierungstyp für Registrierungsendpunkte artifact pull secrets

Problem-ID: 4570

Protokollsignatur: N/A

Wenn Sie den Registrierungsendpunktverweis in einer Connectorvorlage angeben, gibt es mehrere unterstützte Authentifizierungsmethoden. Akri-Connectors unterstützen nur artifact pull secrets Authentifizierung.

Akri Connectors funktionieren nicht mit Registry-Endpunkt-Ressourcen

Problem-ID: 7710

Behoben in Version 1.2.154 (2512) und höher

Protokollsignatur:

[aio_akri_logs@311 tid="7"] - failed to generate StatefulSet payload for instance rest-connector-template-...
[aio_akri_logs@311 tid="7"] - reconciliation error for Connector resource... 
[aio_akri_logs@311 tid="7"] - reconciliation of Connector resource failed...

Wenn Sie eine RegistryEndpoint-Ressource mithilfe von Bicep erstellen und in der ConnectorTemplate-Ressource darauf verweisen, tritt bei der Abstimmung von ConnectorTemplate durch den Akri-Operator der zuvor gezeigte Fehler auf.

Problemumgehung: Verwenden Sie RegistryEndpoint Ressourcen nicht mit Akri-Anschlüssen. Geben Sie stattdessen die Registrierungsinformationen in den ContainerRegistry Einstellungen in der ConnectorTemplate Ressource an.

Akri-Fehler beim Aktualisieren oder Löschen einer Azure IoT Einsatz Instanz

Problem-ID: 9347

Behoben in Version 1.2.154 (2512) und höher

Benutzer können einen Fehler in Bezug auf abgelaufene Webhook-Zertifikate bei Akri feststellen, wenn sie Instanzen von Azure IoT Einsatz löschen/aktualisieren oder CRUD-Vorgänge an Akri-Ressourcen wie Connector- und ConnectorTemplates-Instanzen ausführen.

Workaround: Führe kubectl delete pod -n azure-iot-operations aio-akri-webhook-0 --ignore-not-found aus, um die Webhook-Pods zu löschen und neu zu starten, damit der Pod das neue Zertifikat abrufen kann.

Eingehende Geräteendpunkte erzwingen keine Authentifizierung, wenn keine angegeben wird

Problem-ID: 7337

Protokollsignatur: N/A

Im Azure Device Registry Device Resource Schema wird die zertifikatbasierte Authentifizierung (X.509) als Standardauthentifizierungsmethode für einen eingehenden Endpunkt aufgeführt. Die Authentifizierungseigenschaft selbst ist jedoch nullfähig, sodass es möglich ist, einen eingehenden Geräteendpunkt ohne Angabe einer Authentifizierungsmethode zu erstellen.

Wenn die Authentifizierung nicht angegeben wird, wird die implizite Standardeinstellung von X.509-Zertifikaten zur Laufzeit nicht angewendet. Der Inbound-Endpunkt des Geräts wird ohne erzwungene Authentifizierung erstellt.

Empfehlungen:

  • Kommunizieren Sie immer mit eingehenden Geräteendpunkten über ein authentifiziertes Protokoll.
  • Konfigurieren Sie die zertifikatbasierte Authentifizierung oder eine andere unterstützte Authentifizierungsmethode explizit in der Authentifizierungseigenschaft jedes eingehenden Endpunkts. Verlassen Sie sich nicht auf den Schema-Standardwert – er wird nicht automatisch angewendet.

Connector für OPC UA-Probleme

In diesem Abschnitt werden aktuelle bekannte Probleme für den Connector für OPC UA aufgeführt.

Sonderzeichen können nicht in Ereignisnamen verwendet werden.

Problem-ID: 1532

Behoben in Version 1.3.36 (2603) und höher

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

Fehler bei der Schemagenerierung, wenn Ereignisnamen Sonderzeichen wie #, % oder & enthalten. Vermeiden Sie die Verwendung dieser Zeichen in Ereignisnamen, um Probleme bei der Schemagenerierung zu vermeiden.

OPC-Steckverbinder-Schablone fehlt

Ausgabe-ID: 1330

Protokollsignatur: N/A

Die Azure IoT Einsatz Instanz-Bereitstellung sollte standardmäßig eine OPC ConnectorTemplate installieren. Nach der Bereitstellung fehlt die Connector-Vorlage im Azure-Portal und die Ressource ConnectorTemplate ist im Cluster nicht vorhanden.

Probleme mit dem Connector für Medien und Connector für ONVIF

In diesem Abschnitt werden aktuelle bekannte Probleme für den Connector für Medien und den Connector für ONVIF aufgeführt.

Geheimer Synchronisierungskonflikt

Problem-ID: 0606

Protokollsignatur: N/A

Stellen Sie bei verwendung der geheimen Synchronisierung sicher, dass geheime Namen global eindeutig sind. Wenn ein lokaler Geheimschlüssel mit demselben Namen vorhanden ist, können Connectors den beabsichtigten geheimen Schlüssel möglicherweise nicht abrufen.

ONVIF-Objektereignisziel kann nur auf Gruppen- oder Ressourcenebene konfiguriert werden.

Problem-ID: 9545

Behoben in Version 1.2.154 (2512) und höher

Protokollsignatur ähnlich wie:

No matching event subscription for topic: "tns1:RuleEngine/CellMotionDetector/Motion"

Derzeit werden ONVIF-Objektereignisziele nur auf ereignisgruppen- oder objektebene erkannt. Das Konfigurieren von Zielen auf der einzelnen Ereignisebene führt zu Protokolleinträgen ähnlich dem Beispiel, und es werden keine Ereignisdaten für den MQTT-Broker veröffentlicht.

Workaround: Konfigurieren Sie das Ereignisziel auf Ereignisgruppen- oder Asset-Ebene statt auf individueller Ereignisebene. Zum Beispiel auf Eventgruppenebene verwenden defaultEventsDestinations :

eventGroups:
  - dataSource: ""
    events:
    - dataSource: tns1:RuleEngine/CellMotionDetector/Motion
      destinations:
      - configuration:
          qos: Qos1
          retain: Never
          topic: azure-iot-operations/data/motion
          ttl: 5
        target: Mqtt
      name: Motion
    name: Default
    defaultEventsDestinations:
    - configuration:
        qos: Qos1
        retain: Never
        topic: azure-iot-operations/data/motion
        ttl: 5
      target: Mqtt

Konnektor für Probleme mit MQTT

Versionsabweichung der MQTT-Connector-Vorlage bei der Aktualisierung

Problem-ID: 1533

Protokollsignatur: N/A

Behoben in Version 2606 und später

Beim Aktualisieren auf Version 2605 werden vorhandene MQTT-Connectorvorlagen möglicherweise nicht übereinstimmende Metadatenversionen im Portal anzeigen. Um das Problem zu beheben, löschen Sie die Konnektorvorlage und erstellen Sie sie neu. Alternativ können Sie den Azure CLI verwenden, um den Connector zu aktualisieren.

MQTT-Connector kann keine Verbindung mit externen MQTT-Brokern herstellen, die private IP-Adressen haben

Problem-ID: 7791

Protokollsignatur: N/A

Behoben in Version 2607 und später

Ab Release 2605 kann der MQTT-Anschluss keine Verbindung zu externen MQTT-Brokern herstellen, die private IP-Adressen verwenden.

Probleme mit Datenflüssen

In diesem Abschnitt werden die aktuellen bekannten Probleme für Datenflüsse aufgeführt.

Die Web-UI der Operations Experience zeigt nur Datenflussgraph-Artefakte an, die aus Azure Container Registry (ACR) und mcr.microsoft.com stammen

Ausgabe-ID: 8895

Protokollsignatur: N/A

Selbst wenn Sie einen Container-Registry-Endpunkt für eine nicht-ACR-Container-Registry wie GHCR konfigurieren:

  • Datenflussgraph-Artefakte aus dem Nicht-ACR-Register erscheinen nicht in der Operations Experience Web-UI, daher kann man keinen Datenflussgraphen erstellen, der sie verwendet.

  • Das Auswählen eines Datenflussgraphen aus der Liste der Datenflüsse in der Operations Experience Web-UI, der Elemente aus einem Nicht-ACR-Register enthält, erzeugt einen Fehler ähnlich wie folgt: 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.

Workaround: Du hast zwei Möglichkeiten:

  • Wenn Sie die Operations-Experience-Benutzeroberfläche nicht benötigen, nutzen Sie die Azure CLI, um CRUD-Operationen auf Datenflussgraphen durchzuführen, die in JSON- oder Bicep-Dateien definiert sind und Artefakte enthalten, die aus nicht-ACR-Registrierungen stammen.

  • Wenn Sie die Weboberfläche der Operations Experience nutzen möchten, importieren Sie Datenflussartefakte und Graphen aus Nicht-ACR-Registren in eine ACR-Registry. Weitere Informationen finden Sie unter Module per Push an Ihre Registry übertragen.

Datenflussressourcen, die mit Kubernetes erstellt wurden, sind in der Weboberfläche der Betriebserfahrung nicht sichtbar

Problem-ID: 8724

Protokollsignatur: N/A

Benutzerdefinierte Datenflussressourcen, die in Ihrem Cluster mithilfe von Kubernetes erstellt wurden, sind in der Webbenutzeroberfläche für Vorgänge nicht sichtbar. Dieses Ergebnis wird erwartet, da das Managing Azure IoT Einsatz-Komponenten mit Kubernetes nur zum Debuggen und Testen dient, und das Synchronisieren von Ressourcen vom Edge in die Cloud wird derzeit nicht unterstützt.

Für dieses Problem gibt es derzeit keine Problemumgehung.

Ein Datenflussprofil darf 70 Datenflüsse nicht überschreiten.

Problem-ID: 1028

Protokollsignatur:

exec /bin/main: argument list too long

Wenn Sie mehr als 70 Datenflüsse für ein einzelnes Datenflussprofil erstellen, schlagen Bereitstellungen mit dem Fehler fehl exec /bin/main: argument list too long.

Um dieses Problem zu umgehen, erstellen Sie mehrere Datenflussprofile, und verteilen Sie die Datenflüsse darauf. Überschreiten Sie nicht 70 Datenflüsse pro Profil.

Die gleiche Diagrammdefinition kann nicht mehrmals in einem verketteten Diagrammszenario verwendet werden.

Problem-ID: 1352

Behoben in Version 1.3.36 (2603) und höher

Fehler beim Senden der Konfiguration

Sie erstellen ein verkettetes Diagrammszenario, indem Sie die Ausgabe eines Datenflussdiagramms als Eingabe für ein anderes Datenflussdiagramm verwenden. Wenn Sie jedoch versuchen, dieselbe Diagrammdefinition mehrmals in diesem Szenario zu verwenden, funktioniert sie derzeit nicht wie erwartet. Der folgende Code schlägt beispielsweise fehl, wenn die gleiche Graph-Definition (graph-passthrough:1.3.6) für sowohl graph-1 als auch graph-2 verwendet wird.

      {
          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'}
      }
  ]

Um diesen Fehler zu beheben, pushen Sie die Graphdefinition so oft wie nötig mit dem Szenario und jedes Mal mit einem anderen Namen oder Tag an ACR. In dem beschriebenen Szenario muss die Diagrammdefinition beispielsweise zweimal mit entweder einem anderen Namen oder einem anderen Tag, wie etwa graph-passthrough-one:1.3.6 und graph-passthrough-two:1.3.6, verschoben werden.

Fragen der föderierten Identität

Dieser Abschnitt listet aktuelle bekannte Probleme für föderierte Identitäten auf.

Eine Nichtübereinstimmung beim Aussteller der föderierten Identitätsanmeldeinformationen kann zu Authentifizierungsfehlern bei Secret Sync führen

Ausgabe-ID: 1190

Behoben in Version 2607 und später

Logsignatur: Ähnlich wie 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.

Bei Azure IoT Einsatz treten beim Abrufen von Geheimnissen aus Azure Key Vault 401-Fehler wegen fehlender Autorisierung auf.

Wurzelursache: Der Fehler tritt auf, weil die URL der föderierten Identitätszugangsdaten nicht mit dem Aussteller-(ISS)-Anspruch im Kubernetes-Service-Kontotoken übereinstimmt.

Wenn der az iot ops secretsync enable Befehl eine föderierte Identitätszugangsdaten (FIC) auf der vom Benutzer zugewiesenen verwalteten Identität erstellt, die Azure IoT Einsatz zum Zugriff auf Azure Key Vault verwendet, setzt er die URL des FIC-Herausgebers auf die OIDC-Ausgaber-URL des Clusters. In einigen Bereitstellungen enthält diese URL einen nachgestellten Schrägstrich (/), den der iss-Claim (Aussteller) des vom Cluster ausgestellten Dienstkontotoken auslässt.

Da das Problem den Tokenaustausch beim Abrufen von Geheimnissen betrifft, tritt der Fehler normalerweise nicht auf, wenn Sie az iot ops secretsync enable ausführen. Stattdessen taucht sie später auf, wenn Azure IoT Einsatz versucht, auf ein Geheimnis zuzugreifen, was die Ursache schwer zu identifizieren machen kann.

Problemumgehung: Überprüfen Sie, ob die für die Verbundidentitätsanmeldeinformation konfigurierte Aussteller-URL auf einen Schrägstrich endet. Ist dies der Fall, aktualisieren Sie die Verbundidentitätsanmeldeinformation und entfernen Sie den nachgestellten Schrägstrich.

Sie können die Azure CLI-Befehle az identity federated-credential verwenden, um den Ausstellerwert der Verbundidentitätsanmeldeinformationen anzuzeigen und bei Bedarf zu aktualisieren, beispielsweise:

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>

Als Best Practice führen Sie diese Validierung während der Einrichtung nach dem Ausführen des Befehls az iot ops secretsync enable durch, um später schwer zu diagnostizierende Authentifizierungsfehler zu vermeiden.

  • Last updated on