Configure Distributed Replay

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

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

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

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

• 前処理構成ファイル

• 再生構成ファイル

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

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

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

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

例

この例は、 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

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

例

この例は、 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 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> 要素によって指定される設定には、次の内容が含まれます。

<OutputOptions> 要素

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

例

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

<?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