azure-messaging

Azure Messaging SDK のトラブルシューティング

クイックリファレンス

プロパティ	値
サービス	Azure Event Hubs、Azure Service Bus
MCP ツール	mcp_azure_mcp_eventhubs、mcp_azure_mcp_servicebus
最適な用途	SDK の接続、認証、メッセージ処理に関する問題の診断

このスキルを使用する場面

• SDK の接続失敗、認証エラー、AMQP リンクエラー
• アイドルタイムアウト、接続の非アクティブ化、切断後の再接続の遅延
• AMQP リンクのデタッチまたは detach-forced エラー
• メッセージロックの喪失、メッセージロックの期限切れ、ロック更新の失敗、バッチロックのタイムアウト
• セッションロックの喪失、セッションロックの期限切れ、セッションレシーバーのエラー
• イベントプロセッサまたはメッセージハンドラーによる処理の停止
• イベントの重複またはチェックポイントオフセットのリセット
• SDK の構成に関する質問（再試行、プリフェッチ、バッチサイズ、バッチ受信の動作）

MCP ツール

ツール	コマンド	用途
mcp_azure_mcp_eventhubs	Namespace/hub ops	名前空間、ハブ、コンシューマーグループの一覧表示
mcp_azure_mcp_servicebus	Queue/topic ops	名前空間、キュー、トピック、サブスクリプションの一覧表示
mcp_azure_mcp_monitor	logs_query	KQL を使用した診断ログのクエリ
mcp_azure_mcp_resourcehealth	get	サービスの正常性状態の確認
mcp_azure_mcp_documentation	Doc search	Microsoft Learn でトラブルシューティングのドキュメントを検索

診断ワークフロー

1. SDK とバージョンを特定する — プロンプトで SDK とバージョンの手がかりを確認します。記載がない場合は、診断を進め、必要に応じて後で確認します
2. リソースの正常性を確認する — mcp_azure_mcp_resourcehealth を使用して、名前空間が正常な状態であることを確認します
3. エラーメッセージを確認する — 言語固有のトラブルシューティングガイドと照合します
4. ドキュメントを検索する — mcp_azure_mcp_documentation を使用して、エラーまたはトピックを Microsoft Learn で検索します
5. 構成を確認する — 接続文字列、エンティティ名、コンシューマーグループを確認します
6. 修正を推奨する — 見つかったドキュメントを引用し、修正措置を適用します

トラブルシューティングガイド

接続、SDK、認証のトラブルシューティングガイドは、azure-diagnostics スキルの troubleshooting/messaging/ にあります。

参考資料

• mcp_azure_mcp_documentation を使用して、最新のガイダンスを Microsoft Learn で検索します。