Kända problem för Azure IoT Operations

I den här artikeln visas de aktuella kända problem som kan uppstå när du använder Azure IoT Operations. Vägledningen hjälper dig att identifiera dessa problem och tillhandahåller lösningar där det finns.

Allmän felsökningsvägledning finns i Felsöka Azure IoT Operations.

problem med Azure enhetsregister

I det här avsnittet visas aktuella kända problem för Azure Device Registry.

ADR-namnområdestillgångs hälsostatusresurser synkroniseras inte från kant till moln


Problem-ID: 1235


Loggsignatur: Ej tillämpligt


Azure-resurser för enhetsregistrets tillgångars hälsotillstånd synkroniseras inte tillbaka till molnet om de skapades med en API-version tidigare än 2026-04-01. Det här felet beror på att en nödvändig Kubernetes-resursanteckning saknas.

Lösning: Använd arc proxy för att ansluta till kubernetes-klustret och kör sedan skriptet remediation för det gränssnitt som du använder (PowerShell eller bash). Skripten visar alla inaktuella namnområdestillgångar och begär bekräftelse innan de lägger till de saknade anteckningarna.

Problem med MQTT-koordinator

I det här avsnittet visas aktuella kända problem för MQTT-koordinatorn.

MQTT-brokerresurser visas inte på Azure-portalen


Problem-ID: 4257


Loggsignatur: Ej tillämpligt


MQTT-koordinatorresurser som skapats i klustret med Kubernetes visas inte i Azure portalen. Det här resultatet förväntas eftersom hantera Azure IoT Operations komponenter med Kubernetes endast är till för felsökning och testning, och synkronisering av resurser från gränsen till molnet stöds för närvarande inte.

Det finns för närvarande ingen lösning på det här problemet.

Allmänna anslutningsproblem

I det här avsnittet visas aktuella kända problem som påverkar alla anslutningar.

Anslutningsappen identifierar inte uppdateringar av enhetens autentiseringsuppgifter i Azure Key Vault


Problem-ID: 6514


N/A


Åtgärdat i version 2605 och senare


Anslutningsappen får inget meddelande när enhetens autentiseringsuppgifter som lagras i Azure Key Vault uppdateras. Därför fortsätter anslutningsappen att använda de gamla autentiseringsuppgifterna tills den startas om.

Lösning: Starta om anslutningsappen för att tvinga den att hämta de uppdaterade autentiseringsuppgifterna från Azure Key Vault.

För Akri-anslutningar är den enda autentiseringstyp som stöds för registerslutpunkter artifact pull secrets


Problem-ID: 4570


Loggsignatur: Ej tillämpligt


När du anger registerslutpunktsreferensen i en anslutningsmall finns det flera autentiseringsmetoder som stöds. Akri-anslutningar stöder endast artifact pull secrets-autentisering.

Akri-kopplingar fungerar inte med registerändpunktsresurser


Problem-ID: 7710


Åtgärdat i version 1.2.154 (2512) och senare


Loggsignatur:

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

Om du skapar en RegistryEndpoint-resurs med hjälp av Bicep och refererar till den i ConnectorTemplate-resursen, så misslyckas operationen när Akri-operatorn försöker stämma av ConnectorTemplate med det fel som visades tidigare.

Lösning: Använd inte RegistryEndpoint resurser med Akri-anslutningsappar. Ange i stället registerinformationen ContainerRegistry i inställningarna i resursen ConnectorTemplate .

Akri-fel vid uppdatering eller borttagning av en Azure IoT Operations-instans


Problem-ID: 9347


Åtgärdat i version 1.2.154 (2512) och senare


Användare kan stöta på ett fel när det gäller utgångna webhookcertifikat med Akri när de tar bort/uppgraderar instanser av Azure IoT Operations eller utför CRUD-åtgärder på Akri-resurser som Connector och ConnectorTemplates instanser.

Lösning: Kör kubectl delete pod -n azure-iot-operations aio-akri-webhook-0 --ignore-not-found för att ta bort och starta om webhook-poddarna för att låta podden hämta det nya certifikatet.

Enhetens inkommande slutpunkter framtvingar inte autentisering när ingen har angetts


Problem-ID: 7337


Loggsignatur: Ej tillämpligt


Resursschemat Azure device registry device listar certifikatbaserad autentisering (X.509) som standardautentiseringsmetod för en inkommande slutpunkt. Själva autentiseringsegenskapen är dock null, så det är möjligt att skapa en inkommande slutpunkt för enheten utan att ange någon autentiseringsmetod.

