hpctrace
Dieser Befehl wurde in HPC Pack 2008 R2 eingeführt und wird in früheren Versionen nicht unterstützt. Die Funktionalität wurde in HPC Pack 2012 hinzugefügt und in HPC Pack 2012 mit Service Pack 1 (SP1) geändert.
Hpctrace-Referenz für HPC Pack 2012 mit SP1 (oder höher)
Sammelt und extrahiert die Informationen in den binären Protokolldateien (.bin), die von HPC Pack generiert werden, beginnend mit HPC Pack 2012 mit Service Pack 1 (SP1).
Hinweis
Zum Herunterladen und Verwalten von Protokolldateien, die auf Windows Azure-Knoten generiert werden, können Sie das hpcazurelog Befehlszeilentool verwenden. Verwenden Sie dann den Parselog Unterbefehl in diesem Tool, um die Informationen in den von Ihnen heruntergeladenen Protokolldateien zu extrahieren.
Syntax
hpctrace getlog <provider> [level] [-d:<destination folder>]
hpctrace parselog <BIN file> [level] [-s] [-d:<destination folder>]
hpctrace {/? | /help}
Unterbefehle
| Subcommand | Beschreibung |
|---|---|
| hpctrace getlog | Sammelt die Binärprotokolldateien für den angegebenen Anbieter und führt automatisch den Parselog Unterbefehl aus, um ihre Informationen in Textdateien zu extrahieren. Bei Verwendung mit dem optionalen Level Parameter filtert die Protokollausgabe basierend auf dem Schweregrad jedes Protokolleintrags. |
| hpctrace parselog | Extrahiert die Informationen aus einer oder mehreren binären Protokolldateien (.bin) und schreibt sie in eine Textdatei mit tabstopptrennten Werten, die in ein tabellenbasiertes Tool für die Analyse importiert werden können. Die Ausgabedatei hat denselben Namen wie die Binärprotokolldatei mit einer .log Erweiterung. Bei Verwendung mit dem optionalen Level Parameter filtert die Protokollausgabe basierend auf dem Schweregrad jedes Protokolleintrags. Die optionale –s Parameter verarbeitet Binärdateien in allen Unterordnern. |
| hpctrace /? | Zeigt die Hilfe an der Eingabeaufforderung an. |
| hpctrace /help | Zeigt die Hilfe an der Eingabeaufforderung an. |
Parameter
| Parameter | Beschreibung |
|---|---|
| <Anbieter-> | Gibt den Anbieter (Quelle) der Protokolle an. Die verfügbaren Anbieter sind: mgmt - HPC-Verwaltungsdienst sche - HPC-Auftragsplanungsdienst sdm – HPC SDM Store Service diag - HPC Diagnostics Service rept - HPC Reporting Service nmgr – HPC Node Manager-Dienst msvr - HPC Monitoring Server Service mclt - HPC Monitoring Client Service brok – HPC Broker Service sdgm - HPC SOA Diag Mon Service sess – HPC-Sitzungsdienst |
| <BIN-Datei> | Gibt den Namen der zu extrahierenden Binärprotokolldatei oder -dateien an. Gilt nur für den Analyseprotokoll- Unterbefehl. Akzeptiert das * und ? Wildcards. |
| [Ebene] | Filtert optional die Protokollausgabe basierend auf dem maximalen Schweregrad jedes Protokolleintrags. Die Standardebene ist 4. Die verfügbaren Ebenen sind: 1 – Nur Fehler und Kritisch 2 – Nur Warnung, Fehler und Kritisch 3 – Nur Info, Warnung, Fehler und Kritisch 4 – Alle: Ausführlich, Info, Warnung, Fehler und kritisch |
| [-s] | Extrahiert optional Binärdateien in allen vorhandenen Unterordnern. Gilt nur für den unterbefehl Parselog |
| [-d:<Zielordner>] | Gibt optional den Pfad zum Ordner an, in den die Ausgabetextdatei oder -dateien geschrieben werden sollen. Wenn dieser Parameter für den getlog-Unterbefehl nicht angegeben ist, werden die Textdateien in den Ordner geschrieben, aus dem Sie hpctraceausgeführt haben. Wenn dieser Parameter für den Analyseprotokoll Unterbefehl nicht angegeben ist, werden die Textdateien in denselben Ordner geschrieben, in dem die Binärdateien gespeichert werden. |
Beispiele
So sammeln und extrahieren Sie die Informationen in den Protokolldateien für den HPC-Auftragsplanungsdienst, und schreiben Sie die Ausgabedateien in den aktuellen Ordner:
hpctrace getlog sche
Um die Informationen in den Protokolldateien für den HPC-Verwaltungsdienst zu sammeln und zu extrahieren, und schreiben Sie die Ausgabedateien in den ordner C:\My Logs:
hpctrace getlog mgmt -d:"C:\My Logs"
So extrahieren Sie nur Fehler- und kritische Protokolleinträge in der Binärdatei namens hpcworker_000001.bin im ordner C:\logs Ordner, und schreiben Sie die Ausgabedatei in denselben Ordner:
hpctrace parselog C:\logs\hpcworker_000001.bin 1
So extrahieren Sie alle Binärdateien, die mit "hpc" im aktuellen Ordner und in allen vorhandenen Unterordnern beginnen, und schreiben Sie jede Ausgabedatei im selben Ordner wie die entsprechende Binärdatei:
hpctrace parselog hpc*.bin -s
Hpctrace-Referenz für HPC Pack 2008 R2 und HPC Pack 2012
Startet, stoppt, abfragen, sammelt und formatiert die Ereignisablaufverfolgung für Windows (ETW)-basierte Ablaufverfolgungsprotokolle, die vom HPC-Verwaltungsdienst, HPC SDM Store Service und den HPC-Verwaltungstools generiert wurden, die die HPC-Verwaltungs-API verwenden. In HPC Pack 2012 extrahiert hpctrace auch die binären Protokolldateien, die von Windows Azure-Knoten generiert werden, und vom HPC Monitoring Server Service und dem HPC Monitoring Client Service.
Syntax
hpctrace start <provider> [file size]
hpctrace {stop|query} <provider>
hpctrace getlog <provider> <TXT file> [level]
hpctrace fmtlog <ETL file> <TXT file> [level]
hpctrace parselog <BIN file> [-s] [level]
hpctrace {/? | /help}
Unterbefehle
| Subcommand | Beschreibung |
|---|---|
| hpctrace fmtlog | Extrahiert die Informationen aus einer vorhandenen ETL-Datei (ETL) und schreibt sie in die angegebene Textdatei (.txt). Bei Verwendung mit dem optionalen Level Parameter filtert die Protokollausgabe basierend auf dem Schweregrad jedes Protokolleintrags. |
| hpctrace getlog | Erfasst das Ablaufverfolgungsprotokoll des angegebenen Anbieters (Ablaufverfolgungsquelle) und schreibt es in die angegebene Textdatei (.txt). Bei Verwendung mit dem optionalen Level Parameter filtert die Protokollausgabe basierend auf dem Schweregrad jedes Protokolleintrags. |
| hpctrace parselog | Dieser Parameter wurde in HPC Pack 2012 hinzugefügt und wird in früheren Versionen nicht unterstützt. Extrahiert die Informationen aus einer oder mehreren binären Protokolldateien (.bin) und schreibt sie in eine Textdatei (.txt) mit tabstopptrennten Werten, die in ein tabellenbasiertes Tool für die Analyse importiert werden können. Die Ausgabedatei hat denselben Namen wie die binäre Protokolldatei mit einer .log Dateierweiterung und wird im selben Ordner wie die .bin Datei gespeichert. Bei Verwendung mit dem optionalen Level Parameter filtert die Protokollausgabe basierend auf dem Schweregrad jedes Protokolleintrags. Die optionale –s Parameter verarbeitet Binärdateien in allen Unterordnern. Dieser Parameter wurde in HPC Pack 2012 eingeführt. Sie wird in früheren Versionen nicht unterstützt. |
| hpctrace-Abfrage | Zeigt Sitzungsinformationen für den angegebenen Anbieter an (Ablaufverfolgungsquelle). |
| hpctrace start | Startet eine neue Ablaufverfolgungssitzung für den angegebenen Anbieter (Ablaufverfolgungsquelle). Die generierte ETL-Datei wird in %CCP_DATA%LogFilesgespeichert. Die optionale Dateigröße Parameter gibt die maximale Größe der ETL-Datei in MB an. |
| hpctrace stop | Beendet eine vorhandene Ablaufverfolgungssitzung für den angegebenen Anbieter (Ablaufverfolgungsquelle). Wenn Sie eine Sitzung beenden und neu starten, wird die aktuelle ETL-Datei (ETL) für den Anbieter gelöscht. Wenn Sie den Inhalt einer früheren Sitzung beibehalten möchten, kopieren Sie vor dem Neustart der Sitzung die ETL-Datei an einen sicheren Ort, oder verwenden Sie den Getlog-Parameter, um ihn in eine Textdatei zu schreiben. ETL-Dateien werden in %CCP_DATA%LogFilesgespeichert. |
| hpctrace /? | Zeigt die Hilfe an der Eingabeaufforderung an. |
| hpctrace /help | Zeigt die Hilfe an der Eingabeaufforderung an. |
Parameter
| Parameter | Beschreibung |
|---|---|
| <BIN-Datei> | Gibt den Namen der zu extrahierenden Binärprotokolldatei oder -dateien an. Gilt nur für den Analyseprotokoll- Unterbefehl. Akzeptiert das * und ? Wildcards. |
| <ETL-Datei> | Gibt den Namen der zu extrahierenden ETL-Datei an. Gilt nur für den fmtlog Unterbefehl. |
| [Dateigröße] | Gibt optional die maximale Größe der ETL-Datei in MB an. Gilt nur für den start Unterbefehl. Im Allgemeinen ist die Textdatei, die aus der ETL-Datei extrahiert wird, die Hälfte der Größe der ETL-Datei. Beispielsweise generiert eine ETL-Datei mit 1 GB 500 MB formatierter Textausgabe. Sie müssen die aktuelle Protokollierungssitzung beenden und neu starten, um die Dateigröße zu ändern. Die Standardgröße beträgt 400 MB. |
| [Ebene] | Filtert optional die Protokollausgabe basierend auf dem maximalen Schweregrad jedes Protokolleintrags. Gilt für das getlog, fmtlogund Parselog Unterbefehle. Die Standardebene für die getlog und fmtlog Unterbefehle ist 4. Die Standardebene für Analyseprotokoll ist 5. Die verfügbaren Ebenen sind: 1 – Nur kritisch 2 – Fehler und kritisch 3 – Warnung, Fehler und kritisch 4 – Informationen, Warnungen, Fehler und kritisch 5 - Alle: Ausführlich, Info, Warnung, Fehler und kritisch |
| <Anbieter-> | Gibt den Anbieter (Quelle) der Ablaufverfolgungsprotokolle an. Gilt nur für die Abfrage und getlog Unterbefehle. Die verfügbaren Anbieter sind: mgmt - HPC-Verwaltungsdienst sdm – HPC SDM Store Service mapi – HPC-Verwaltungs-API (Wird verwendet, um die Ablaufverfolgung für HPC PowerShell-Sitzungen und HPC Cluster Manager anzugeben. Für alle HPC-Verwaltungs-API-Prozesse ist nur eine Ablaufverfolgungssitzung erforderlich.) |
| [-s] | Extrahiert optional Binärdateien in allen vorhandenen Unterordnern. Gilt nur für den unterbefehl Parselog |
| <TXT-Datei> | Gibt den Namen der Ausgabetextdatei an. Gilt nur für die getlog und fmtlog Unterbefehle. |
Beispiele
Verwenden Sie den folgenden Befehl, um die hpctrace-Protokolldatei mit dem Namen mgmttxt abzurufen, die Warnungen, Fehler und kritische Meldungen enthält:
hpctrace getlog mgmt mgmttxt 3
So beenden Sie eine Ablaufverfolgungssitzung für den HPC-Verwaltungsdienst, und starten Sie sie dann mit einer maximalen Dateigröße von 100 MB neu:
hpctrace stop mgmthpctrace start mgmt 100
So extrahieren Sie nur die Binärdatei mit dem Namen HpcLog_01.bin, im Ordner "C:\logs":
hpctrace parselog C:\logs\HpcLog_01.bin
So extrahieren Sie alle Binärdateien, die mit "HpcLog_0" beginnen, gefolgt von einer Zahl, im aktuellen Ordner (z. B. HpcLog_00.bin, HpcLog_01.bin, HpcLog_02.bin usw.):
hpctrace parselog HpcLog_0?.bin
So extrahieren Sie alle Binärdateien im aktuellen Ordner und in allen vorhandenen Unterordnern:
hpctrace parselog *.bin -s