Bekende problemen voor Azure IoT-bewerkingen

In dit artikel worden de huidige bekende problemen vermeld die kunnen optreden bij het gebruik van Azure IoT-bewerkingen. De richtlijnen helpen u bij het identificeren van deze problemen en bieden waar beschikbaar tijdelijke oplossingen.

Zie Troubleshoot Azure IoT-bewerkingen voor algemene richtlijnen voor probleemoplossing.

Problemen met Azure apparaatregister

Deze sectie bevat actuele bekende problemen voor het Azure Device Registry.

Resources voor de toestandsstatus van ADR-naamruimteassets worden niet gesynchroniseerd van edge naar de cloud.

Probleem-id: 1235

Logboekhandtekening: N/B

Azure Device Registry namespace gezondheidsstatusbronnen worden niet terug gesynchroniseerd naar de cloud als ze zijn gemaakt met een API-versie ouder dan 2026-04-01. Deze fout treedt op omdat een vereiste Kubernetes-resourceaantekening ontbreekt.

Tijdelijke oplossing: gebruik de arcproxy om verbinding te maken met uw Kubernetes-cluster en voer vervolgens het herstelscript uit voor de shell die u gebruikt (PowerShell of bash). De scripts geven een lijst van alle verouderde naamruimte-assets weer en vragen om bevestiging voordat ze de ontbrekende aantekeningen toevoegen.

Problemen met MQTT-broker

In deze sectie vindt u een overzicht van de huidige bekende problemen voor de MQTT-broker.

MQTT-broker-resources zijn niet zichtbaar in de Azure-portal

Probleem-id: 4257

Logboekhandtekening: N/B

MQTT Broker-resources die in uw cluster zijn gemaakt met kubernetes, zijn niet zichtbaar in de Azure-portal. Dit resultaat wordt verwacht omdat beheer van Azure IoT-bewerkingen onderdelen die Gebruikmaken van Kubernetes alleen bedoeld is voor foutopsporing en testen, en het synchroniseren van resources van de rand naar de cloud wordt momenteel niet ondersteund.

Er is momenteel geen tijdelijke oplossing voor dit probleem.

Algemene verbindingsproblemen

In deze sectie vindt u een overzicht van de huidige bekende problemen die van invloed zijn op alle connectors.

Connector detecteert geen updates voor apparaatreferenties in Azure Key Vault

Probleem-id: 6514

N/A

Opgelost in release 2605 en hoger

De connector ontvangt geen melding wanneer apparaatreferenties die zijn opgeslagen in Azure Key Vault worden bijgewerkt. De connector blijft hierdoor de oude inloggegevens gebruiken tot deze opnieuw is opgestart.

Tijdelijke oplossing: start de connector opnieuw om af te dwingen dat de bijgewerkte referenties worden opgehaald uit Azure Key Vault.

Voor Akri-connectors is het enige ondersteunde verificatietype voor registereindpunten artifact pull secrets

Probleem-id: 4570

Logboekhandtekening: N/B

Wanneer u de referentie voor het registereindpunt opgeeft in een connectorsjabloon, zijn er meerdere ondersteunde verificatiemethoden. Akri-connectors ondersteunen alleen artifact pull secrets verificatie.

Akri-connectors werken niet met register-eindpuntbronnen

Probleem-id: 7710

Opgelost in versie 1.2.154 (2512) en hoger

Logboekhandtekening:

