xConnectクライアントのHTTP一時障害処理
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
クラウド デプロイメント環境では、xConnectクライアントとxConnect Web Host間の接続が定期的に切断される可能性があります。Sitecore 10.3以降、xConnectはこのようなHTTP一時的な障害を検出し、リクエストの送信を自動的に再試行する障害処理戦略を実装します。
HTTP一時的な障害処理は、すぐに使用できるSitecore xConnectクライアントに対してデフォルトで有効になっています。デフォルトの再試行者構成では、指数関数的バックオフ 戦略が使用されます。
このトピックには、HTTP一時的な障害処理の設定や、xConnectクライアント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を使用して独自の再試行を実装するオプションがあります。