Configure Distributed Replay

適用対象: SQL Server 2016 (13.x)、 SQL Server 2017 (14.x)、および SQL Server 2019 (15.x)

重要

SQL Server 分散再生は、SQL Server 2022 (16.x) では使用できません。

Microsoft SQL Server 分散再生構成の詳細は、分散再生コントローラー、クライアント、および管理ツールがインストールされている場所の XML ファイルで指定されます。 このようなファイルには、次のファイルが含まれます。

• コントローラー構成ファイル

• クライアント構成ファイル

• 前処理構成ファイル

• 再生構成ファイル

コントローラー構成ファイル: DReplayController.config

SQL Server Distributed Replay Controller サービスを開始すると、コントローラー構成ファイル DReplayController.configからログ記録レベルが読み込まれます。 このファイルは、Distributed Replay Controller サービスをインストールしたフォルダーにあります。

<コントローラーのインストール パス>\DReplayController.config

コントローラー構成ファイルによって指定されるログ記録レベルには、次の内容が含まれます。

設定	XML 要素	説明	使用できる値	必須
ログ記録レベル	<LoggingLevel>	コントローラー サービスのログ記録レベルを指定します。	INFORMATION | WARNING | CRITICAL	いいえ。 既定値は CRITICAL です。

例

この例は、 INFORMATION および WARNING ログのエントリを非表示にするように変更されたコントローラー構成ファイルを示しています。

<?xml version='1.0'?> 
<Options> 
<LoggingLevel>CRITICAL</LoggingLevel> 
</Options> 

クライアント構成ファイル: DReplayClient.config

SQL Server Distributed Replay Client サービスを開始すると、クライアント構成ファイル DReplayClient.configから構成設定が読み込まれます。 このファイルは、各クライアントの Distributed Replay Client サービスをインストールしたフォルダーにあります。

<クライアントのインストール パス>\DReplayClient.config

クライアント構成ファイルによって指定される設定には、次の内容が含まれます。

設定	XML 要素	説明	使用できる値	必須
コントローラー	<Controller>	コントローラーのコンピューターの名前を指定します。 クライアントは、コントローラーにアクセスすることによって、Distributed Replay 環境での登録を試みます。	"localhost" または "." を使用してローカル コンピューターを参照できます。	いいえ。 既定では、クライアントはローカル (".") で実行しているコントローラー インスタンスの登録を試みます (存在する場合)。
クライアントの作業ディレクトリ	<WorkingDirectory>	ディスパッチ ファイルが保存されるクライアント上のローカル パス。 このディレクトリ内のファイルは、次の再生時に上書きされます。	ドライブ文字で始まる完全なディレクトリ名。	いいえ。 値が指定されない場合は、ディスパッチ ファイルは既定のクライアント構成ファイルと同じ場所に保存されます。 値が指定されており、そのフォルダーがクライアントに存在しない場合は、クライアント サービスは開始されません。
クライアントの結果ディレクトリ	<ResultDirectory>	クライアントの再生アクティビティによって生成される結果トレース ファイルが保存される、クライアント上のローカル パス。 このディレクトリ内のファイルは、次の再生時に上書きされます。	ドライブ文字で始まる完全なディレクトリ名。	いいえ。 値が指定されない場合は、結果トレース ファイルは既定のクライアント構成ファイルと同じ場所に保存されます。 値が指定されており、そのフォルダーがクライアントに存在しない場合は、クライアント サービスは開始されません。
ログ記録レベル	<LoggingLevel>	クライアント サービスのログ記録レベル。	INFORMATION | WARNING | CRITICAL	いいえ。 既定値は CRITICAL です。

例

この例は、 Controller1という名前の別のコンピューターでコントローラー サービスが実行されるように指定したクライアント構成ファイルを示しています。 WorkingDirectory および ResultDirectory 要素は、フォルダー c:\ClientWorkingDir および c:\ResultTraceDirをそれぞれ使用するように構成されています。 ログ記録レベルは INFORMATION および WARNING ログ エントリを非表示にするように既定値から変更されています。

