azure-iot-operations について
azure-iot-operations は、Azure IoT Operations の導入を計画、開発、運用するエージェント向けスキルです。ローカルのクイックリファレンスとネットワーク経由のドキュメント取得を組み合わせ、MQTT、OPC UA、セキュリティ、データフロー、デプロイを扱います。
主な機能
- 01WASM、接続、ヘルス状態の問題診断
- 02デプロイトポロジ、容量、永続化の計画
- 03MQTT、OPC UA、データフローの構成
- 04セキュリティ、証明書、アクセス制御のガイダンス
- 05統合、コーディング、デプロイのパターン
活用シーン
- 01プライベート接続や MQTT 通信の問題診断
- 02エッジ導入のリソースと高可用性の計画
- 03データフローの構築とコネクターおよびセキュリティの構成
MCP 対応
ドキュメント取得には mcp_microsoftdocs の microsoft_docs_fetch ツールを優先して使用できます。代替手段として fetch_webpage も記載されています。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-iot-operationsインストール後、Claude Code で/azure-iot-operationsを入力して読み込まれたか確認します。
詳細
Azure IoT Operations スキル
このスキルでは、Azure IoT Operations に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、アーキテクチャと設計パターン、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイについて説明します。ローカルのクイックリファレンスコンテンツと、ドキュメントをリモートで取得する機能を組み合わせています。
このスキルの使用方法
IMPORTANT for Agent:関連するセクションを見つけるには、以下のカテゴリインデックスを使用してください。行の範囲が記載されているカテゴリ(例:
L35-L120)では、指定した行をread_fileで読み取ってください。ファイルへのリンクが記載されているカテゴリ(例:[security.md](security.md))では、リンク先のリファレンスファイルをread_fileで読み取ってください。
IMPORTANT for Agent:
metadata.generated_atが3か月以上前の場合は、リポジトリから最新バージョンを取得するようユーザーに提案してください。mcp_microsoftdocsツールを利用できない場合は、インストールをユーザーに提案してください:インストールガイド
このスキルでは、ドキュメントの取得にネットワークアクセスが必要です。
- 推奨:クエリ文字列
from=learn-agent-skillを指定してmcp_microsoftdocs:microsoft_docs_fetchを使用します。Markdown が返されます。 - 代替手段:クエリ文字列
from=learn-agent-skill&accept=text/markdownを指定してfetch_webpageを使用します。Markdown が返されます。
カテゴリインデックス
| カテゴリ | 行 | 説明 |
|---|---|---|
| トラブルシューティング | L37-L46 | Azure IoT Operations の問題の診断と修正:WASM モジュールのデバッグ、正常性理由コードの解釈、プライベート接続の問題の解決、既知の問題のトラブルシューティングに使用するツール。 |
| ベストプラクティス | L47-L54 | 本番環境に対応した Azure IoT Operations のガイダンス:MQTT ブローカーの HA 設計、エッジの永続状態ストレージ、MQTT 接続のテストとトラブルシューティング。 |
| 意思決定 | L55-L65 | Azure IoT Operations のアーキテクチャを計画し、選択するためのガイダンス:データフローとグラフ、デプロイのトポロジとサイズ設定、MQTT ブローカーの診断、バッファリングと永続化、OPC UA アセットの検出モード。 |
| アーキテクチャと設計パターン | L66-L71 | ISA-95 統合名前空間の概念を使用した Azure IoT アーキテクチャの設計、および安全でスケーラブルな IoT Operations のデプロイに向けた階層化・セグメント化ネットワークトポロジの計画。 |
| 制限とクォータ | L72-L78 | OPC UA セッションと HA の容量計画、リソース使用量の基本見積もり、Azure IoT Operations における MQTT ブローカーの機能、パケット、スループットの制限。 |
| セキュリティ | L79-L96 | Azure IoT Operations のセキュリティ保護:TLS と証明書、MQTT 認証と認可、OPC UA の信頼、プライベートネットワーク、RBAC/ABAC ロール、シークレット管理、イメージの真正性。 |
| 構成 | L97-L133 | ストレージ、分析、WASM、コネクタの設定など、IoT Operations のデータフロー、エンドポイント、変換、MQTT/OPC UA の機能、可観測性、リソース管理の構成。 |
| 統合とコーディングパターン | L134-L158 | Azure IoT Operations のデータフローを接続するためのパターンとコード:式、フィルター、ルーティング、スロットリング、ウィンドウ集計、WASM/Dapr/ONNX、状態ストア、スキーマ、コネクタ(MQTT/HTTP/メディア/SSE/Fabric)。 |
| デプロイ | L159-L172 | Arc 対応 Kubernetes 上での Azure IoT Operations のデプロイ、アップグレード、複製、削除。セキュリティ保護と本番環境向けのセットアップ、プライベートネットワークとレジストリ、Dapr MQTT コンポーネントを含みます。 |
トラブルシューティング
| トピック | URL |
|---|---|
| VS Code で Azure IoT WASM モジュールをデバッグする | https://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/howto-debug-wasm-modules |
| Azure IoT Operations のプライベート接続に関する問題をトラブルシューティングする | https://learn.microsoft.com/en-us/azure/iot-operations/manage-layered-network/howto-troubleshoot-private-connectivity |
| Azure IoT Operations の正常性理由コードを解釈する | https://learn.microsoft.com/en-us/azure/iot-operations/reference/health-status-reason-codes |
| Azure IoT Operations の既知の問題を診断する | https://learn.microsoft.com/en-us/azure/iot-operations/troubleshoot/known-issues |
| Azure IoT Operations のトラブルシューティングにツールを使用する | https://learn.microsoft.com/en-us/azure/iot-operations/troubleshoot/tips-tools |
| Azure IoT Operations の問題を診断して修正する | https://learn.microsoft.com/en-us/azure/iot-operations/troubleshoot/troubleshoot |
ベストプラクティス
| トピック | URL |
|---|---|
| Azure IoT Operations の本番環境デプロイガイドラインを適用する | https://learn.microsoft.com/en-us/azure/iot-operations/deploy-iot-ops/concept-production-guidelines |
| Azure IoT Operations MQTT ブローカーで高可用性のエッジアプリを設計する | https://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/overview-edge-apps |
| Azure IoT Operations の状態ストアを使用してエッジデータを永続化する | https://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/overview-state-store |
| Azure IoT Operations で MQTT ブローカーの接続をテストする | https://learn.microsoft.com/en-us/azure/iot-operations/manage-mqtt-broker/howto-test-connection |
意思決定
| トピック | URL |
|---|---|
| データフローとデータフローグラフから選択する | https://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/overview-dataflow-comparison |
| 本番規模の Azure IoT Operations デプロイを計画する | https://learn.microsoft.com/en-us/azure/iot-operations/deploy-iot-ops/concept-production-examples |
| Azure IoT Operations のデプロイトポロジとサイジングを計画する | https://learn.microsoft.com/en-us/azure/iot-operations/deployment-plan/deployment-planning |
| MQTT ブローカーの診断構成を計画する | https://learn.microsoft.com/en-us/azure/iot-operations/deployment-plan/deployment-planning-diagnostics |
| MQTT ブローカーのディスクベースのメッセージバッファリングを計画する | https://learn.microsoft.com/en-us/azure/iot-operations/deployment-plan/deployment-planning-disk-buffer |
| IoT Operations の MQTT ブローカーの永続化戦略を決定する | https://learn.microsoft.com/en-us/azure/iot-operations/deployment-plan/deployment-planning-persistence |
| Azure IoT で OPC UA アセット検出モードを選択する | https://learn.microsoft.com/en-us/azure/iot-operations/discover-manage-assets/concept-opc-ua-asset-discovery |
アーキテクチャと設計パターン
| トピック | URL |
|---|---|
| Azure IoT で ISA-95 統合名前空間を構築する | https://learn.microsoft.com/en-us/azure/iot-operations/discover-manage-assets/howto-build-unified-namespace |
| Azure IoT Operations デプロイ向けの階層型ネットワークを設計する | https://learn.microsoft.com/en-us/azure/iot-operations/manage-layered-network/concept-layered-network |
制限とクォータ
| トピック | URL |
|---|---|
| OPC UA セッション共有と高可用性の容量を計画する | https://learn.microsoft.com/en-us/azure/iot-operations/discover-manage-assets/howto-configure-opc-ua-sessions-high-availability |
| Azure IoT Operations のベースラインリソース使用量を計画する | https://learn.microsoft.com/en-us/azure/iot-operations/reference/concept-resource-profiles |
| Azure IoT Operations ブローカーの MQTT 機能とパケットの制限を確認する | https://learn.microsoft.com/en-us/azure/iot-operations/reference/mqtt-support |