Azure IoT Operationsに関する既知の問題

この記事では、Azure IoT Operationsを使用するときに発生する可能性がある現在の既知の問題の一覧を示します。このガイダンスは、これらの問題を特定するのに役立ち、使用可能な場合は回避策を提供します。

一般的なトラブルシューティングのガイダンスについては、トラブルシューティング Azure IoT Operationsを参照してください。

デプロイとアップグレードの問題

このセクションでは、Azure IoT Operationsのデプロイとアップグレードに関する現在の既知の問題を示します。

Azure IoT Operations 2603 へのアップグレードはサイレントモードで失敗する可能性があります

ログ署名: N/A

az iot ops upgrade を実行して Azure IoT Operations 2603 にアップグレードすると、アップグレードがクラスターに接続できない可能性があります。その後、次の現象が発生します。

AzAzure IoT Operations 拡張機能上の provisioningState: Failed。
クラスター上のすべてのワークロードは正常なままです (アップグレードアクティビティは発生しません)。
az iot ops upgrade は、それ以降の試行でアップグレードするものが報告されない場合があります。

根本原因

アップグレード中に、microsoft.extensiondiagnostics などの依存システム拡張機能で一時的な Helm タイムアウトが発生すると、Azure Resource Manager がそれを Failed としてマークします。拡張機能が最終的にクラスター上で成功した場合でも、クラウド側の状態は [失敗] のままです。これにより、依存関係チェーンがブロックされます。Azure Resource Manager更新されたAzure IoT Operationsまたはシークレットストア拡張機能の構成がクラスターの構成エージェントに配信されることはありません。症状は次のとおりです。

構成エージェント PostStatus が返す 400: "Configuration spec has been modified"
getPendingConfigs 空の結果を返します
拡張機能マネージャーが Helm のアップグレード手順を受け取らない

対処法

回避策は、Azure IoT Operations 拡張機能とシークレットストア拡張機能の両方で、No-op 更新を実施し、Azure Resource Manager に拡張機能の仕様を強制的に再送信させてから、アップグレードを再試行することです。

az k8s-extension update --name <aio-extension-name> \
    --cluster-name <cluster-name> \
    --resource-group <resource-group> \
    --cluster-type connectedClusters \
    --configuration-settings AgentOperationTimeoutInMinutes=120

az k8s-extension update --name azure-secret-store \
    --cluster-name <cluster-name> \
    --resource-group <resource-group> \
    --cluster-type connectedClusters \
    --configuration-settings AgentOperationTimeoutInMinutes=120

az iot ops upgrade

ランダムなサフィックス (azure-iot-operations-cym7h など) を含むAzure IoT Operations拡張機能名を識別するには、次を実行して特定の拡張機能名を見つけます。

az k8s-extension list \
    --cluster-name <cluster-name> \
    --resource-group <resource-group> \
    --cluster-type connectedClusters \
    --query "[?extensionType=='microsoft.iotoperations'].name" -o tsv

Important

アップグレードが完了したら、 AgentOperationTimeoutInMinutes を 5 分などの小さい値にリセットして、他の操作が失敗した場合に将来の操作で長い待機時間を回避します。

Azure デバイスレジストリの問題

このセクションでは、Azure デバイスレジストリの現在の既知の問題の一覧を示します。

ADR 資産リソースが同期されない

問題 ID: 1235

ログ署名: N/A

Azure古い API バージョンで作成された場合、Device Registry 資産リソースは同期されません。

MQTT ブローカーの問題

このセクションでは、MQTT ブローカーの現在の既知の問題の一覧を示します。

MQTT ブローカーリソースがAzure ポータルに表示されない

問題 ID: 4257

ログ署名: N/A

Kubernetes を使用してクラスターで作成された MQTT ブローカーリソースは、Azure ポータルには表示されません。この結果は、kubernetes を使用したAzure IoT Operations コンポーネントの管理はデバッグとテストのみを目的としており、エッジからクラウドへのリソースの同期は現在サポートされていないためです。

現時点では、この問題の回避策はありません。

コネクタの一般的な問題

このセクションでは、すべてのコネクタに影響する現在の既知の問題の一覧を示します。

コネクタは、Azure Key Vaultでデバイス資格情報の更新プログラムを検出しない

問題 ID: 6514

N/A

Azure Key Vaultに格納されているデバイス資格情報が更新されると、コネクタは通知を受け取りません。その結果、コネクタは再起動されるまで古い資格情報を引き続き使用します。

