Configure Distributed Replay

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>  

参照

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