<?xml version='1.0'?> 
<Options> 
    <Controller>Controller1</Controller> 
    <WorkingDirectory>c:\ClientWorkingDir</WorkingDirectory> 
    <ResultDirectory>c:\ResultTraceDir</ResultDirectory> 
    <LoggingLevel>CRITICAL</LoggingLevel> 
</Options> 

前処理構成ファイル : DReplay.exe.preprocess.config

前処理段階を開始するために管理ツールを使用すると、管理ツールは前処理構成ファイル DReplay.exe.preprocess.config から前処理設定を読み込みます。

既定の構成ファイルまたは管理ツール -c パラメーターを使用して、変更された前処理構成ファイルの場所を指定します。 管理ツールの前処理オプションの使用に関する詳細については、「前処理オプション (Distributed Replay 管理ツール)」を参照してください。

既定の前処理構成ファイルは管理ツールのインストール フォルダーにあります。

<管理ツールのインストール パス>\DReplayAdmin\DReplay.exe.preprocess.config

前処理構成の設定は、前処理構成ファイル内の <PreprocessModifiers> 要素の子である XML 要素で指定されています。 これらの設定には、次の内容が含まれています。

設定	XML 要素	説明	使用できる値	必須
システム セッション アクティビティを含む	<IncSystemSession>	キャプチャ中のシステム セッション アクティビティが再生中に含まれるかどうかを示します。	Yes | No	いいえ。 既定値は No です。
最大アイドル時間	<MaxIdleTime>	アイドル時間を絶対数 (単位は秒) で指定します。	>= -1 の整数です。 -1 は、元のトレース ファイルの元の値から変更されていないことを示します。 0 は、指定された時刻に何らかのアクティビティが行われていることを示します。	いいえ。 既定値は -1 です。

例

既定の前処理構成ファイルは、次のとおりです。

<?xml version='1.0'?> 
<Options> 
    <PreprocessModifiers> 
        <IncSystemSession>No</IncSystemSession> 
        <MaxIdleTime>-1</MaxIdleTime> 
    </PreprocessModifiers> 
</Options> 

再生構成ファイル : DReplay.exe.replay.config

イベント再生段階を開始するために管理ツールを使用すると、管理ツールは再生構成ファイル DReplay.exe.replay.configから再生設定を読み込みます。

既定の構成ファイルまたは管理ツール -c パラメーターを使用して、変更された再生構成ファイルの場所を指定します。 管理ツールの再生オプションの使用に関する詳細については、「前処理オプション (Distributed Replay 管理ツール)」を参照してください。

既定の再生構成ファイルは管理ツールのインストール フォルダーにあります。

<管理ツールのインストール パス>\DReplayAdmin\DReplay.exe.replay.config

再生構成の設定は、再生構成ファイルの <ReplayOptions> 要素および <OutputOptions> 要素の子である XML 要素で指定されています。

<ReplayOptions> 要素

再生構成ファイルの <ReplayOptions> 要素によって指定される設定には、次の内容が含まれます。