回避策: コネクタを再起動して、Azure Key Vaultから更新された資格情報を取得するように強制します。

Akri コネクタの場合、レジストリエンドポイントでサポートされている認証の種類は次のみです。 `artifact pull secrets`

問題 ID: 4570

ログ署名: N/A

コネクタテンプレートでレジストリエンドポイント参照を指定すると、複数の認証方法がサポートされます。 Akri コネクタでは、 artifact pull secrets 認証のみがサポートされます。

Akri コネクタがレジストリエンドポイントリソースで動作しない

問題 ID: 7710

バージョン 1.2.154 (2512) 以降で修正されました

ログ署名:

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

bicep を使用して RegistryEndpoint リソースを作成し、 ConnectorTemplate リソースで参照すると、Akri オペレーターが ConnectorTemplate を調整しようとすると、前に示したエラーで失敗します。

回避策: Akri コネクタで RegistryEndpoint リソースを使用しないでください。代わりに、ContainerRegistry リソースのConnectorTemplate設定でレジストリ情報を指定します。

Azure IoT Operations インスタンスを更新または削除するときの Akri エラー

問題 ID: 9347

バージョン 1.2.154 (2512) 以降で修正されました

ユーザーは、Azure IoT Operationsのインスタンスを削除またはアップグレードするとき、または Connector や ConnectorTemplates インスタンスなどの Akri リソースに対して CRUD 操作を実行するときに、期限切れの Webhook 証明書に関するエラーが発生する可能性があります。

回避策: kubectl delete pod -n azure-iot-operations aio-akri-webhook-0 --ignore-not-found 実行して webhook ポッドを削除して再起動し、ポッドが新しい証明書を取得できるようにします。

OPC UA のコネクタに関する問題

このセクションでは、OPC UA のコネクタに関する現在の既知の問題の一覧を示します。

イベント名に特殊文字を使用できない

問題 ID: 1532

バージョン 1.3.36 (2603) 以降で修正されました

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

イベント名に #、 %、 &などの特殊文字が含まれている場合、スキーマの生成は失敗します。スキーマ生成の問題を防ぐために、イベント名でこれらの文字を使用しないでください。

メディア用コネクタと ONVIF 用コネクタの問題

このセクションでは、メディア用コネクタと ONVIF 用コネクタに関する現在の既知の問題の一覧を示します。

シークレット同期の競合

問題 ID: 0606

ログ署名: N/A

シークレット同期を使用する場合は、シークレット名がグローバルに一意になるようにします。同じ名前のローカルシークレットが存在する場合、コネクタは目的のシークレットの取得に失敗する可能性があります。

ONVIF 資産イベントの送信先は、グループまたは資産レベルでのみ構成できます

問題 ID: 9545

バージョン 1.2.154 (2512) 以降で修正されました

ログ署名は次のようになります。

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

現在、ONVIF 資産イベントの送信先は、イベントグループまたは資産レベルでのみ認識されます。個々のイベントレベルで宛先を構成すると、例のようなログエントリが作成され、MQTT ブローカーにイベントデータは発行されません。

回避策として、個々のイベントレベルではなく、イベントグループまたは資産レベルでイベントの送信先を構成します。たとえば、イベントグループレベルで 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

データフローの問題

このセクションでは、データフローに関する現在の既知の問題の一覧を示します。

データフローリソースが操作エクスペリエンス Web UI に表示されない

問題 ID: 8724

ログ署名: N/A

Kubernetes を使用してクラスターで作成されたデータフローカスタムリソースは、操作エクスペリエンス Web UI には表示されません。この結果は、kubernetes を使用したAzure IoT Operations コンポーネントの管理はデバッグとテストのみを目的としており、エッジからクラウドへのリソースの同期は現在サポートされていないためです。

現時点では、この問題の回避策はありません。

データフロープロファイルは、70 個のデータフローを超えることはできません

問題 ID: 1028

ログ署名:

exec /bin/main: argument list too long

1 つのデータフロープロファイルに対して 70 を超えるデータフローを作成した場合、デプロイはエラー exec /bin/main: argument list too long で失敗します。

この問題を回避するには、複数のデータフロープロファイルを作成し、それらの間でデータフローを分散します。プロファイルあたり 70 個のデータフローを超えないでください。

データフローグラフでは、特定のエンドポイントの種類のみがサポートされます

問題 ID: 5693

ログ署名: N/A

