TSV (タブ区切りのテキスト)、CSV (コンマ区切りのテキスト)、バイナリ、または SQL など、他の形式にパフォーマンス カウンターのログからパフォーマンス カウンターを抽出します。
Note
Windows Management Instrumentation (WMI) スクリプトに 再ログイン を組み込む方法の詳細については、 スクリプト ブログを参照してください。
Syntax
relog [<filename> [<filename> ...]] [/a] [/c <path> [<path> ...]] [/cf <filename>] [/f {bin|csv|tsv|SQL}] [/t <value>] [/o {outputfile|DSN!CounterLog}] [/b <M/D/YYYY> [[<HH>:] <MM>:] <SS>] [/e <M/D/YYYY> [[<HH>:] <MM>:] <SS>] [/config {<filename>|i}] [/q]
Parameters
| Parameter | Description |
|---|---|
filename [filename ...] |
既存のパフォーマンス カウンター ログのパス名を指定します。 複数の入力ファイルを指定できます。 |
| -a | 出力ファイルを上書きする代わりに追加します。 このオプションは、SQL 形式の既定値は常に追加するには適用されません。 |
-c path [path ...] |
ログに記録するパフォーマンス カウンターのパスを指定します。 複数のカウンターのパスを指定するには、スペースで区切ってカウンターのパスを引用符で囲みます (たとえば、"path1 path2")。 |
| -cf filename | Relog ファイルに含まれるパフォーマンス カウンターの一覧をテキスト ファイルのパス名を指定します。 カウンター パスを入力ファイルで、行ごとに 1 つは、このオプションを使用します。 既定値は、元のログ ファイル内のすべてのカウンターをログします。 |
-f {bin | csv | tsv | SQL} |
出力ファイルの形式のパス名を指定します。 デフォルトの形式は binです。 SQL データベースの場合、出力ファイルは DSN!CounterLog を指定します。 DSN (データベースのシステム名) を構成する ODBC マネージャーを使用して、データベースの場所を指定できます。 |
| -t value | サンプル間隔を n レコードで指定します。 Relog ファイルにすべての n 番目のデータ ポイントが含まれています。 既定値は、すべてのデータ ポイントです。 |
-o {Outputfile | SQL:DSN!Counter_Log} |
出力ファイルまたは SQL データベースのカウンターの書き込み先のパス名を指定します。 手記： 64 ビット バージョンと 32 ビット バージョンの relog.exeでは、システムの ODBC データ ソース (それぞれ 64 ビットと 32 ビット) で DSN を定義する必要があります。 DSN を定義するには、"SQL Server" ODBC ドライバーを使用します。 |
-b <M/D/YYYY> [[<HH>:]<MM>:]<SS>] |
入力ファイルから最初のレコードをコピーする開始時刻を指定します。 日付と時刻は、厳密に M/D/YYYYHH:MM:SS 形式でなければなりません。 |
-エ <M/D/YYYY> [[<HH>:]<MM>:]<SS>] |
入力ファイルから最後のレコードをコピーする終了時刻を指定します。 日付と時刻は、厳密に M/D/YYYYHH:MM:SS 形式でなければなりません。 |
-config(設定) {filename | i} |
コマンド ライン パラメーターを含む設定ファイルのパス名を指定します。 構成ファイルを使用している場合は、コマンド ラインに配置できる入力ファイルの一覧のプレースホルダーとして -i を使用できます。 コマンドラインを使用している場合は、 -i を使用しないでください。 また、*.blg などのワイルドカードを使用して、一度に複数の入力ファイル名を指定することもできます。 |
| -q | 入力ファイルで指定されたログ ファイルのパフォーマンス カウンターと時間範囲を表示します。 |
| -y | すべての質問に対する "yes" に応答することで、プロンプトをバイパスします。 |
| /? | コマンド プロンプトにヘルプを表示します。 |
Remarks
カウンター パスの一般的な形式は、
[\<computer>] \<object>[<parent>\<instance#index>] \<counter>]のようにします。この形式の親、インスタンス、インデックス、およびカウンター コンポーネントは、有効な名前またはワイルドカード文字のいずれかを含むことができます。 コンピューター、親、インスタンス、およびインデックス コンポーネントは、すべてのカウンターに必要ではありません。使用するカウンター パスを決定すると、自体カウンターに基づいています。 たとえば、 LogicalDisk オブジェクトにはインスタンス
<index>があるため、<#index>またはワイルドカードを指定する必要があります。 したがって、\LogicalDisk(*/*#*)\\*の形式を使用できます。これに対し、 Process オブジェクトにはインスタンス
<index>は必要ありません。 したがって、\Process(*)\ID Processの形式を使用できます。親名にワイルドカード文字が指定されている場合、指定されたインスタンスおよびカウンタフィールドに一致する指定されたオブジェクトのすべてのインスタンスが返されます。
インスタンス名にワイルドカード文字が指定されている場合、指定されたインデックスに対応するすべてのインスタンス名がワイルドカード文字に一致すると、指定されたオブジェクトと親オブジェクトのすべてのインスタンスが返されます。
カウンタ名にワイルドカード文字を指定すると、指定されたオブジェクトのすべてのカウンタが返されます。
部分的なカウンター パス文字列の一致 (たとえば、pro*) はサポートされていません。
カウンター ファイルは、1 つ以上の既存のログでのパフォーマンス カウンターを一覧表示されるテキスト ファイルです。 ログまたは /q 出力から完全なカウンタ名を
<computer>\<object>\<instance>\<counter>形式でコピーします。 行ごとに 1 つのカウンター パスを一覧表示します。relog コマンドを実行すると、入力ファイル内のすべてのレコードから指定されたカウンターがコピーされ、必要に応じて形式が変換されます。 ワイルドカードのパスは、カウンター ファイルで許可されます。
/t パラメーターを使用して、入力ファイルが
nthレコードごとに出力ファイルに挿入されるように指定します。 既定では、すべてのレコードからデータがログされます。出力ログに開始時刻 ( つまり、/b) より前のレコードを含めるように指定して、書式設定された値の計算値を必要とするカウンタにデータを提供できます。 出力ファイルには、タイムスタンプが /e (つまり終了時刻) パラメーターより小さい入力ファイルの最後のレコードが含まれます。
/config オプションで使用される設定ファイルの内容は、次の形式にする必要があります。
<commandoption>\<value>(<commandoption>はコマンド ライン オプションであり、<value>はその値を指定します)。
##Q# Examples
固定の間隔 30 で既存のトレース ログを再サンプリングし、カウンターのパスをリストし、ファイルを出力し、フォーマットするには、次のように入力します。
relog c:\perflogs\daily_trace_log.blg /cf counter_file.txt /o c:\perflogs\reduced_log.csv /t 30 /f csv
固定の間隔 30 で既存のトレース ログを再サンプリングし、カウンターのパスをリストし、ファイルを出力するには、次のように入力します。
relog c:\perflogs\daily_trace_log.blg /cf counter_file.txt /o c:\perflogs\reduced_log.blg /t 30
既存のトレース ログをデータベースに再サンプリングするには、次のように入力します。
relog "c:\perflogs\daily_trace_log.blg" -f sql -o "SQL:sql2016x64odbc!counter_log"