Distributed Replay の構成

  • [アーティクル]

Distributed Replay Controller、クライアント、および管理ツールのインストール場所に関する Microsoft SQL Server Distributed Replay の構成の詳細は、XML ファイルで指定されます。 このようなファイルには、次のファイルが含まれます。

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

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

  • 前処理構成ファイル

  • 再生構成ファイル

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

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

<controller installation path>\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 サービスをインストールしたフォルダーにあります。

<client installation path>\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 管理ツール)」を参照してください。

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

<administration tool installation path>\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 パラメーターを使用して、変更された再生構成ファイルの場所を指定します。 管理ツールの再生オプションの使用の詳細については、「replay オプション (Distributed Replay 管理ツール)」を参照してください。

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

<administration tool installation path>\DReplayAdmin\DReplay.exe.replay.config

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

<ReplayOptions> 要素

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

設定

XML 要素

説明

指定できる値

必須?

SQL Server の対象インスタンス (テスト サーバー)

<Server>

接続先となる SQL Server のサーバーとインスタンスの名前を指定します。

server_name[\instance_name]

"localhost" または "." を使用してローカル ホストを表すことはできません。

いいえ (管理ツールの replay オプションで、サーバー名が既に -s target 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 Distributed Replay フォーラム

Distributed Replay を使用した SQL Server のロード テスト – パート 2

Distributed Replay を使用した SQL Server のロード テスト – パート 1