Event Hubs メッセージングの例外 - .NET (レガシ)
このセクションでは、.NET Framework API によって生成される .NET 例外を示します。
重要
この記事に記載されている一部の例外は、従来の Event Hubs .NET ライブラリにのみ適用されます。 次に例を示します。Microsoft.ServiceBus.* 例外。
新しい .NET ライブラリによって発生する EventHubsException の詳細については、「EventHubsException - .NET」を参照してください。
2026 年 9 月 30 日に、Azure SDK ガイドラインに準拠していない Azure Service Bus SDK ライブラリ WindowsAzure.ServiceBus、Microsoft.Azure.ServiceBus、および com.microsoft.azure.servicebus は廃止されます。 SBMP プロトコルのサポートも終了するため、2026 年 9 月 30 日以降、このプロトコルを使用できなくなります。 重要なセキュリティ更新プログラムと強化された機能を提供する最新の Azure SDK ライブラリに、その日付より前に移行します。
以前のライブラリは 2026 年 9 月 30 日以降も引き続き使用できますが、Microsoft から公式のサポートと更新プログラムは提供されなくなります。 詳細については、サポート廃止のお知らせに関するページを参照してください。
例外のカテゴリ
Event Hubs の API .NET で生成される例外をカテゴリ別に分類し、修復のために実行できる関連するアクションと共に以下に示します。
ユーザー コードのエラー:
- System.ArgumentException
- System.InvalidOperationException
- System.OperationCanceledException
- System.Runtime.Serialization.SerializationException
一般的なアクション:処理を続行する前にコードの修正を試みます。
セットアップ/構成エラー:
- Microsoft.ServiceBus.Messaging.MessagingEntityNotFoundException
- Microsoft.Azure.EventHubs.MessagingEntityNotFoundException
- System.UnauthorizedAccessException
一般的なアクション:構成を確認し、必要に応じて変更します。
一時的な例外:
- Microsoft.ServiceBus.Messaging.MessagingException
- Microsoft.ServiceBus.Messaging.ServerBusyException
- Microsoft.Azure.EventHubs.ServerBusyException
- Microsoft.ServiceBus.Messaging.MessagingCommunicationException
一般的なアクション:操作を再試行するか、またはユーザーに通知します。
その他の例外:
- System.Transactions.TransactionException
- System.TimeoutException
- Microsoft.ServiceBus.Messaging.MessageLockLostException
- Microsoft.ServiceBus.Messaging.SessionLockLostException
一般的なアクション:例外の種類に固有です。次のセクションの表を参照してください。
例外の種類
次の表は、メッセージングの例外の種類および原因と実行できる推奨アクションを示したものです。
| 例外の種類 | 説明/原因/例 | 推奨アクション | 自動/即時再試行に関する注意 |
|---|---|---|---|
| TimeoutException | サーバーは、OperationTimeout によって制御される指定された時間内に、要求された操作に対して応答しませんでした。 サーバーで、要求された操作が完了した可能性があります。 この例外は、ネットワークや他のインフラストラクチャの遅延が原因で発生することがあります。 | システム状態の整合性をチェックして、必要な場合は再試行してください。 「TimeoutException」を参照してください。 |
再試行によって解決する場合があります。再試行ロジックをコードに追加してください。 |
| InvalidOperationException | 要求されたユーザー操作は、サーバーまたはサービス内で許可されていません。 詳細については、例外メッセージを参照してください。 たとえば、 Complete は、 ReceiveAndDelete モードでメッセージを受信した場合に、この例外を生成します。 | コードとドキュメントを確認します。 要求した操作が有効なことを確かめてください。 | 再試行によって解決することはありません。 |
| OperationCanceledException | 既に終了、中止、または破棄されたオブジェクトに対して操作を呼び出そうとしました。 まれに、アンビエント トランザクションが既に破棄されている場合があります。 | コードを確認し、破棄されたオブジェクトに対して操作を呼び出していないことを確認します。 | 再試行によって解決することはありません。 |
| UnauthorizedAccessException | TokenProvider オブジェクトはトークンを取得できませんでした。トークンが無効です。または、操作の実行に必要な要求がトークンに含まれていません。 | トークン プロバイダーが正しい値を使用して作成されていることを確認します。 Access Control Service の構成を確認します。 | 再試行によって解決する場合があります。再試行ロジックをコードに追加してください。 |
| ArgumentException ArgumentNullException ArgumentOutOfRangeException |
メソッドに指定された 1 つまたは複数の引数が無効です。 NamespaceManager または Create に指定された URI にパス セグメントが含まれています。 NamespaceManager または Create に指定された URI スキームが無効です。 プロパティ値が 32 KB を超えています。 | 呼び出し元のコードを確認し、引数が正しいことを確かめます。 | 再試行によって解決することはありません。 |
| Microsoft.ServiceBus.Messaging MessagingEntityNotFoundException Microsoft.Azure.EventHubs MessagingEntityNotFoundException |
操作に関連付けられているエンティティが存在しないか、削除されました。 | エンティティが存在することを確認します。 | 再試行によって解決することはありません。 |
| MessagingCommunicationException | クライアントから Event Hubs への接続を確立できません。 | 指定されたホスト名が正しく、ホストが到達可能なことを確認してください。 | 断続的な接続の問題がある場合は、再試行によって解決することがあります。 |
| Microsoft.ServiceBus.Messaging ServerBusyException Microsoft.Azure.EventHubs ServerBusyException |
この時点では、このサービスで要求を処理できません。 | クライアントは、しばらく待機してから操作をやり直すことができます。 「ServerBusyException」を参照してください。 |
クライアントは、一定の間隔をおいてから再試行することができます。 再試行の結果として別の例外が発生した場合は、その例外の再試行動作を確認します。 |
| MessagingException | 次の場合にスローされる可能性がある一般なメッセージング例外です。異なるエンティティの種類 (たとえば、トピック) に属する名前またはパスを使用して、QueueClient を作成しようとした場合。 1 MB を超えるメッセージを送信しようとした場合。 サーバーまたはサービスで要求の処理中にエラーが発生しました。 詳細については、例外メッセージを参照してください。 この例外は通常、一時的な例外です。 | コードを確認し、メッセージ本文にシリアル化可能なオブジェクトのみを使用していることを確かめます (または、カスタム シリアライザーを使用します)。 サポートされているプロパティ値の型をドキュメントで確認し、サポートされている型だけを使用します。 IsTransient プロパティを確認します。 それが trueである場合は、操作を再試行できます。 | 再試行動作は未定義であり、解決にならない場合もあります。 |
| MessagingEntityAlreadyExistsException | そのサービスの名前空間で別のエンティティによって既に使用されている名前を持つエンティティを作成しようとしました。 | 既存のエンティティを削除するか、作成するエンティティに別の名前を選択します。 | 再試行によって解決することはありません。 |
| QuotaExceededException | メッセージング エンティティが最大許容サイズに達しています。 この例外は、受信者の最大数 (5) がコンシューマー グループ レベルで既に開かれている場合に発生する可能性があります。 | エンティティまたはそのサブキューからメッセージを受信して、エンティティ内に領域を作成します。 「QuotaExceededException」を参照してください |
メッセージがそれまでに削除されている場合は、再試行によって解決することがあります。 |
| MessagingEntityDisabledException | 無効になっているエンティティに対してランタイム操作を要求しました。 | エンティティをアクティブ化します。 | エンティティがそれまでにアクティブ化されている場合は、再試行によって解決することがあります。 |
| Microsoft.ServiceBus.Messaging MessageSizeExceededException Microsoft.Azure.EventHubs MessageSizeExceededException |
メッセージ ペイロードが 1 MB の制限を超えています。 この 1 MB の制限はメッセージの合計サイズであり、システム プロパティや .NET のオーバーヘッドも含めたサイズです。 | メッセージ ペイロードのサイズを小さくし、操作を再試行します。 | 再試行によって解決することはありません。 |
QuotaExceededException
QuotaExceededException は、特定のエンティティのクォータが超過していることを示します。
この例外は、受信者の最大数 (5) がコンシューマー グループ レベルで既に開かれている場合に発生する可能性があります。
Event Hubs
Event Hubs には、Event Hubs あたり 20 個のコンシューマー グループという上限があります。 それ以上作成しようとすると、 QuotaExceededExceptionが発生します。
TimeoutException
TimeoutException は、ユーザーが開始した操作が操作タイムアウトより時間がかかっていることを示します。
Event Hubs では、タイムアウトは接続文字列の一部として、または ServiceBusConnectionStringBuilderを通じて指定されます。 エラー メッセージ自体はさまざまですが、これには常に現在の操作に指定されたタイムアウト値が含まれます。
タイムアウトは、サービスを実行しているリソースに対する Event Hubs サービスの更新 (または) OS の更新など、メンテナンス操作中またはその間に発生することが予想されます。 OS の更新中は、エンティティが移動され、ノードが更新または再起動されるため、タイムアウトが発生する可能性があります。 Azure Event Hubs サービスのサービス レベル アグリーメント (SLA) の詳細については、「Event Hubsの SLA」をご覧ください。
一般的な原因
この例外の一般的な原因には、次の 2 つがあります。正しくない構成と、一時的なサービス エラーです。
- 構成が正しくない 操作状態に対して、操作タイムアウトが小さすぎる可能性があります。 クライアント SDK の操作タイムアウトの既定値は 60 秒です。 コードに小さすぎる値を設定していないかどうかを確認します。 ネットワークの状態と CPU 使用率は、特定の操作が完了する時間に影響します。このため、操作タイムアウトに小さい値を設定しないでください。
- 一時的なサービス エラー Event Hubs サービスで、要求の処理に遅延が発生する場合 (トラフィック量の多い場合など) があります。 このような場合、操作が成功するまで、遅延後に操作を再試行できます。 複数回試行しても同じ操作が失敗する場合は、Azure のサービス状態のサイトにアクセスして、既知のサービス停止がないかどうかを確認してください。
ServerBusyException
Microsoft.ServiceBus.Messaging.ServerBusyException または Microsoft.Azure.EventHubs.ServerBusyException はサーバーが過負荷になっていることを示します。 この例外には関連するエラー コードが 2 つあります。
エラー コード 50002
このエラーが発生する原因は次の 2 ついずれかです。
イベント ハブ上のすべてのパーティション間で負荷が均等に分散されていません。パーティションの 1 つがローカルのスループット単位制限に達しています。
解決方法:パーティション分散戦略を変更するか、EventHubClient.Send(eventDataWithOutPartitionKey) を実行すると、問題の解決に役立つ場合があります。
Event Hubs 名前空間に十分なスループット ユニットがありません (Azure portal の Event Hubs 名前空間ウィンドウで [メトリック] 画面を確認します)。 ポータルに集計 (1 分) 情報が表示されていますが、スループットはリアルタイムで測定しているため、これは単なる推定値です。
解決方法:名前空間のスループット単位数を増やすと、問題の解決に役立つ場合があります。
スループット ユニットは、Azure portal の [Event Hubs 名前空間] ページの [スケール] ページまたは [概要] ページで構成できます。 または、使用量のニーズに合わせてスループット ユニットの数を増やすことで、自動的にスケールアップする自動インフレ機能を使用することもできます。
スループット ユニット (TU) は、Event Hubs 名前空間内のすべてのイベント ハブに適用されます。 つまり、TU は名前空間レベルで購入され、その名前空間の下のイベント ハブ間で共有されます。 各 TU により、名前空間に次の機能が与えられます。
- 最大 1 MB/秒のイングレス イベント (イベント ハブに送信されるイベント)。ただし、1 秒あたり 1000 個未満のイングレス イベント、管理操作、または制御 API 呼び出し。
- 最大 2 MB/秒のエグレス イベント (イベント ハブから使用されるイベント)。ただし、4096 個未満のエグレス イベント。
- 最大 84 GB のイベント ストレージ (既定の 1 時間の保有期間に十分な量)。
[概要] ページの [メトリックの表示] セクションで、 [スループット] タブに切り替えます。x 軸が 1 分間隔の、より大きいウィンドウで開くグラフを選択します。 ピーク値を確認し、それらを 60 で除算して、受信バイト/秒または送信バイト/秒を取得します。 同様の方法を使用して、 [要求] タブのピーク時の 1 秒あたりの要求数を計算します。
TU × 制限 (イングレスの場合は 1 MB/秒、またはイングレスに対する要求数 1000/秒、エグレスの場合は 2 MB/秒) の数よりも大きい値が表示される場合は、Event Hubs 名前空間の [スケール] (左側のメニュー) ページを使用して手動でスケールアップするか、Event Hubs の自動インフレ機能を使用して TU の数を増やします。 名前空間を手動でスケーリングまたは自動的にスケーリングする場合は、最大 40 TU までスケールアップできます。
エラー コード 50008
このエラーはあまり発生しません。 名前空間に対してコードを実行しているコンテナーの CPU が不足している場合、つまり、Event Hubs ロード バランサーの開始前の時間が数秒もないときに発生します。
解決方法:GetRuntimeInformation メソッドの呼び出しを制限します。 Azure Event Hubs は、GetRuntimeInfo に対してコンシューマー グループごとに 1 秒あたり最大 50 回の呼び出しをサポートしています。 制限に達すると、次のような例外が表示される可能性があります。
ExceptionId: 00000000000-00000-0000-a48a-9c908fbe84f6-ServerBusyException: The request was terminated because the namespace 75248:aaa-default-eventhub-ns-prodb2b is being throttled. Error code : 50008. Please wait 10 seconds and try again.
次のステップ
Event Hubs の詳細については、次のリンク先を参照してください: