Problemi noti per Operazioni di Azure IoT

Questo articolo elenca i problemi noti correnti che possono verificarsi quando si usa Operazioni di Azure IoT. Le indicazioni consentono di identificare questi problemi e di fornire soluzioni alternative, se disponibili.

Per indicazioni generali sulla risoluzione dei problemi, vedere Troubleshoot Operazioni di Azure IoT.

Problemi del Registro dei dispositivi di Azure

Questa sezione elenca i problemi noti correnti per il registro dei dispositivi di Azure.

Le risorse dello stato di integrità degli asset nel namespace ADR non si sincronizzano da edge a cloud.

ID problema: 1235

Firma del log: N/A

Le risorse dello stato di integrità degli asset nel namespace del Registro dei dispositivi di Azure non vengono sincronizzate con il cloud se sono state create con una versione API precedente al 2026-04-01. Questo errore si verifica perché manca un'annotazione della risorsa Kubernetes necessaria.

Soluzione alternativa: usare il proxy arc per connettersi al cluster Kubernetes e quindi eseguire lo script remediation per la shell in uso (PowerShell o bash). Gli script elencano tutti gli asset dello spazio dei nomi obsoleti e richiedono la conferma prima di aggiungere le annotazioni mancanti.

Problemi del broker MQTT

Questa sezione elenca i problemi noti correnti per il broker MQTT.

Le risorse broker MQTT non sono visibili nel portale di Azure

ID problema: 4257

Firma del log: N/A

Le risorse broker MQTT create nel cluster con Kubernetes non sono visibili nel portale di Azure. Questo risultato è previsto perché la gestione dei componenti Operazioni di Azure IoT con Kubernetes è destinata solo per il debug e i test e sincronizzare le risorse dal perimetro al cloud non è attualmente supportato.

Attualmente non è disponibile alcuna soluzione alternativa per questo problema.

Problemi generali del connettore

Questa sezione elenca i problemi noti correnti che interessano tutti i connettori.

Il connettore non rileva gli aggiornamenti delle credenziali del dispositivo in Azure Key Vault

ID problema: 6514

N/A

Correzione nella versione 2605 e successive

Il connettore non riceve una notifica quando le credenziali del dispositivo archiviate in Azure Key Vault vengono aggiornate. Di conseguenza, il connettore continua a usare le credenziali precedenti finché non viene riavviato.

Soluzione alternativa: riavviare il connettore per forzare il recupero delle credenziali aggiornate da Azure Key Vault.

Per i connettori Akri, l'unico tipo di autenticazione supportato per gli endpoint del Registro di sistema è artifact pull secrets

ID problema: 4570

Firma del log: N/A

Quando si specifica il riferimento all'endpoint del Registro di sistema in un modello di connettore, sono disponibili più metodi di autenticazione supportati. I connettori Akri supportano solo l'autenticazione artifact pull secrets.

I connettori Akri non funzionano con le risorse dell'endpoint del Registro di sistema

ID problema: 7710

Correzione nella versione 1.2.154 (2512) e successive

Firma del log:

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

Se si crea una risorsa RegistryEndpoint con Bicep e vi si fa riferimento nella risorsa ConnectorTemplate, l'operatore Akri non riesce a completare l'operazione quando tenta di riconciliare ConnectorTemplate, restituendo l'errore mostrato in precedenza.

Soluzione alternativa: non usare le RegistryEndpoint risorse con i connettori Akri. Specificare invece le informazioni del registro nelle ContainerRegistry impostazioni della ConnectorTemplate risorsa.

Errore di Akri durante l'aggiornamento o l'eliminazione di un'istanza di Operazioni di Azure IoT

ID problema: 9347

Correzione nella versione 1.2.154 (2512) e successive

Gli utenti possono riscontrare un errore relativo ai certificati webhook scaduti con Akri durante l'eliminazione o l'aggiornamento di istanze di Operazioni di Azure IoT o l'esecuzione di operazioni CRUD su risorse Akri, ad esempio Connector e ConnectorTemplates.

Soluzione alternativa: Esegui kubectl delete pod -n azure-iot-operations aio-akri-webhook-0 --ignore-not-found per eliminare e riavviare i pod webhook, in modo che il pod rilevi il nuovo certificato.

Gli endpoint di input del dispositivo non impongono l'autenticazione quando non ne viene specificata alcuna

ID problema: 7337

Firma del log: N/A

