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

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

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

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

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

ADR 名前空間資産の正常性状態リソースがエッジからクラウドに同期しない

問題 ID: 1235

ログ署名: N/A

Azure Device Registry 名前空間アセットの healthstate リソースは、2026-04-01 より前の API バージョンで作成された場合、クラウドに同期されません。このエラーは、必要な Kubernetes リソース注釈がないために発生します。

回避策: arc プロキシを使用して Kubernetes クラスターに接続し、使用しているシェル (PowerShell または bash) の修復スクリプトを実行します。スクリプトには、古い名前空間資産がすべて一覧表示され、不足している注釈を追加する前に確認が要求されます。

MQTT ブローカーの問題

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

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

問題 ID: 4257

ログ署名: N/A

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

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

コネクタの一般的な問題

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

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

問題 ID: 6514

N/A

リリース 2605 以降で修正済み

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 を実行してウェブフックポッドを削除し再起動し、ポッドが新しい証明書を取得できるようにします。

何も指定されていない場合、デバイスの受信エンドポイントで認証が強制されない

問題 ID: 7337

ログ署名: N/A

Azure デバイスレジストリデバイスリソーススキーマには、受信エンドポイントの既定の認証方法として証明書ベース (X.509) 認証が一覧表示されます。ただし、認証プロパティ自体は null 許容であるため、認証方法を指定せずにデバイス受信エンドポイントを作成できます。

認証を省略すると、暗黙的な既定の X.509 証明書は実行時に適用されません。デバイスの受信エンドポイントは、認証が適用されていない状態で作成されます。

Recommendations:

認証されたプロトコルを介してデバイスの受信エンドポイントと常に通信します。
すべての受信エンドポイントの認証プロパティで、証明書ベースの認証、またはサポートされている別の認証方法を明示的に構成します。スキーマの既定値に依存しないでください。暗黙的には適用されません。

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!

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

OPCコネクタテンプレートが欠落しています

発行番号:1330

ログ署名: N/A

Azure IoT Operations インスタンス展開はデフォルトで OPC ConnectorTemplate をインストールするべきです。デプロイ後、コネクターテンプレートはAzureポータルから欠落し、ConnectorTemplateリソースもクラスタに存在しません。

メディア用コネクタと 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

MQTT 用コネクタの問題

更新中の MQTT コネクタテンプレートのバージョンの不一致

問題 ID: 1533

ログ署名: N/A

リリース2606以降で修正済み

バージョン 2605 に更新すると、既存の MQTT コネクタテンプレートに、一致しないメタデータバージョンがポータルに表示されることがあります。解決するには、コネクタテンプレートを削除して再作成します。または、Azure CLIを使用してコネクタを更新します。

MQTT コネクタがプライベート IP アドレスを持つ外部 MQTT ブローカーに接続できない

問題 ID: 7791

ログ署名: N/A

リリース2607以降で修正

リリース2605以降、MQTTコネクタはプライベートIPアドレスを使用する外部MQTTブローカーに接続できません。

データフローの問題

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

Operations Experience Web UIは、Azure Container Registry(ACR)および mcr.microsoft.com から得られたデータフローグラフのアーティファクトのみを表示します

発行番号:8895

ログ署名: N/A

たとえGHCRのような非ACRコンテナレジストリ向けにコンテナレジストリエンドポイントを設定しても:

非ACRレジストリのデータフローグラフのアーティファクトはOperations ExperienceのWebUIには表示されないため、それらを使うデータフローグラフを作成することはできません。
非ACRレジストリの要素を含むOperations Experience Web UIのデータフローグラフリストから選択すると、次のようなエラーが発生します。 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.

回避策:選択肢は2つあります:

運用体験UIを使わない場合は、Azure CLIを使ってJSONやBicepファイルで定義された非ACRレジストリからのアーティファクトを含むデータフローグラフに対してCRUD操作を行います。
Operations Experience Web UIを使いたい場合は、非ACRレジストリからデータフローのアーティファクトやグラフをACRレジストリにインポートしてください。詳しくは「レジストリへのプッシュモジュール」をご覧ください。

Kubernetesで作成されたデータフローリソースは、オペレーションエクスペリエンスのウェブ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: 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 回プッシュする必要があります。

連邦アイデンティティの問題

このセクションでは、連邦アイデンティティに関する現在の既知の問題点を一覧にしています。

連合ID認証発行者の不一致は秘密同期認証失敗を引き起こすことがあります

発行番号:1190

バージョン2607以降で修正

ログ署名:類似 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 で、Azure Key Vault からシークレットを取得する際に 401 Unauthorized エラーが発生する。

根本原因:このエラーは、Federated ID認証発行者のURLがKubernetesサービスアカウントトークン内の発行者(ISS)の主張と一致しないためです。

az iot ops secretsync enableコマンドがユーザー割り当ての管理ID上でフェデレーテッドID(FIC)を作成すると、Azure IoT OperationsがAzure Key Vaultアクセスするために使うもので、FIC発行者のURLをクラスターのOIDC発行者URLに設定します。一部のデプロイでは、この URL には末尾のスラッシュ（'/'）が含まれますが、クラスタによって発行されたサービスアカウントトークンの iss（発行者）クレームではそれが省略されています。

この問題は秘密取得中のトークン交換に影響を与えるため、通常は az iot ops secretsync enableを実行しても失敗は起こりません。代わりに、Azure IoT Operationsが秘密にアクセスしようとした際に問題が浮上し、根本原因の特定が困難になることがあります。

回避策:Federated ID認証情報に設定されている発行者のURLがスラッシュで終わっていないか確認してください。もしそうなったら、フェデレーテッドID認証情報を更新して後尾のスラッシュを削除してください。

Azure CLI az identity federated-credentialsコマンドを使って、Federated Identity Credential発行者の値を表示し、必要に応じて更新できます。例えば:

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>

ベストプラクティスとして、 az iot ops secretsync enable コマンドを実行した後にセットアップ時にこの検証を行い、後で診断が難しい認証失敗を回避できます。

フィードバック

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

Last updated on 2026-08-21

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

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

ADR 名前空間資産の正常性状態リソースがエッジからクラウドに同期しない

MQTT ブローカーの問題

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

コネクタの一般的な問題

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

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

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

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

何も指定されていない場合、デバイスの受信エンドポイントで認証が強制されない

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

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

OPCコネクタテンプレートが欠落しています

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

シークレット同期の競合

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

MQTT 用コネクタの問題

更新中の MQTT コネクタ テンプレートのバージョンの不一致

MQTT コネクタがプライベート IP アドレスを持つ外部 MQTT ブローカーに接続できない

データ フローの問題

Operations Experience Web UIは、Azure Container Registry(ACR)および mcr.microsoft.com から得られたデータフローグラフのアーティファクトのみを表示します

Kubernetesで作成されたデータフローリソースは、オペレーションエクスペリエンスのウェブUIには表示されません

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

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

連邦アイデンティティの問題

連合ID認証発行者の不一致は秘密同期認証失敗を引き起こすことがあります

フィードバック

その他のリソース

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

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

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

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

更新中の MQTT コネクタテンプレートのバージョンの不一致

データフローの問題

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

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