När autentisering utelämnas tillämpas inte den underförstådda standardinställningen för X.509-certifikat vid körning. Enhetens inkommande slutpunkt skapas utan autentisering.

Recommendations:

  • Kommunicera alltid med enhetens inkommande slutpunkter via ett autentiserat protokoll.
  • Konfigurera uttryckligen certifikatbaserad autentisering, eller en annan autentiseringsmetod som stöds, i autentiseringsegenskapen för varje inkommande slutpunkt. Förlita dig inte på schemats standardinställning – det tillämpas inte implicit.

Anslutning för OPC UA-problem

I det här avsnittet listas aktuella kända problem för anslutningen för OPC UA.

Det går inte att använda specialtecken i händelsenamn


Problem-ID: 1532


Åtgärdat i version 1.3.36 (2603) och senare


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


Schemagenereringen misslyckas om händelsenamn innehåller specialtecken som #, %eller &. Undvik att använda dessa tecken i händelsenamn för att förhindra problem med schemagenerering.

OPC-anslutningsmall saknas


Utgåvo-ID: 1330


Loggsignatur: Ej tillämpligt


Azure IoT Operations instansdistribution bör installera en OPC ConnectorTemplate som standard. Efter utrullningen saknas connectormallen i Azure-portalen och resursen ConnectorTemplate finns inte i klustret.

Anslutning för media och anslutning för problem med ONVIF

I det här avsnittet visas aktuella kända problem för anslutningsappen för media och anslutningsappen för ONVIF.

Hemlig sync-konflikt


Problem-ID: 0606


Loggsignatur: Ej tillämpligt


När du använder hemlig synkronisering kontrollerar du att hemliga namn är globalt unika. Om en lokal sekretess med samma namn finns kan kopplingar misslyckas med att hämta den avsedda sekretessen.

ONVIF-händelsemål för tillgångar kan bara konfigureras på grupp- eller tillgångsnivå


Problem-ID: 9545


Åtgärdat i version 1.2.154 (2512) och senare


Loggsignatur som liknar:

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


För närvarande identifieras ONVIF-mål för tillgångshändelser endast på händelsegrupps- eller tillgångsnivå. Att konfigurera mål på den enskilda händelsenivån resulterar i loggposter som liknar exemplet och inga händelsedata publiceras till MQTT-koordinatorn.

Lösning: Konfigurera händelsedestinationen på händelsegrupps- eller tillgångsnivå istället för på individuell händelsenivå. Till exempel, använd defaultEventsDestinations på evenemangsgruppsnivå:

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

Anslutning för MQTT-ärenden

Versionskonflikt i MQTT-anslutningsmall vid uppdatering


Problem-ID: 1533


Loggsignatur: Ej tillämpligt


Åtgärdat i version 2606 och senare


När du uppdaterar till version 2605 kan befintliga MQTT-anslutningsmallar visa felaktiga metadataversioner i portalen. Lös problemet genom att ta bort och återskapa anslutningsmallen. Du kan också använda Azure CLI för att uppdatera anslutningsappen.

MQTT-anslutningsappen kan inte ansluta till externa MQTT-koordinatorer som har privata IP-adresser


Problem-ID: 7791


Loggsignatur: Ej tillämpligt


Åtgärdat i version 2607 och senare


Från och med release 2605 kan MQTT-kontakten inte ansluta till externa MQTT-mäklare som använder privata IP-adresser.

Problem med dataflöden

I det här avsnittet visas aktuella kända problem för dataflöden.

Operations-upplevelsens webbgränssnitt visar endast artefakter för dataflödesgrafer som kommer från Azure Container Registry (ACR) och mcr.microsoft.com


Utgåvo-ID: 8895


Loggsignatur: Ej tillämpligt


Även om du konfigurerar en slutpunkt för containerregister för ett containerregister som inte är ACR, till exempel GHCR:

  • Dataflödesgrafartefakter från icke-ACR-registret visas inte i Operations Experience-webbgränssnittet, så du kan inte skapa en dataflödesgraf som använder dem.

  • Att välja en dataflödesgraf från listan över dataflöden i operationsupplevelsens webbgränssnitt som innehåller element från ett icke-ACR-register ger ett fel liknande som: 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.