Lo schema delle risorse del dispositivo del registro dispositivi Azure elenca l'autenticazione basata su certificati (X.509) come metodo di autenticazione predefinito per un endpoint in ingresso. Tuttavia, la proprietà di autenticazione stessa è nullable, quindi è possibile creare un endpoint in ingresso del dispositivo senza specificare alcun metodo di autenticazione.

Quando l'autenticazione viene omessa, l'impostazione predefinita implicita dei certificati X.509 non viene applicata in fase di esecuzione. L'endpoint in ingresso del dispositivo viene creato senza autenticazione applicata.

Raccomandazioni:

• Comunicare sempre con gli endpoint in ingresso del dispositivo tramite un protocollo autenticato.
• Configurare in modo esplicito l'autenticazione basata su certificati o un altro metodo di autenticazione supportato nella proprietà di autenticazione di ogni endpoint in ingresso. Non fare affidamento sul valore predefinito dello schema: non viene applicato automaticamente.

Problemi del connettore per OPC UA

Questa sezione elenca i problemi noti correnti per il connettore per OPC UA.

Non è possibile usare caratteri speciali nei nomi degli eventi

ID problema: 1532

Correzione nella versione 1.3.36 (2603) e successive

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

La generazione dello schema ha esito negativo se i nomi degli eventi contengono caratteri speciali, ad #esempio , %o &. Evitare di usare questi caratteri nei nomi degli eventi per evitare problemi di generazione dello schema.

Mancante il modello del connettore OPC

ID del problema: 1330

Firma del log: N/A

La distribuzione dell'istanza Operazioni di Azure IoT dovrebbe installare di default un OPC ConnectorTemplate. Dopo il deployment, il template del connettore manca dal portale Azure e la ConnectorTemplate risorsa non è presente nel cluster.

Connettore per supporti e connettori per problemi ONVIF

Questa sezione elenca i problemi noti attuali per il connettore per i contenuti multimediali e il connettore per ONVIF.

Conflitto di sincronizzazione dei segreti

ID problema: 0606

Firma del log: N/A

Quando si usa la sincronizzazione dei segreti, assicurarsi che i nomi dei segreti siano univoci a livello globale. Se esiste un segreto locale con lo stesso nome, i connettori potrebbero non riuscire a recuperare il segreto previsto.

La destinazione evento dell'asset ONVIF può essere configurata solo a livello di gruppo o asset

ID problema: 9545

Correzione nella versione 1.2.154 (2512) e successive

Firma del log simile a:

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

Attualmente, le destinazioni degli eventi degli asset ONVIF vengono riconosciute solo a livello di gruppo di evento o di asset. La configurazione delle destinazioni a livello di singolo evento comporta voci di log simili all'esempio e nessun dato dell'evento viene pubblicato nel broker MQTT.

Soluzione alternativa: Configura la destinazione dell'evento a livello di gruppo evento o asset invece che a livello di singolo evento. Ad esempio, usa defaultEventsDestinations a livello di gruppo evento:

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

Problemi relativi al connettore MQTT

Incompatibilità di versione del modello del connettore MQTT durante l'aggiornamento

ID problema: 1533

Firma del log: N/A

Corretto nella versione 2606 e successiva

Quando si esegue l'aggiornamento alla versione 2605, i modelli di connettore MQTT esistenti potrebbero visualizzare versioni di metadati non corrispondenti nel portale. Per risolvere il problema, eliminare e ricreare il modello di connettore. In alternativa, usare il interfaccia della riga di comando di Azure per aggiornare il connettore.

Il connettore MQTT non può connettersi a broker MQTT esterni con indirizzi IP privati

ID problema: 7791

Firma del log: N/A

Corretto nella versione 2607 e successive

A partire dalla release 2605, il connettore MQTT non può connettersi a broker esterni MQTT che utilizzano indirizzi IP privati.

Problemi relativi ai flussi di dati

Questa sezione elenca i problemi noti correnti per i flussi di dati.

L'interfaccia web di Operations Experience mostra solo artefatti di grafici di flusso dati provenienti da Registro Azure Container (ACR) e mcr.microsoft.com

ID numero di prodotto: 8895

Firma del log: N/A

Anche se configuri un endpoint di registro container per un registro container non ACR, come GHCR:

• Gli artefatti dei grafici di flusso dati provenienti dal registro non-ACR non compaiono nell'interfaccia web di Operations Experience, quindi non puoi creare un grafo di flusso dati che li utilizzi.

• Selezionare un grafico di flusso dati dall'elenco dei flussi dati nell'interfaccia web dell'esperienza operativa che contiene elementi da un registro non ACR produce un errore simile a: 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.

Soluzione alternativa: Hai due opzioni:

• Se non hai bisogno di usare l'interfaccia di esperienza operativa, usa la interfaccia della riga di comando di Azure per eseguire operazioni CRUD su grafici di flusso dati definiti in file JSON o Bicep che contengono artefatti provenienti da registri non ACR.

• Se vuoi usare l'interfaccia web di operations experience, importa artefatti e grafi di flusso di dati da registri non ACR in un registro ACR. Per saperne di più, consulta Inviare moduli al registro.

Le risorse di flusso dati create con Kubernetes non sono visibili nell'interfaccia web dell'esperienza operativa

ID problema: 8724

Firma del log: N/A

Le risorse personalizzate del flusso di dati create nel cluster con Kubernetes non sono visibili nell'interfaccia utente Web dell'esperienza operativa. Questo risultato è previsto perché la gestione dei componenti Operazioni di Azure IoT con Kubernetes è destinata solo per il debug e i test e sincronizzare le risorse dal perimetro al cloud non è attualmente supportato.

Attualmente non è disponibile alcuna soluzione alternativa per questo problema.

Un profilo flusso di dati non può superare i 70 flussi di dati

ID problema: 1028

Firma del log:

exec /bin/main: argument list too long

Se si creano più di 70 flussi di dati per un singolo profilo del flusso di dati, le distribuzioni hanno esito negativo con l'errore exec /bin/main: argument list too long.

Per risolvere questo problema, creare più profili del flusso di dati e distribuire i flussi di dati tra di essi. Non superare i 70 flussi di dati per profilo.

Non è possibile usare più volte la stessa definizione del grafo in uno scenario a grafo concatenato

ID problema: 1352

Correzione nella versione 1.3.36 (2603) e successive

Impossibile inviare la configurazione

Si crea uno scenario a grafo concatenato usando l'output di un grafico del flusso di dati come input per un altro grafico del flusso di dati. Tuttavia, se si tenta di usare più volte la stessa definizione del grafo in questo scenario, attualmente non funziona come previsto. Ad esempio, il codice seguente ha esito negativo quando si usa la stessa definizione del grafo (graph-passthrough:1.3.6) sia per graph-1 che per 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'}
      }
  ]

Per risolvere questo errore, eseguire il push della definizione del grafo in Registro Azure Container tutte le volte necessarie, usando ogni volta uno scenario con un nome o un tag diverso. Nello scenario descritto, ad esempio, la definizione del grafo deve essere inserita due volte con un nome diverso o un tag diverso, ad esempio graph-passthrough-one:1.3.6 e graph-passthrough-two:1.3.6.

Questioni di identità federata

Questa sezione elenca le questioni attuali note per l'identità federata.

La mancata corrispondenza tra emittente di credenziali di identità federata può causare non riuscita dell'autenticazione a sincronizzazione segreta

ID problema: 1190

Corretto nella versione 2607 e successive

Firma del log: simile a 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.

Operazioni di Azure IoT incontra errori non autorizzati 401 quando si recuperano segreti da Azure Key Vault.

Causa radice: L'errore si verifica perché l'URL dell'emittente della credenziale di identità federata non corrisponde alla rivendicazione dell'emittente (iss) nel token dell'account di servizio Kubernetes.

Quando il az iot ops secretsync enable comando crea una credenziale di identità federata (FIC) sull'identità gestita assegnata dall'utente che Operazioni di Azure IoT utilizza per accedere ad Azure Key Vault, imposta l'URL dell'emittente FIC sull'URL OIDC del cluster. In alcune distribuzioni, questo URL include una barra finale ('/') che il claim iss (issuer) del token dell'account di assistenza emesso dal cluster omette.

Poiché il problema influisce sullo scambio di token durante il recupero segreto, il guasto di solito non si verifica quando esegui az iot ops secretsync enable. Invece, emerge più tardi quando Operazioni di Azure IoT tenta di accedere a un segreto, il che può rendere difficile identificare la causa principale.

Soluzione alternativa: verifica che l'URL dell'emittente configurato sulla credenziale di identità federata non termini con una barra. In tal caso, aggiornare le credenziali di identità federata per rimuovere la barra finale.

Puoi usare i comandi di interfaccia della riga di comando di Azure az identity federated-credential per visualizzare e, se necessario, aggiornare il valore dell'autorità emittente della credenziale di identità federata, ad esempio:

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>

Come buona pratica, esegui questa validazione durante l'installazione dopo aver eseguito il az iot ops secretsync enable comando per evitare eventuali fallimenti di autenticazione difficili da diagnosticare in seguito.