[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...

Als u een RegistryEndpoint-resource maakt met bicep en ernaar verwijst in de ConnectorTemplate-resource, dan zal de Akri-operator bij het proberen af te stemmen van de ConnectorTemplate mislukken vanwege de eerder weergegeven fout.

Tijdelijke oplossing: gebruik geen RegistryEndpoint resources met Akri-connectors. Geef in plaats daarvan de registergegevens op in de ContainerRegistry instellingen in de ConnectorTemplate resource.

Akri-fout bij het bijwerken of verwijderen van een Azure IoT-bewerkingen-exemplaar

Probleem-id: 9347

Opgelost in versie 1.2.154 (2512) en hoger

Gebruikers kunnen een fout tegenkomen met betrekking tot verlopen webhookcertificaten met Akri bij het verwijderen/upgraden van exemplaren van Azure IoT-bewerkingen of het uitvoeren van CRUD-bewerkingen op Akri-resources, zoals Connector en ConnectorTemplates-exemplaren.

Oplossing doen: Start kubectl delete pod -n azure-iot-operations aio-akri-webhook-0 --ignore-not-found om de webhook-pods te verwijderen en opnieuw te starten zodat de pod het nieuwe certificaat kan ophalen.

Inkomende eindpunten voor apparaten dwingen geen authenticatie af als die niet is opgegeven

Probleem-id: 7337

Logboekhandtekening: N/B

De Azure Device Registry Device Resource Schema bevat verificatie op basis van certificaten (X.509) als de standaardverificatiemethode voor een binnenkomend eindpunt. De verificatie-eigenschap zelf is echter nullable, dus het is mogelijk om een binnenkomend apparaateindpunt te maken zonder een verificatiemethode op te geven.

Wanneer verificatie wordt weggelaten, wordt de impliciete standaardwaarde van X.509-certificaten niet toegepast tijdens runtime. Het inkomende eindpunt van het apparaat wordt aangemaakt zonder afgedwongen authenticatie.

Aanbevelingen:

  • Communiceer altijd met binnenkomende eindpunten van apparaten via een geverifieerd protocol.
  • Configureer expliciet verificatie op basis van certificaten of een andere ondersteunde verificatiemethode in de verificatie-eigenschap van elk binnenkomend eindpunt. Vertrouw niet op de standaardinstelling van het schema. Deze wordt niet impliciet toegepast.

Problemen met de OPC UA-connector

In deze sectie vindt u de huidige bekende problemen voor de connector voor OPC UA.

Kan geen speciale tekens gebruiken in gebeurtenisnamen

Probleem-id: 1532

Opgelost in versie 1.3.36 (2603) en hoger

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

Het genereren van schema's mislukt als gebeurtenisnamen speciale tekens bevatten, zoals #, %of &. Vermijd het gebruik van deze tekens in gebeurtenisnamen om problemen met het genereren van schema's te voorkomen.

OPC-connectorsjabloon ontbreekt

Uitgave-ID: 1330

Logboekhandtekening: N/B

Azure IoT-bewerkingen instance-implementatie zou standaard een OPC ConnectorTemplate moeten installeren. Na de implementatie ontbreekt de connectortemplate in het Azure-portaal en is de ConnectorTemplate resource niet aanwezig in het cluster.

Connector voor media en connector voor ONVIF-aangelegenheden

In deze sectie vindt u de huidige bekende problemen voor de connector voor media en de connector voor ONVIF.

Synchronisatieconflict voor geheim

Probleem-id: 0606

Logboekhandtekening: N/B

Wanneer u geheimsynchronisatie gebruikt, moet u ervoor zorgen dat geheime namen wereldwijd uniek zijn. Als er een lokaal geheim met dezelfde naam bestaat, kunnen connectors het beoogde geheim mogelijk niet ophalen.

Het doel voor ONVIF-assetgebeurtenissen kan alleen worden geconfigureerd op groep- of assetniveau.

Probleem-id: 9545

Opgelost in versie 1.2.154 (2512) en hoger

Logboekhandtekening vergelijkbaar met:

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

Op dit moment worden ONVIF-gebeurtenisbestemmingen alleen herkend op gebeurtenisgroep- of op assetniveau. Het configureren van bestemmingen op het niveau van de afzonderlijke gebeurtenis resulteert in logboekvermeldingen die vergelijkbaar zijn met het voorbeeld en er worden geen gebeurtenisgegevens gepubliceerd naar de MQTT-broker.

Oplossing: Configureer de gebeurtenisbestemming op het niveau van de gebeurtenisgroep of asset in plaats van op individueel evenementniveau. Gebruik bijvoorbeeld defaultEventsDestinations op het niveau van de evenementgroep:

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

Problemen met connector voor MQTT

MQTT-connectorsjabloonversie komt niet overeen tijdens de update

Probleem-id: 1533

Logboekhandtekening: N/B

Opgelost in release 2606 en later

Bij het bijwerken naar versie 2605 kunnen bestaande MQTT-connectorsjablonen niet-overeenkomende metagegevensversies weergeven in de portal. U kunt dit oplossen door de connectorsjabloon te verwijderen en opnieuw te maken. U kunt ook de Azure CLI gebruiken om de connector bij te werken.

MQTT-connector kan geen verbinding maken met externe MQTT-brokers met privé-IP-adressen

Probleem-id: 7791

Logboekhandtekening: N/B

Opgelost in versie 2607 en hoger

Vanaf release 2605 kan de MQTT-connector geen verbinding maken met externe MQTT-brokers die privé-IP-adressen gebruiken.

Problemen met gegevensstromen

In deze sectie vindt u een overzicht van de huidige bekende problemen voor gegevensstromen.

De webgebruikersinterface van Operations Experience toont alleen artefacten van gegevensstroomgrafieken die afkomstig zijn uit Azure Container Registry (ACR) en mcr.microsoft.com

Issue ID: 8895

Logboekhandtekening: N/B

Zelfs als je een containerregister-endpoint configureert voor een niet-ACR containerregister, zoals GHCR:

  • Artefacten van gegevensstroomgrafieken uit het niet-ACR-register worden niet weergegeven in de Operations-webinterface, dus kunt u geen gegevensstroomgrafiek maken waarin deze worden gebruikt.

  • Het selecteren van een datastroomgrafiek uit de lijst van datastromen in de operations experience webinterface die elementen bevat uit een niet-ACR-register, levert een fout op die lijkt op: 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: Je hebt twee opties:

  • Als je de gebruikersinterface van de operationele ervaring niet nodig hebt, gebruik dan de Azure CLI om CRUD-operaties uit te voeren op dataflowgrafieken die zijn gedefinieerd in JSON- of Bicep-bestanden en artefacten bevatten afkomstig van niet-ACR-registers.

  • Als je de operations experience webinterface wilt gebruiken, importeer dan datastroomartefacten en grafieken van niet-ACR-registers naar een ACR-register. Zie modules uploaden naar je register voor meer informatie.

Dataflowbronnen die met Kubernetes zijn gemaakt, zijn niet zichtbaar in de webinterface van de operationele ervaring

Probleem-id: 8724

Logboekhandtekening: N/B

Aangepaste resources voor gegevensstromen die zijn gemaakt in uw cluster met Kubernetes, zijn niet zichtbaar in de webgebruikersinterface van het operationeel dashboard. Dit resultaat wordt verwacht omdat beheer van Azure IoT-bewerkingen onderdelen die Gebruikmaken van Kubernetes alleen bedoeld is voor foutopsporing en testen, en het synchroniseren van resources van de rand naar de cloud wordt momenteel niet ondersteund.

Er is momenteel geen tijdelijke oplossing voor dit probleem.

Een gegevensstroomprofiel mag niet groter zijn dan 70 gegevensstromen

Probleem-id: 1028

Logboekhandtekening:

exec /bin/main: argument list too long

Als u meer dan 70 gegevensstromen voor één gegevensstroomprofiel maakt, mislukken implementaties met de fout exec /bin/main: argument list too long.

Als u dit probleem wilt omzeilen, maakt u meerdere gegevensstroomprofielen en distribueert u de gegevensstromen ertussen. Overschrijd niet meer dan 70 gegevensstromen per profiel.

Kan niet meerdere keren dezelfde grafiekdefinitie gebruiken in een gekoppeld grafiekscenario

Probleem-id: 1352

Opgelost in versie 1.3.36 (2603) en hoger

Kan configuratie niet verzenden

U maakt een scenario voor een gekoppelde grafiek met behulp van de uitvoer van een gegevensstroomgrafiek als invoer voor een andere gegevensstroomgrafiek. Als u in dit scenario echter meerdere keren dezelfde grafiekdefinitie probeert te gebruiken, werkt deze momenteel niet zoals verwacht. De volgende code mislukt bijvoorbeeld bij het gebruik van dezelfde grafiekdefinitie (graph-passthrough:1.3.6) voor beide graph-1 en 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'}
      }
  ]