設定	XML 要素	説明	使用できる値	必須
SQL Server の対象インスタンス (テスト サーバー)	<Server>	接続先となる SQL Server のサーバーとインスタンスの名前を指定します。	server_name[\instance_name] "localhost" または "." を使用してローカル ホストを表すことはできません。	いいえ (管理ツールの replay オプションで、サーバー名が既に -starget server パラメーターを使用して指定されている場合)。
シーケンス モード	<SequencingMode>	イベント スケジュールに使用されるモードを指定します。	synchronization | stress	いいえ。 既定値は stress です。
ストレス スケールの粒度	<StressScaleGranularity>	ストレス モードで、Service Profile ID (SPID) のすべての接続をまとめて測定するのか (SPID)、個別に測定するのか (Connection) を指定します。	SPID | Connection	はい。 既定値は SPID です。
接続タイム スケール	<ConnectTimeScale>	ストレス モードで接続時間を測定するのに使用されます。	1 ～ 100の整数値です。	いいえ。 既定値は 100 です。
待ち時間タイム スケール	<ThinkTimeScale>	ストレス モードで待ち時間を測定するのに使用されます。	0 ～ 100の整数値です。	いいえ。 既定値は 100 です。
接続プールの使用	<UseConnectionPooling>	各 Distributed Replay Client で接続プールを有効にするかどうかを指定します。	Yes | No	はい。 既定値は Yes です。
ヘルス モニターの間隔	<HealthmonInterval>	ヘルス モニターを実行する頻度 (秒) を示します。 この値は、同期モードでのみ使用されます。	>= 1 の整数です (無効にする場合は-1 )	いいえ。 既定値は 60 です。
クエリのタイムアウト	<QueryTimeout>	クエリのタイムアウト時間を秒単位で指定します。 この値は、最初の行が返されるまで有効です。	>= 1 の整数です (無効にする場合は-1 )	いいえ。 既定値は 3600 です。
クライアントごとのスレッド	<ThreadsPerClient>	それぞれの再生クライアントで使用する再生スレッドの数を指定します。	1 ～ 512の整数値です。	いいえ。 指定されない場合、Distributed Replay は値として 255を使用します。

<OutputOptions> 要素

再生構成ファイルの <OutputOptions> 要素によって指定される設定には、次の内容が含まれます。

設定	XML 要素	説明	使用できる値	必須
行数の記録	<RecordRowCount>	それぞれの結果セットで行数を記録するかどうかを示します。	Yes | No	いいえ。 既定値は Yes です。
結果セットの記録	<RecordResultSet>	すべての結果セットの内容を記録するかどうかを示します。	Yes | No	いいえ。 既定値は No です。

例

既定の再生構成ファイルは、次のとおりです。

<?xml version='1.0'?> 
<Options> 
    <ReplayOptions> 
        <Server></Server> 
        <SequencingMode>stress</SequencingMode> 
        <ConnectTimeScale></ConnectTimeScale> 
        <ThinkTimeScale></ThinkTimeScale> 
        <HealthmonInterval>60</HealthmonInterval> 
        <QueryTimeout>3600</QueryTimeout> 
        <ThreadsPerClient></ThreadsPerClient> 
    </ReplayOptions> 
    <OutputOptions> 
        <ResultTrace> 
            <RecordRowCount>Yes</RecordRowCount> 
            <RecordResultSet>No</RecordResultSet> 
        </ResultTrace> 
    </OutputOptions> 
</Options> 

同期シーケンス モードで実行するときに発生する可能性のある問題

再生機能が "停止" しているように見えたり、イベントの再生が遅くなったりする症状が発生する可能性があります。 この現象は、再生中のトレースが、復元されたターゲット データベースに存在しないデータやイベントに依存している場合に発生する可能性があります。

1 つの例として、Service Broker の WAITFOR RECEIVE ステートメントなど、WAITFOR を使用するキャプチャされたワークロードがあります。 同期シーケンス モードを使用している場合、バッチは順番に再生されます。 データベースのバックアップ後、再生キャプチャ トレースが開始される前にソース データベースに対して INSERT が発生すると、再生中に発行された WAITFOR RECEIVE は WAITFOR の全期間を待機する必要があります。 イベントは、WAITFOR RECEIVE が停止した後に再生されるように設定されます。 これにより、再生ターゲットのデータベースに対するバッチ要求/秒のパフォーマンス モニター カウンターが、WAITFOR が完了するまで 0 に下がる可能性があります。

同期モードを使用する必要があり、この動作を回避したい場合は、次の操作を行う必要があります。

1. 再生ターゲットとして使用するデータベースを停止します。

2. すべての保留中のアクティビティの完了を許可します。

3. データベースをバックアップし、バックアップを完了できるようにします。

4. 分散再生トレースのキャプチャを開始し、通常のワークロードを再開します。

関連項目

• 管理ツール コマンド ライン オプション (Distributed Replay Utility)
• SQL Server Distributed Replay
• 分散再生を使用した SQL Server のロード テスト – パート 2
• 分散再生を使用した SQL Server のロード テスト – パート 1