1. 一般的な設定の定義

EXMリトライャーの設定

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

EXMは過渡的故障処理フレームワークに基づく3つのリトライャを使用します。暫過故障処理については、Microsoftのこのドキュメントで詳しく読むことができます。Sitecoreの3つのEXM再試行器は以下の通りです:

  • EmailCampaign.EDS.Core.Net.Smtp.Send.Retryer(Sendリトライャーと呼ばれる)は、SMTP経由でメッセージを送信するためにEXM使います。
  • EmailCampaign.EDS.Core.Net.Smtp.ValidateConnection.Retryerは、EXMが接続プールからSMTP接続を取得して検証するために使います。
  • EmailCampaign.XConnect.Conflict.Retryer(xConnect conflict retryerと呼ばれる)は、xConnectと競合がある場合にメソッドを再試すために使うものEXM。

リトライヤにはEXMの設定時に設定できるデフォルト値があります。以下のことができます:

  • 指数的バックオフ再試行戦略を設定してください。
  • Sendリトライャを固定間隔のリトライ動作に変換します。
  • Sendリトライヤに特定のSMTP関連の一時故障コードを追加します。

Sitecore.EDS.Core.configファイルには、最初の2つのEXMリトライヤの設定コードが以下の通りです。

Sitecore.EDS.Core.TransientFaultHandling.RetryerFactories.SmtpSendExponentialRetryerFactory, Sitecore.EDS.Core 10 \`00:00\`:01 \`00:00\`:30 \`00:00\`:10 421 Sitecore.EDS.Core.TransientFaultHandling.RetryerFactories.SmtpValidateFixedRetryerFactory, Sitecore.EDS.Core 3 \`00:00\`:01 false

指数的バックオフ再試行戦略の設定

デフォルトでは、Sendリトライは指数的なバックオフリトライ動作を用いており、これは繰り返しリトライをランダムな間隔で間隔を空けていることを意味します。指数的バックオフ戦略の詳細については、ウィキペディアのこの記事をご覧ください。

指数的バックオフ戦略の設定:

  • Sendリトライャーのセクションで、以下の値を設定します:

舞台設定

デフォルト

概要

マックス・エブリッツ

10

一時的な例外に対する再試行回数を指定します。この量に達すると、再試行者は対象サービスを利用不可と定義します。

ミンバックオフ

00:00

再試試までの最小期間。

マックスバックオフ

00:00

再挑戦までの最大期間。

デルタバックオフ

00:00

リトライ間のデルタバック間隔。

Sendリトライを固定間隔のリトライ動作に変換します

EXMは、デフォルトの指数関数的な動作ではなく、一定間隔でのリトライオプションをサポートしています。

インターバル再試行動作に変換するには:

  1. Sendリトライアーのコードでセクションを見つけ、コメントインジケーターでコメントアウトします。
  2. <FixedRetryセクションを見つけて、コメントインジケーターを削除してコメントを取り消してください。

Sendリトライャーのセクションで、以下の値を設定できます:

舞台設定

デフォルト

概要

リトライカウント

3

一時例外の最大リトライ回数を指定します。

リトライインターバル

00:00

リトライ間の固定された時間間隔。

Sendリトライャに一時的な故障コードを追加します

セクションでは、EmailCampaign.EDS.Core.Net.Smtp.Send.Retryer再試行者がどのSMTP固有の一時故障をチェックするかが指定されています。デフォルトでは、再試行機は常に受信サービスが利用できないことを示す故障コード421をチェックします。再試行機のチェックをより具体的にするために、このセクションに追加の故障コードを追加できます。

具体的な故障コードを追加します:

  1. 設定コードで セクションを見つけてください。
  2. the fault codeで新しい行を追加してください。

!ヒント フィールドを使って、エラーコードが何を意味するのか自分に説明するのに役立つ説明を書いてください。

SMTP一時故障コードとその意味の詳細については、SMTP強化ステータスコードレジストリを参照してください。

xConnectのコンフリクトリトライャーを設定してください

EXM xConnectと競合がある場合、そのEmailCampaign.XConnect.Conflict.Retryerを使ってメソッドを再試行します。そのような競合が発生した場合、リトライヤーは再びxConnectから競合したエンティティを取得しようとします。

Sitecore.EmailExperince.xConnect.configファイル(パス:\\App_Config\Sitecore\EmailExperience)には、xConnectコンフリクトリトライャの設定コードが以下の通りです。

Sitecore.EmailCampaign.XConnect.Web.TransientFaultHandling.RetryerFactories.XConnectConflictFixedRetryerFactory, Sitecore.EmailCampaign.XConnect.Web 3 \`00:00\`:01 false

xConnectのコンフリクトリトライャでは、以下の値を設定できます:

舞台設定

デフォルト

概要

リトライカウント

3

xConnectから競合するエンティティを取得するための最大リトライ回数を指定します。

リトライインターバル

00:00

リトライ間の固定された時間間隔。

ファーストファストリトライ

偽り

EXM競合に遭遇した直後に最初の再試行を行うかどうかを指定します。デフォルトではこれは偽であり、最初の再試行は RetryIntervalに従って行われます。

OAuthの再試行を設定してください

EXMエラーが発生した場合に備えてメソッドを再試行するためにSitecore.ExM.Framework.Helpers.OAuthRetryを使用します。

Sitecore.EmailExperience.Core.configファイル(パス:\<Your Instance Name>\App_Config\Sitecore\EmailExperience)には、OAauth retryの構成コードが以下の通りです:

5000 3

oAuth retryでは、以下の値を設定できます:

舞台設定

デフォルト

概要

遅延

5000

再試行間の遅延を指定します。

リトライカウント

3

最大リトライ回数を指定します。

この記事を改善するための提案がある場合は、 お知らせください!