此命令是在 HPC Pack 2008 R2 中引進，舊版不支援。 HPC Pack 2012 已新增功能，並在 HPC Pack 2012 中新增 Service Pack 1 （SP1）。
HPC Pack 2008 R2 和 HPC Pack 2012 的
Hpctrace 參考
HPC Pack 2012 SP1 的 Hpctrace 參考 （或更新版本）
從 HPC Pack 2012 Service Pack 1 （SP1） 開始，收集並擷取 HPC Pack 所產生的二進位記錄檔 （.bin） 中的資訊。
注意事項
若要下載和管理 Windows Azure 節點上產生的記錄檔，您可以使用 hpcazurelog 命令行工具。 然後，使用此工具中的 parselog 子命令來擷取您所下載記錄檔中的資訊。
語法
hpctrace getlog <provider> [level] [-d:<destination folder>]
hpctrace parselog <BIN file> [level] [-s] [-d:<destination folder>]
hpctrace {/? | /help}
子命令
| 子命令 | 描述 |
|---|---|
| hpctrace getlog | 收集指定提供者的二進位記錄檔，並自動執行 剖析記錄 子命令，以將其資訊擷取到文本檔中。 搭配選擇性 層級 參數使用時，會根據每個記錄專案的嚴重性來篩選記錄輸出。 |
| hpctrace parselog | 從一或多個二進位記錄檔中擷取資訊（.bin），並將它寫入具有索引標籤分隔值的文字檔，以便匯入數據表型工具進行分析。 輸出檔的名稱與二進位記錄檔相同，擴展名為 .log。 搭配選擇性 層級 參數使用時，會根據每個記錄專案的嚴重性來篩選記錄輸出。 選擇性 –s 參數會處理所有子資料夾中的二進位檔。 |
| hpctrace /？ | 在命令提示字元中顯示說明。 |
| hpctrace /help | 在命令提示字元中顯示說明。 |
參數
| 參數 | 描述 |
|---|---|
| <提供者> | 指定記錄的提供者（來源）。 可用的提供者如下： mgmt - HPC Management Service sche - HPC Job Scheduler Service sdm - HPC SDM 市集服務 diag - HPC Diagnostics Service rept - HPC Reporting Service nmgr - HPC Node Manager 服務 msvr - HPC Monitoring Server Service mclt - HPC Monitoring Client Service brok - HPC Broker 服務 sdgm - HPC SOA Diag Mon Service sess - HPC Session Service |
| <BIN 檔案> | 指定要擷取的二進位記錄檔或檔案名稱。 僅適用於 parselog 子命令。 接受 * 與 ？ 通配符。 |
| [level] | 選擇性地根據每個記錄專案的最大嚴重性來篩選記錄輸出。 默認層級為 4。 可用的層級如下： 1 - 僅限錯誤和重大 2 - 僅限警告、錯誤和重大 3 - 僅限資訊、警告、錯誤和重大 4 - 全部：詳細資訊、資訊、警告、錯誤和重大 |
| [-s] | 選擇性地擷取所有現有子資料夾中的二進位檔。 僅適用於 parselog 子命令 |
| [-d：<目的地資料夾>] | 選擇性地指定應該寫入輸出文字檔或檔案的資料夾路徑。 如果未針對 getlog 子命令指定此參數，則會將文字檔寫入您從中執行的資料夾，hpctrace。 如果未為 parselog 子命令指定此參數，則文本檔會寫入儲存二進位檔的相同資料夾。 |
範例
若要收集並擷取 HPC 作業排程器服務的記錄檔中的資訊，並將輸出檔案寫入目前資料夾：
hpctrace getlog sche
若要收集並擷取 HPC Management Service 記錄檔中的資訊，並將輸出檔案寫入 C：\My Logs 資料夾：
hpctrace getlog mgmt -d:"C:\My Logs"
若要只擷取 C：\logs 資料夾中名為 hpcworker_000001.bin 的二進位檔中的錯誤和重大記錄專案，並將輸出檔案寫入相同的資料夾中：
hpctrace parselog C:\logs\hpcworker_000001.bin 1
若要擷取目前資料夾和任何現有子資料夾中以 「hpc」 開頭的所有二進位檔，並將每個輸出檔案寫入與其對應二進位檔相同的資料夾中：
hpctrace parselog hpc*.bin -s
HPC Pack 2008 R2 和 HPC Pack 2012 的 Hpctrace 參考
啟動、停止、查詢、收集及格式化 HPC Management Service、HPC SDM Store Service 和使用 HPC 管理 API 的 HPC 管理工具所產生的 Windows 事件追蹤（ETW）型追蹤記錄。 在 HPC Pack 2012 中，hpctrace 也會擷取 Windows Azure 節點所產生的二進位記錄檔，以及 HPC Monitoring Server Service 和 HPC Monitoring Client Service。
語法
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}
子命令
| 子命令 | 描述 |
|---|---|
| hpctrace fmtlog | 從現有的 ETL 檔案 （.etl） 擷取資訊，並將它寫入指定的文字檔 （.txt）。 搭配選擇性 層級 參數使用時，會根據每個記錄專案的嚴重性來篩選記錄輸出。 |
| hpctrace getlog | 收集指定提供者的追蹤記錄檔（追蹤來源），並將它寫入指定的文本檔（.txt）。 搭配選擇性 層級 參數使用時，會根據每個記錄專案的嚴重性來篩選記錄輸出。 |
| hpctrace parselog | 此參數已在 HPC Pack 2012 中新增，在舊版中不受支援。 從一或多個二進位記錄檔中擷取資訊（.bin），並將它寫入具有製表符分隔值的文本檔（.txt），以便匯入數據表型工具進行分析。 輸出檔的名稱與二進位記錄檔同名，擴展名為 .log，並儲存在與.bin檔案相同的資料夾中。 搭配選擇性 層級 參數使用時，會根據每個記錄專案的嚴重性來篩選記錄輸出。 選擇性 –s 參數會處理所有子資料夾中的二進位檔。 此參數是在 HPC Pack 2012 中引進的。 舊版不支援。 |
| hpctrace 查詢 | 顯示指定提供者的會話資訊（追蹤來源）。 |
| hpctrace start | 啟動指定提供者的新追蹤會話（追蹤來源）。 產生的 ETL 檔案將會儲存在 %CCP_DATA%LogFiles中。 選擇性 檔案大小 參數會以 MB 為單位指定 ETL 檔案的大小上限。 |
| hpctrace stop | 停止指定提供者的現有追蹤會話（追蹤來源）。 停止並重新啟動會話將會刪除提供者目前的 ETL 檔案 （.etl）。 如果您想要保留先前會話的內容，請在重新啟動會話之前，將 ETL 檔案複製到安全的地方，或使用 getlog 參數將它寫入文字檔。 ETL 檔案會儲存在 %CCP_DATA%LogFiles中。 |
| hpctrace /？ | 在命令提示字元中顯示說明。 |
| hpctrace /help | 在命令提示字元中顯示說明。 |
參數
| 參數 | 描述 |
|---|---|
| <BIN 檔案> | 指定要擷取的二進位記錄檔或檔案名稱。 僅適用於 parselog 子命令。 接受 * 與 ？ 通配符。 |
| <ETL 檔案> | 指定要擷取的 ETL 檔名。 僅適用於 fmtlog 子命令。 |
| [檔案大小] | 選擇性地指定 ETL 檔案的大小上限，以 MB 為單位。 僅適用於啟動 子命令。 一般而言，從 ETL 檔案擷取的文字檔會是 ETL 檔案大小的一半。 例如，1 GB ETL 檔案會產生 500 MB 的格式化文字輸出。 您必須停止目前的記錄會話，然後重新啟動它，才能變更檔案大小。 默認大小為 400 MB。 |
| [level] | 選擇性地根據每個記錄專案的最大嚴重性來篩選記錄輸出。 適用於 getlog、fmtlog和 parselog 子命令。
getlog 和 fmtlog 子命令的預設層級為 4。
parselog 的預設層級為 5。 可用的層級如下： 1 - 僅限重大 2 - 錯誤和重大 3 - 警告、錯誤和重大 4 - 資訊、警告、錯誤和重大 5 - 全部：詳細資訊、資訊、警告、錯誤和重大 |
| <提供者> | 指定追蹤記錄的提供者（來源）。 僅適用於 查詢 和 getlog 子命令。 可用的提供者如下： mgmt - HPC Management Service sdm - HPC SDM 市集服務 mapi - HPC 管理 API （用來指定 HPC PowerShell 工作階段和 HPC 叢集管理員的追蹤。所有 HPC 管理 API 程式只需要一個追蹤作業階段。 |
| [-s] | 選擇性地擷取所有現有子資料夾中的二進位檔。 僅適用於 parselog 子命令 |
| <TXT 檔案> | 指定輸出文字檔的名稱。 僅適用於 getlog 和 fmtlog 子命令。 |
範例
若要擷取名為 mgmttxt 且包含警告、錯誤和重大訊息的 hpctrace 記錄檔，請使用下列命令：
hpctrace getlog mgmt mgmttxt 3
若要停止 HPC Management Service 的追蹤會話，然後將它重新啟動，檔案大小上限為 100 MB：
hpctrace stop mgmthpctrace start mgmt 100
若要只擷取名為 HpcLog_01.bin 的二進位檔，請在 C：\logs 資料夾中：
hpctrace parselog C:\logs\HpcLog_01.bin
若要擷取以 「HpcLog_0」 開頭的所有二進位檔，後面接著一個數位，請在目前資料夾中擷取 （例如，HpcLog_00.bin、HpcLog_01.bin、HpcLog_02.bin 等等）：
hpctrace parselog HpcLog_0?.bin
若要擷取目前資料夾中的所有二進位檔，以及所有現有子資料夾中：
hpctrace parselog *.bin -s