xConnectクライアント向けのHTTP一時故障処理
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
クラウド展開環境では、xConnectクライアントとxConnect Web Host間の接続が定期的に切断されることがあります。Sitecore 10.3以降、xConnectはこのようなHTTPの一時的故障を検出し、自動的にリクエストの送信を再試行するフォールトハンドリング戦略を実装しています。
Sitecore xConnectクライアントでは、標準でHTTPトランジェントフォールト処理が有効です。デフォルトのリトライア構成では 指数関数的なバックオフ 戦略が使われています。
このトピックには、HTTPの一時的故障処理の設定や、xConnect Client APIを使用するカスタムアプリケーションでの戦略実装に関する情報が含まれています。
デフォルトの一時エラーステータスコード
デフォルトでは、xConnect HTTP一時的エラー検出戦略は、以下のエラーステータスコードを一時的障害として定義しています:
- 408 Request Timeout
- 429 Too Many Requests
- 502 Bad Gateway
- 503 Service Unavailable
- 504 Gateway Timeout
xConnect Client APIへの呼び出しで一時的なエラーコードとして定義されたエラーステータスコードのいずれかが返された場合、リトライ戦略は再度リクエストを送信しようとします。
特定の要件に合わせて 、一時的なエラーステータスコードのデフォルトセットを変更する ことができます。
再挑戦戦略
xConnectのHTTP一時的故障処理は以下の再試行戦略をサポートしています:
再挑戦戦略
概要
ExponentialRetry
到達再試行間の指数待ち時間を計算するためのパラメータを指定します。
Sitecore xConnectはこの戦略をデフォルトで使っています。
Fixed Interval
再試行回数と、各再試行の間に固定された固定時間間隔をデフォルトで定めています。
Incremental
再試行回数と各再試行間の時間間隔を指定します。
Custom interval
各リトライ間のカスタム間隔待ち時間を指定します。
!注標準の指数関数的なリトライ戦略のみが利用可能です。他のリトライ戦略については、IRetryerFactoryを使って独自のリトライアを実装するオプションがあります。