Om deze fout op te lossen, pusht u de grafiekdefinitie naar de ACR zo vaak als nodig met een scenario dat elke keer een andere naam of tag krijgt. In het beschreven scenario moet de grafiekdefinitie bijvoorbeeld tweemaal worden gepusht met een andere naam of een andere tag, zoals graph-passthrough-one:1.3.6 en graph-passthrough-two:1.3.6.

Kwesties rond federatie-identiteit

Deze sectie geeft een overzicht van de huidige bekende problemen voor federated identity.

Een mismatch in de verlener van de referentie voor federatieve identiteit kan authenticatiefouten bij geheimesynchronisatie veroorzaken

Uitgave-ID: 1190

Opgelost in versie 2607 en later

Loghandtekening: Vergelijkbaar met 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.

Azure IoT-bewerkingen krijgt 401 Unauthorized-fouten bij het ophalen van geheimen uit Azure Key Vault.

Oorzaak: De fout ontstaat omdat de URL van de federated identity credential issuer niet overeenkomt met de claim van de uitgever (iss) in het Kubernetes-serviceaccounttoken.

Wanneer het az iot ops secretsync enable commando een gefedereerd identiteitscredential (FIC) aanmaakt op de door de gebruiker toegewezen beheerde identiteit die Azure IoT-bewerkingen gebruikt om toegang te krijgen tot Azure Key Vault, stelt het de URL van de FIC-uitgever in op de OIDC-uitverder-URL van de cluster. In sommige implementaties bevat deze URL een afsluitende slash ('/') die de iss-claim (issuer) van het door het cluster uitgegeven serviceaccounttoken weglaat.

Omdat het probleem de tokenuitwisseling bij het ophalen van geheimen beïnvloedt, treedt de fout meestal niet op wanneer je az iot ops secretsync enable uitvoert. In plaats daarvan komt het later naar voren wanneer Azure IoT-bewerkingen probeert toegang te krijgen tot een geheim, wat het moeilijk kan maken om de onderliggende oorzaak te identificeren.

Oplossing: Controleer of de uitgever-URL die is geconfigureerd op het gefedereerde identiteitsbewijs niet eindigt met een slash. Als dat het geval is, werk dan de referentie voor federatieve identiteit bij om de afsluitende slash te verwijderen.

Je kunt de Azure CLI az identity federated-credential commando's gebruiken om de waarde van federated identity credential issuer te bekijken en, indien nodig, bij te werken, bijvoorbeeld:

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 voer je deze validatie uit tijdens de setup nadat je het az iot ops secretsync enable commando hebt uitgevoerd, om later mogelijk moeilijk te diagnosticeren authenticatiefouten te voorkomen.

  • Last updated on