Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
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.