hpctrace
此命令是在 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 管理服务 sche - HPC 作业计划程序服务 sdm - HPC SDM 应用商店服务 diag - HPC 诊断服务 rept - HPC Reporting Service nmgr - HPC Node Manager 服务 msvr - HPC Monitoring Server Service mclt - HPC Monitoring Client Service brok - HPC Broker Service sdgm - HPC SOA Diag Mon 服务 sess - HPC 会话服务 |
| <BIN 文件> | 指定要提取的二进制日志文件或文件的名称。 仅适用于 parselog 子命令。 接受 * 和 ？ 通配符。 |
| [level] | （可选）根据每个日志条目的最大严重性筛选日志输出。 默认级别为 4。 可用级别包括： 1 - 仅错误和严重 2 - 仅警告、错误和严重 3 - 仅信息、警告、错误和严重 4 - 全部：详细、信息、警告、错误和严重 |
| [-s] | （可选）提取所有现有子文件夹中的二进制文件。 仅适用于 parselog 子命令 |
| [-d：<目标文件夹>] | （可选）指定输出文本文件或文件应写入的文件夹的路径。 如果未为 getlog 子命令指定此参数，则文本文件将写入运行 hpctrace的文件夹。 如果未为 分析日志 子命令指定此参数，则文本文件将写入存储二进制文件的同一文件夹。 |
示例
若要收集和提取 HPC 作业计划程序服务的日志文件中的信息，并将输出文件写入当前文件夹：
hpctrace getlog sche
若要收集和提取 HPC 管理服务日志文件中的信息，并将输出文件写入 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 管理服务、HPC SDM 应用商店服务和使用 HPC 管理 API 的 HPC 管理工具生成的基于 Windows（ETW）的事件跟踪日志的格式。 在 HPC Pack 2012 中，hpctrace 还会提取 Windows Azure 节点和 HPC Monitoring Server 服务和 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中。 可选 文件大小 参数指定 ETL 文件的最大大小（以 MB 为单位）。 |
| hpctrace stop | 停止指定提供程序的现有跟踪会话（跟踪源）。 停止和重启会话将删除提供程序的当前 ETL 文件 （.etl）。 如果要保留早期会话的内容，请在重启会话之前将 ETL 文件复制到安全的位置，或使用 getlog 参数将其写入文本文件。 ETL 文件存储在 %CCP_DATA%LogFiles中。 |
| hpctrace /？ | 在命令提示符处显示帮助。 |
| hpctrace /help | 在命令提示符处显示帮助。 |
参数设置
| 参数 | 说明 |
|---|---|
| <BIN 文件> | 指定要提取的二进制日志文件或文件的名称。 仅适用于 parselog 子命令。 接受 * 和 ？ 通配符。 |
| <ETL 文件> | 指定要提取的 ETL 文件的名称。 仅适用于 fmtlog 子命令。 |
| [文件大小] | （可选）以 MB 为单位指定 ETL 文件的最大大小。 仅适用于 启动 子命令。 通常，从 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 管理服务 sdm - HPC SDM 应用商店服务 mapi - HPC 管理 API（用于指定 HPC PowerShell 会话和 HPC 群集管理器的跟踪）。所有 HPC 管理 API 进程只需要一个跟踪会话。 |
| [-s] | （可选）提取所有现有子文件夹中的二进制文件。 仅适用于 parselog 子命令 |
| <TXT 文件> | 指定输出文本文件的名称。 仅适用于 getlog 和 fmtlog 子命令。 |
示例
若要检索名为 mgmttxt 的 hpctrace 日志文件，其中包含警告、错误和关键消息，请使用以下命令：
hpctrace getlog mgmt mgmttxt 3
若要停止 HPC 管理服务的跟踪会话，然后重启其最大文件大小为 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