relog
適用対象: Windows Server 2022、Windows Server 2019、Windows Server 2016、Windows Server 2012 R2、Windows Server 2012
TSV (タブ区切りのテキスト)、CSV (コンマ区切りのテキスト)、バイナリ、または SQL など、他の形式にパフォーマンス カウンターのログからパフォーマンス カウンターを抽出します。
Note
Windows Management Instrumentation (WMI) スクリプトへの relog の組み込みの詳細については、スクリプトのブログを参照してください。
構文
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]
パラメーター
| パラメーター | 説明 |
|---|---|
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 データベースのカウンターの書き込み先のパス名を指定します。 注: relog.exe の 64 ビット バージョンと 32 ビット バージョンでは、システムの ODBC データソース (64 ビットおよび 32 ビット) で DSN を定義する必要があります。 DSN を定義するには、"SQL Server" ODBC ドライバーを使用します。 |
-b <M/D/YYYY> [[<HH>:]<MM>:]<SS>] |
入力ファイルから最初のレコードをコピーする開始時刻を指定します。 日付と時刻は、厳密に M/D/YYYYHH:MM:SS 形式でなければなりません。 |
-e <M/D/YYYY> [[<HH>:]<MM>:]<SS>] |
入力ファイルから最後のレコードをコピーする終了時刻を指定します。 日付と時刻は、厳密に M/D/YYYYHH:MM:SS 形式でなければなりません。 |
-config {filename | i} |
コマンド ライン パラメーターを含む設定ファイルのパス名を指定します。 構成ファイルを使用している場合は、コマンド ラインに配置できる入力ファイルの一覧のプレース フォルダーとして -i を使用できます。 コマンド ラインを使用している場合は、-i を使用しないでください。 また、*.blg などのワイルドカードを使用して、一度に複数の入力ファイル名を指定することもできます。 |
| -Q | 入力ファイルで指定されたログ ファイルのパフォーマンス カウンターと時間範囲を表示します。 |
| -y | すべての質問に対する "yes" に応答することで、プロンプトをバイパスします。 |
| /? | コマンド プロンプトにヘルプを表示します。 |
解説
カウンター パスの一般的な形式は、
[\<computer>] \<object>[<parent>\<instance#index>] \<counter>]のようにします。この形式の親、インスタンス、インデックス、およびカウンター コンポーネントは、有効な名前またはワイルドカード文字のいずれかを含むことができます。 コンピューター、親、インスタンス、およびインデックス コンポーネントは、すべてのカウンターに必要ではありません。使用するカウンター パスを決定すると、自体カウンターに基づいています。 たとえば、LogicalDisk オブジェクトにはインスタンス
<index>があるため、<#index>またはワイルドカードを指定する必要があります。 したがって、\LogicalDisk(*/*#*)\\*の形式を使用できます。一方、Process オブジェクトにはインスタンス
<index>は必要ありません。 したがって、\Process(*)\ID Processの形式を使用できます。Parent 名にワイルドカード文字が指定されている場合、指定されたオブジェクトのすべてのインスタンスのうち、指定されたインスタンス フィールドおよびカウンター フィールドに一致するものが返されます。
Instance 名にワイルドカード文字が指定されており、指定されたインデックスに対応するすべてのインスタンス名がワイルドカード文字に一致する場合、指定されたオブジェクトと親オブジェクトのすべてのインスタンスが返されます。
Counter 名にワイルドカード文字が指定されている場合、指定されたオブジェクトのすべてのカウンターが返されます。
部分的なカウンター パス文字列の一致 (たとえば、pro*) はサポートされていません。
カウンター ファイルは、1 つ以上の既存のログでのパフォーマンス カウンターを一覧表示されるテキスト ファイルです。 完全なカウンター名をログまたは /q の出力から
<computer>\<object>\<instance>\<counter>形式でコピーします。 行ごとに 1 つのカウンター パスを一覧表示します。relog コマンドを実行すると、指定されたカウンターが入力ファイル内のすべてのレコードからコピーされ、必要に応じて形式が変換されます。 ワイルドカードのパスは、カウンター ファイルで許可されます。
/t パラメーターを使用して、
nthレコードごとに入力ファイルが出力ファイルに挿入されるように指定します。 既定では、すべてのレコードからデータがログされます。出力ログに開始時刻 (つまり /b) 以前のレコードが含まれるように指定して、書式適用済みの値の計算値を必要とするカウンターのデータを提供することができます。 出力ファイルは、タイムスタンプを使用した入力ファイルから最後のレコードがより小さい /e (つまり、終了時刻) のパラメーターです。
/config オプションで使用する設定ファイルの内容は、
<commandoption>\<value>という形式にする必要があります。<commandoption>はコマンド ライン オプションで、<value>はその値を指定します。
##Q# 例
固定の間隔 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"