azure-messaging
Azure Messaging SDKの問題をトラブルシューティング
このスキルは、Python、Java、JavaScript、.NET SDK全体での接続障害、認証エラー、メッセージ処理の問題、設定に関する質問を含むAzure Event HubsおよびService Bus SDKの問題を診断および修正するのに役立ちます。
スキルZIPをダウンロード
Claudeでアップロード
設定 → 機能 → スキル → スキルをアップロードへ移動
オンにして利用開始
テストする
「azure-messaging」を使用しています。 EventHubsException: The connection was closed unexpectedly when receiving events
期待される結果:
このエラーは通常、EventProcessorClientが破棄されたか、AMQP接続が失われたことを示します。一般的な原因:1) イベントハンドラーでの未処理の例外 - すべての例外がキャッチされていることを確認してください。2) プロセスクラッシュ - プロセッサーを安定した環境でホストしてください。3) ネットワーク中断 - リトライロジックを実装してください。適切なイベントハンドラーの実装と接続回復パターンについては、ドキュメントを確認してください。
「azure-messaging」を使用しています。 Service Bus message lock lost immediately after processing
期待される結果:
メッセージロックの喪失は以下の場合に発生する可能性があります:1) 非同期処理が完了する前にメッセージを完了している - awaitを使用してください。2) ハンドラーが未処理の例外をスローしている。3) ロック期間が処理時間に対して短すぎる。解決策:QueueDescription.LockDurationでロック期間を延長し、ハンドラーにtry-catchを実装し、明示的なcomplete/abandonを伴うPeekLockモードの使用を検討してください。
セキュリティ監査
安全This is a Microsoft-official troubleshooting reference skill containing only documentation and example commands for debugging Azure Event Hubs and Service Bus SDK issues. All static findings are false positives: code fences (backticks) are markdown examples, URLs point to official Microsoft documentation, and diagnostic commands are standard troubleshooting tools. No executable code or malicious patterns detected.
品質スコア
作れるもの
Event Hub接続障害を修正
アプリケーションからAzure Event Hubsに接続する際に接続タイムアウトまたは認証エラーが発生している開発者
Service Busメッセージ処理の問題を解決
Azure Service Busでメッセージロック喪失エラー、デッドレターキューの問題、またはセッションハンドリングの問題に対処しているエンジニア
Event Processorを本番用に設定
適切なチェックポイントとリトライ設定で高スループットのEvent Hubコンシューマーアプリケーションを最適化しているチーム
これらのプロンプトを試す
Azure Event Hubsを使用中にこのエラーが発生しています:[ERROR_MESSAGE]。このエラーの意味と修正方法を教えてください。
Service Busクライアントが不正アクセスで失敗しています。[LANGUAGE] SDKで[AUTH_METHOD]を使用しています。設定を確認して修正案を提案してください。
Azureメッセージングクライアントが接続できません。エラーは[ERROR]です。ファイアウォールとネットワーク設定を含む接続の問題をトラブルシューティングしてください。
Event Hubコンシューマーを高スループット用に最適化したいです。現在の設定:[DESCRIBE_CURRENT_CONFIG]。リトライ、プリフェッチ、チェックポイント設定のチューニングを手伝ってください。
ベストプラクティス
- EventHubClientをシングルトンとして扱う - 各操作で新しいクライアントを作成すると、ソケット枯渇とパフォーマンスの問題が発生します
- SDKのリトライオプションを使用して適切なリトライポリシーを設定し、一時的な障害を適切に処理する
- debug/verboseレベルでSDKロギングを有効にし、トラブルシューティング用の詳細な診断情報を取得する
回避
- メッセージや操作ごとに新しいクライアントインスタンスを作成しない - アプリケーション全体で同じクライアントを再利用する
- 特定の要件がない限りリトライポリシーを無効にしない - 一時的な障害はクラウドメッセージングでは一般的です
- 例外タイプを無視しない - 異なる失敗理由には異なる処理戦略が必要です
よくある質問
このスキルはどの言語をサポートしていますか?
このスキルはEvent HubsまたはService Busリソースを作成しますか?
デバッグ用のverboseロギングを有効にするにはどうすればよいですか?
クォータ超過エラーが発生するのはなぜですか?
WebSocket接続を設定するにはどうすればよいですか?
チェックポイントとは何ですか?またどのように設定しますか?
開発者の詳細
作成者
microsoftライセンス
MIT
リポジトリ
https://github.com/microsoft/github-copilot-for-azure/tree/main/plugin/skills/azure-messaging/参照
main