azure-messaging
Azure Event HubsやService BusのSDK利用時に発生する、接続エラー、認証問題、メッセージ処理の不具合、SDK設定に関するトラブルシューティングを行い、問題解決を支援するSkill。
📜 元の英語説明(参考)
Troubleshoot and resolve issues with Azure Messaging SDKs for Event Hubs and Service Bus. Covers connection failures, authentication errors, message processing issues, and SDK configuration problems. USE FOR: event hub SDK error, service bus SDK issue, messaging connection failure, AMQP error, event processor host issue, message lock lost, send timeout, receiver disconnected, SDK troubleshooting, azure messaging SDK, event hub consumer, service bus queue issue, topic subscription error, enable logging event hub, service bus logging, eventhub python, servicebus java, eventhub javascript, servicebus dotnet, event hub checkpoint, event hub not receiving messages, service bus dead letter DO NOT USE FOR: creating Event Hub or Service Bus resources (use azure-prepare), monitoring metrics (use azure-observability), cost analysis (use azure-cost-optimization)
🇯🇵 日本人クリエイター向け解説
Azure Event HubsやService BusのSDK利用時に発生する、接続エラー、認証問題、メッセージ処理の不具合、SDK設定に関するトラブルシューティングを行い、問題解決を支援するSkill。
※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。
下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o azure-messaging.zip https://jpskill.com/download/19668.zip && unzip -o azure-messaging.zip && rm azure-messaging.zip
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/19668.zip -OutFile "$d\azure-messaging.zip"; Expand-Archive "$d\azure-messaging.zip" -DestinationPath $d -Force; ri "$d\azure-messaging.zip"
完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。
💾 手動でダウンロードしたい(コマンドが難しい人向け)
- 1. 下の青いボタンを押して
azure-messaging.zipをダウンロード - 2. ZIPファイルをダブルクリックで解凍 →
azure-messagingフォルダができる - 3. そのフォルダを
C:\Users\あなたの名前\.claude\skills\(Win)または~/.claude/skills/(Mac)へ移動 - 4. Claude Code を再起動
⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。
🎯 このSkillでできること
下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。
📦 インストール方法 (3ステップ)
- 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
- 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
- 3. 展開してできたフォルダを、ホームフォルダの
.claude/skills/に置く- · macOS / Linux:
~/.claude/skills/ - · Windows:
%USERPROFILE%\.claude\skills\
- · macOS / Linux:
Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。
詳しい使い方ガイドを見る →- 最終更新
- 2026-05-18
- 取得日時
- 2026-05-18
- 同梱ファイル
- 10
📖 Skill本文(日本語訳)
※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。
Azure Messaging SDK のトラブルシューティング
クイックリファレンス
| プロパティ | 値 |
|---|---|
| サービス | Azure Event Hubs, Azure Service Bus |
| MCP ツール | mcp_azure_mcp_eventhubs, mcp_azure_mcp_servicebus |
| 最適用途 | SDK の接続、認証、メッセージ処理の問題の診断 |
このスキルを使用するタイミング
- SDK 接続の失敗、認証エラー、または AMQP リンクエラー
- メッセージロックの喪失、セッションロック、または送受信のタイムアウト
- イベントプロセッサまたはメッセージハンドラが処理を停止する
- 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 でトラブルシューティングドキュメントを検索します |
診断ワークフロー
- SDK とバージョンを特定する — ユーザーが使用している言語 SDK とバージョンを尋ねます
- リソースの状態を確認する —
mcp_azure_mcp_resourcehealthを使用して、名前空間が正常であることを確認します - エラーメッセージを確認する — 言語固有のトラブルシューティングガイドと照合します
- ドキュメントを調べる —
mcp_azure_mcp_documentationを使用して、Microsoft Learn でエラーまたはトピックを検索します - 構成を確認する — 接続文字列、エンティティ名、コンシューマグループを確認します
- 修正を推奨する — 見つかったドキュメントを引用して、修復を適用します
接続のトラブルシューティング
ポート、WebSocket フォールバック、IP ファイアウォール、プライベートエンドポイント、サービスタグについては、サービス トラブルシューティング ガイドを参照してください。
SDK トラブルシューティングガイド
リファレンス
最新のガイダンスについては、mcp_azure_mcp_documentation を使用して Microsoft Learn を検索してください。ネットワークおよびサービスレベルのドキュメントについては、サービス トラブルシューティング ガイドを参照してください。
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開
Azure Messaging SDK Troubleshooting
Quick Reference
| Property | Value |
|---|---|
| Services | Azure Event Hubs, Azure Service Bus |
| MCP Tools | mcp_azure_mcp_eventhubs, mcp_azure_mcp_servicebus |
| Best For | Diagnosing SDK connection, auth, and message processing issues |
When to Use This Skill
- SDK connection failures, auth errors, or AMQP link errors
- Message lock lost, session lock, or send/receive timeouts
- Event processor or message handler stops processing
- SDK configuration questions (retry, prefetch, batch size)
MCP Tools
| Tool | Command | Use |
|---|---|---|
mcp_azure_mcp_eventhubs |
Namespace/hub ops | List namespaces, hubs, consumer groups |
mcp_azure_mcp_servicebus |
Queue/topic ops | List namespaces, queues, topics, subscriptions |
mcp_azure_mcp_monitor |
logs_query |
Query diagnostic logs with KQL |
mcp_azure_mcp_resourcehealth |
get |
Check service health status |
mcp_azure_mcp_documentation |
Doc search | Search Microsoft Learn for troubleshooting docs |
Diagnosis Workflow
- Identify the SDK and version — Ask which language SDK and version the user is on
- Check resource health — Use
mcp_azure_mcp_resourcehealthto verify the namespace is healthy - Review the error message — Match against language-specific troubleshooting guide
- Look up documentation — Use
mcp_azure_mcp_documentationto search Microsoft Learn for the error or topic - Check configuration — Verify connection string, entity name, consumer group
- Recommend fix — Apply remediation, citing documentation found
Connectivity Troubleshooting
See Service Troubleshooting Guide for ports, WebSocket fallback, IP firewall, private endpoints, and service tags.
SDK Troubleshooting Guides
References
Use mcp_azure_mcp_documentation to search Microsoft Learn for latest guidance. See Service Troubleshooting Guide for network and service-level docs.
同梱ファイル
※ ZIPに含まれるファイル一覧。`SKILL.md` 本体に加え、参考資料・サンプル・スクリプトが入っている場合があります。
- 📄 SKILL.md (3,437 bytes)
- 📎 references/sdk/azure-eventhubs-dotnet.md (3,431 bytes)
- 📎 references/sdk/azure-eventhubs-java.md (3,156 bytes)
- 📎 references/sdk/azure-eventhubs-js.md (2,635 bytes)
- 📎 references/sdk/azure-eventhubs-py.md (3,426 bytes)
- 📎 references/sdk/azure-servicebus-dotnet.md (2,568 bytes)
- 📎 references/sdk/azure-servicebus-java.md (2,281 bytes)
- 📎 references/sdk/azure-servicebus-js.md (2,489 bytes)
- 📎 references/sdk/azure-servicebus-py.md (2,388 bytes)
- 📎 references/service-troubleshooting.md (4,208 bytes)