データフローグラフ (WASM) では現在、MQTT、Kafka、OpenTelemetry (OTel) データフローエンドポイントのみがサポートされています。 OpenTelemetry エンドポイントは、データフローグラフの宛先としてのみ使用できます。データフローグラフでは、Data Lake、Microsoft Fabric OneLake、Azure Data Explorer、ローカルストレージなどの他のエンドポイントの種類はサポートされていません。

この問題を回避するには、サポートされているエンドポイントの種類のいずれかを使用します。

MQTT ブローカーを使用した双方向メッセージング用の MQTT エンドポイント
Kafka エンドポイント Azure Event Hubsを含む Kafka ブローカーとの双方向メッセージング用
監視プラットフォームにメトリックとログを送信するための OpenTelemetry エンドポイント (宛先のみ)

データフローグラフの詳細については、データフローグラフでの WebAssembly (WASM) の使用に関するページを参照してください。

チェーンされたグラフシナリオで同じグラフ定義を複数回使用できない

問題 ID: 1352

バージョン 1.3.36 (2603) 以降で修正されました

構成の送信に失敗しました

1 つのデータフローグラフの出力を別のデータフローグラフへの入力として使用して、チェーングラフシナリオを作成します。ただし、このシナリオで同じグラフ定義を複数回使用しようとすると、現在は想定どおりに機能しません。たとえば、次のコードは、graph-passthrough:1.3.6とgraph-1の両方に同じグラフ定義 (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'}
      }
  ]

このエラーを解決するには、毎回異なる名前またはタグを使用して、必要な回数ずつグラフ定義を ACR にプッシュします。たとえば、説明したシナリオでは、グラフ定義を別の名前または別のタグ ( graph-passthrough-one:1.3.6 や graph-passthrough-two:1.3.6など) で 2 回プッシュする必要があります。

ブローカーリスナーの問題

このセクションでは、ブローカーリスナーの現在の既知の問題を示します。

Azureポータルでブローカー認証の取得に失敗しました。

問題 ID: 3072

ログ署名: Azure ポータルメッセージ Fetch broker authentications: Failed to fetch broker authentications

Azure ポータルでブローカーリスナーを構成し、[認証] ドロップダウンで値を選択すると、ポータルはブローカー認証の一覧をフェッチしようとします。ポータルにエラーメッセージ Fetch broker authentications: Failed to fetch broker authenticationsが表示されます。

この問題を回避するには、2603 リリースにアップグレードします。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-04-17

Azure IoT Operationsに関する既知の問題

デプロイとアップグレードの問題

Azure IoT Operations 2603 へのアップグレードはサイレント モードで失敗する可能性があります

根本原因

対処法

Azure デバイス レジストリの問題

ADR 資産リソースが同期されない

MQTT ブローカーの問題

MQTT ブローカー リソースがAzure ポータルに表示されない

コネクタの一般的な問題

コネクタは、Azure Key Vaultでデバイス資格情報の更新プログラムを検出しない

Akri コネクタの場合、レジストリ エンドポイントでサポートされている認証の種類は次のみです。 artifact pull secrets

Akri コネクタがレジストリ エンドポイント リソースで動作しない

Azure IoT Operations インスタンスを更新または削除するときの Akri エラー

OPC UA のコネクタに関する問題

イベント名に特殊文字を使用できない

メディア用コネクタと ONVIF 用コネクタの問題

シークレット同期の競合

ONVIF 資産イベントの送信先は、グループまたは資産レベルでのみ構成できます

データ フローの問題

データ フロー リソースが操作エクスペリエンス Web UI に表示されない

データ フロー プロファイルは、70 個のデータ フローを超えることはできません

データ フロー グラフでは、特定のエンドポイントの種類のみがサポートされます

チェーンされたグラフ シナリオで同じグラフ定義を複数回使用できない

ブローカー リスナーの問題

Azureポータルでブローカー認証の取得に失敗しました。

フィードバック

その他のリソース

Azure IoT Operations 2603 へのアップグレードはサイレントモードで失敗する可能性があります

Azure デバイスレジストリの問題

MQTT ブローカーリソースがAzure ポータルに表示されない

Akri コネクタの場合、レジストリエンドポイントでサポートされている認証の種類は次のみです。 `artifact pull secrets`

Akri コネクタがレジストリエンドポイントリソースで動作しない

データフローの問題

データフローリソースが操作エクスペリエンス Web UI に表示されない

データフロープロファイルは、70 個のデータフローを超えることはできません

データフローグラフでは、特定のエンドポイントの種類のみがサポートされます

チェーンされたグラフシナリオで同じグラフ定義を複数回使用できない

ブローカーリスナーの問題