relog

  • Artikel

Gilt für: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012

Extrahiert Leistungsindikatoren aus Leistungsindikatorprotokollen in andere Formate, z. B. text-CSV (durch Tabstopps getrennter Text), text-CSV (durch Trennzeichen getrennter Text), binary-BIN und SQL.

Hinweis

Weitere Informationen zur Integration von relog in Windows-Verwaltungsinstrumentation (WMI)-Skripte finden Sie im Skripting-Blog.

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]

Parameter

Parameter BESCHREIBUNG
filename [filename ...] Gibt den Pfadnamen eines vorhandenen Leistungsindikatorprotokolls an. Sie können mehrere Eingabedateien angeben.
-a Fügt die Ausgabedatei hinzu (kein Überschreiben). Diese Option gilt nicht für das SQL-Format, bei dem Hinzufügen der Standard ist.
-c path [path ...] Gibt den Leistungsindikatorpfad für das Protokoll an. Um mehrere Indikatorpfade anzugeben, trennen Sie sie durch ein Leerzeichen voneinander und schließen die Indikatorpfade in Anführungszeichen ein (z. B. "path1 path2").
-cf Dateiname Gibt den Pfadnamen der Textdatei an, die die Leistungsindikatoren aufführt, die in einer Neuprotokolldatei enthalten sein sollen. Mit dieser Option können Sie die Indikatorpfade in einer Eingabedatei aufführen, einen pro Zeile. Standardmäßig werden alle Indikatoren aus der ursprünglichen Protokolldatei neu protokolliert.
-f {bin | csv | tsv | SQL} Gibt den Pfadnamen des Ausgabedateiformats an. Das Standardformat ist bin. Für eine SQL-Datenbank gibt die Ausgabedatei das DSN!CounterLog an. Um den Speicherort der Datenbank festzulegen, können Sie mit dem ODBC-Manager den Datenbank-Systemnamen (Database System Name, DSN) konfigurieren.
-t Wert Gibt Probenintervalle in 2 Datensätzen an. Schließt jeden n-ten Datenpunkt in der Neuprotokolldatei ein. Standardwert ist jeder Datenpunkt.
-o {Outputfile | SQL:DSN!Counter_Log} Gibt den Pfadnamen der Ausgabedatei oder SQL-Datenbank an, in die die Indikatoren geschrieben werden.

Hinweis: Bei den 64-Bit- und 32-Bit-Versionen von relog.exe müssen Sie einen Datenbank-Systemnamen in ODBC-Datenquelle (64-Bit bzw. 32-Bit) auf dem System definieren. Verwenden Sie dafür den ODBC-Treiber „SQL Server“.
-b <M/D/YYYY> [[<HH>:]<MM>:]<SS>] Gibt die Startzeit an, zu der der erste Datensatz aus der Eingabedatei kopiert werden soll. Datum und Uhrzeit müssen exakt in diesem Format angegeben werden: M/T/JJJJHH:MM:SS
-e <M/D/YYYY> [[<HH>:]<MM>:]<SS>] Gibt die Endzeit an, zu der der letzte Datensatz aus der Eingabedatei kopiert werden soll. Datum und Uhrzeit müssen exakt in diesem Format angegeben werden: M/T/JJJJHH:MM:SS
-config {filename | i} Gbit den Pfadnamen der Einstellungen-Datei an, die die Befehlszeilenparameter enthält. Wenn Sie eine Konfigurationsdatei nutzen, können Sie -i als Platzhalter für eine Liste von Eingabedateien verwenden, die in der Befehlszeile platziert werden. Wenn Sie die Befehlszeile nutzen, verwenden Sie -i nicht. Sie können auch Platzhalter wie *.blg verwenden, um mehrere Namen von Eingabedateien gleichzeitig anzugeben.
-q Zeit die Leistungsindikatoren und Zeitbereiche von Protokolldateien an, die in der Eingabedatei angegeben sind.
-y Umgeht die Eingabeaufforderung, indem alle Fragen mit „Yes“ (Ja) beantwortet werden.
/? Zeigt die Hilfe an der Eingabeaufforderung an.

Bemerkungen

  • Das allgemeine Format für Indikatorpfade ist wie folgt: [\<computer>] \<object>[<parent>\<instance#index>] \<counter>], wobei „parent“, „instance“, „index“ und „counter“ jeweils entweder ein gültiger Name oder ein Platzhalterzeichen sein können. Die Elemente „computer“, „parent“, „instance“ und „index“ sind nicht für alle Indikatoren nötig.

  • Welche Indikatorpfade verwendet werden müssen, hängt vom jeweiligen Indikator ab. Das Objekt LogicalDisk hat z. B. eine Instanz <index>. Sie müssen also den <#index> oder einen Platzhalter angeben. Sie könnten also das folgende Format verwenden: \LogicalDisk(*/*#*)\\*.

  • Im Gegensatz dazu erfordert das Objekt Process keine Instanz <index>. Daher können Sie das folgende Format verwenden: \Process(*)\ID Process.

  • Wenn im Parent-Namen ein Platzhalterzeichen angegeben ist, werden alle Instanzen des angegebenen Objekts zurückgegeben, die mit der angegebenen Instanz und dem angegebenen Indikator übereinstimmen.

  • Wenn im Instance-Namen ein Platzhalter angegeben ist, werden alle Instanzen des angegebenen Objekts und übergeordneten Objekts zurückgegeben, wenn alle Instanznamen, die dem angegebenen Index entsprechen, mit dem Platzhalterzeichen übereinstimmen.

  • Wenn ein Platzhalterzeichen im Counter-Namen angegeben ist, werden alle Indikatoren des angegebenen Objekts zurückgegeben.

  • Teilweise Übereinstimmungen der Indikatorpfad-Zeichenfolge (z. B. pro*) werden nicht unterstützt.

  • Indikatordateien sind Textdateien, die mindestens einen Leistungsindikator im vorhandenen Protokoll aufführen. Kopieren Sie den vollständigen Indikatornamen aus dem Protokoll oder der Ausgabe von /q im Format <computer>\<object>\<instance>\<counter>. Geben Sie pro Zeile einen Indikatorpfad an.

  • Bei der Ausführung kopiert der relog-Befehl die angegebenen Indikatoren aus jedem Datensatz in der Eingabedatei und wandelt dabei bei Bedarf das Format um. Platzhalterpfade sind in der Indikatordatei zulässig.

  • Mit dem Parameter /t können Sie angeben, dass Eingabedateien in Ausgabedateien in Intervallen von jedem nth Datensatz eingefügt werden. Standardmäßig werden Daten von jedem Datensatz neu protokolliert.

  • Sie können angeben, dass die Ausgabeprotokolle Datensätze einschließen, die vor der Startzeit (also /b) angelegt wurden, um Daten für Indikatoren bereitzustellen, die Berechnungswerte des formatierten Werts erfordern. Die Ausgabedatei enthält die letzten Datensätze von Eingabedateien mit Zeitstempeln, die kleiner als der Parameter /e (also die Endzeit) sind.

  • Die Inhalte der Einstellungen-Datei, die für die Option /config verwendet wird, muss das folgende Format aufweisen: <commandoption>\<value>, wobei <commandoption> die Befehlszeilenoption ist und <value> ihren Wert angibt.

##Q# Beispiele

Um vorhandene Ablaufverfolgungsprotokolle in festen Abständen von 30 erneut zu berechnen, und die Indikatorpfade, Ausgabedateien und Formate anzuzeigen, geben Sie Folgendes ein:

relog c:\perflogs\daily_trace_log.blg /cf counter_file.txt /o c:\perflogs\reduced_log.csv /t 30 /f csv

Um vorhandene Ablaufverfolgungsprotokolle in festen Abständen von 30 erneut zu berechnen und Indikatorpfade und Ausgabedateien anzuzeigen, geben Sie Folgendes ein:

relog c:\perflogs\daily_trace_log.blg /cf counter_file.txt /o c:\perflogs\reduced_log.blg /t 30

Um vorhandene Ablaufverfolgungsprotokolle erneut zu berechnen und in eine Datenbank auszugeben, geben Sie Folgendes ein:

relog "c:\perflogs\daily_trace_log.blg" -f sql -o "SQL:sql2016x64odbc!counter_log"