Lösning: Du har två alternativ:

  • Om du inte behöver använda operationsupplevelsegränssnittet, använd Azure CLI för att utföra CRUD-operationer på dataflödesgrafer definierade i JSON- eller Bicep-filer som innehåller artefakter hämtade från icke-ACR-register.

  • Om du vill använda operations experience-webbgränssnittet, importera dataflödesartefakter och grafer från icke-ACR-register till ett ACR-register. Mer information finns i Skicka moduler till ditt register.

Dataflödesresurser skapade med Kubernetes är inte synliga i operationsupplevelsens webbgränssnitt


Problem-ID: 8724


Loggsignatur: Ej tillämpligt


Anpassade dataflödesresurser som skapats i klustret med Kubernetes visas inte i webbgränssnittet för driftupplevelsen. Det här resultatet förväntas eftersom hantera Azure IoT Operations komponenter med Kubernetes endast är till för felsökning och testning, och synkronisering av resurser från gränsen till molnet stöds för närvarande inte.

Det finns för närvarande ingen lösning på det här problemet.

En dataflödesprofil får inte överskrida 70 dataflöden


Problem-ID: 1028


Loggsignatur:

exec /bin/main: argument list too long


Om du skapar fler än 70 dataflöden för en enda dataflödesprofil misslyckas distributionerna med felet exec /bin/main: argument list too long.

Du kan lösa det här problemet genom att skapa flera dataflödesprofiler och distribuera dataflödena mellan dem. Överskrid inte 70 dataflöden per profil.

Det går inte att använda samma grafdefinition flera gånger i ett länkat diagramscenario


Problem-ID: 1352


Åtgärdat i version 1.3.36 (2603) och senare


Det gick inte att skicka konfigurationen


Du skapar ett länkat grafscenario med hjälp av utdata från ett dataflödesdiagram som indata till ett annat dataflödesdiagram. Men om du försöker använda samma grafdefinition flera gånger i det här scenariot fungerar den för närvarande inte som förväntat. Följande kod misslyckas till exempel när du använder samma grafdefinition (graph-passthrough:1.3.6) för både graph-1 och 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'}
      }
  ]

Lös det här felet genom att skicka grafdefinitionen till ACR så många gånger som behövs med scenariot med ett annat namn eller en annan tagg varje gång. I det scenario som beskrivs måste grafdefinitionen till exempel push-överföras två gånger med antingen ett annat namn eller en annan tagg, till exempel graph-passthrough-one:1.3.6 och graph-passthrough-two:1.3.6.

Frågor om federerad identitet

Denna sektion listar aktuella kända problem för federerad identitet.

Matchningsfel för utfärdaren av autentiseringsuppgifter för federerad identitet kan orsaka autentiseringsfel vid synkronisering av hemligheter


Utgåvo-ID: 1190


Åtgärdat i version 2607 och senare


Loggsignatur: Liknande 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 Operations stöter på 401-obehöriga fel när man hämtar hemligheter från Azure Key Vault.

Grundorsak: Felet uppstår eftersom utfärdar-URL:en för den federerade identitetsautentiseringsuppgiften inte matchar utfärdarfältet (iss) i token för Kubernetes-tjänstkontot.

När kommandot az iot ops secretsync enable skapar en federerad identitetslegitimation (FIC) på den användar-tilldelade hanterade identitet som Azure IoT Operations använder för att komma åt Azure Key Vault, sätter det FIC-utfärdarens URL till klustrets OIDC-utfärdar-URL. I vissa distributioner innehåller denna URL ett snedstreck ('/') som det klusterutgivna tjänstekontotokens iss (utfärdaren) utelämnar.

Eftersom problemet påverkar tokenutbytet under hemlig hämtning, uppstår misslyckandet vanligtvis inte när du kör az iot ops secretsync enable. Istället dyker den upp senare när Azure IoT Operations försöker få tillgång till en hemlighet, vilket kan göra grundorsaken svår att identifiera.

Lösning: Kontrollera att utfärdarens URL konfigurerad på den federerade identitetslegitimationen inte slutar med ett snedstreck. Om så är fallet uppdaterar du autentiseringsuppgiften för federerad identitet så att det avslutande snedstrecket tas bort.

Du kan använda Azure CLI-az identity federated-credential-kommandona för att visa och, vid behov, uppdatera utfärdarvärdet för den federerade identitetsautentiseringsuppgiften, till exempel:

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>

Som bästa praxis bör du utföra denna validering under installationen efter att du kört kommandot az iot ops secretsync enable för att undvika potentiellt svårdiagnostiserade autentiseringsfel senare.