在 “日志会话参数选项 ”选项卡中,可以指定跟踪会话的变量功能的值。
创建跟踪会话时,可以设置和更改以下选项的值。 跟踪会话运行时,可以更改多个选项。 “日志会话参数选项”对话框中无法更改的选项显示为灰色(“灰显”)。
标志
指定跟踪提供程序的 跟踪标志 。 跟踪标志确定提供程序生成的跟踪消息。 标志的含义由每个提供程序独立确定。
如果 TraceView 可以找到提供程序的 跟踪消息控件 (.tmc) 文件 ,则可以从“ 跟踪标志和级别选择 ”对话框中显示的列表中选择标志和级别。 若要打开“跟踪标志和级别选择”对话框,请单击“日志会话参数选项”对话框中标志或级别选项的 SET 值。
刷新时间 (S)
指定将跟踪会话缓冲区刷新到跟踪日志或 TraceView 显示的频率(以秒为单位)。 默认值为 1(秒)。
除了缓冲区已满时自动发生的刷新外,还会发生这些强制刷新。 值为 0 表示没有强制刷新。
若要每秒刷新的频率超过一次,请使用 “缓冲区大小 ”选项来减小每个缓冲区的大小。
可以在跟踪会话运行时更改 刷新时间 值。
最大缓冲区数
指定为跟踪会话分配的最大缓冲区数。
默认值由处理器数、物理内存量和所使用的作系统确定。 可以在跟踪会话运行时更改此值。
最小缓冲区
指定最初分配用于存储跟踪消息的缓冲区数。
当缓冲区已满时,将分配更多缓冲区,直到缓冲区数达到 “最大缓冲区” 选项中指定的值。 默认值由处理器数、物理内存量和正在使用的作系统确定。 在跟踪会话运行时,无法更改此值。
缓冲区大小
指定为跟踪会话分配的每个缓冲区的大小(以 KB 为单位)。 默认值由处理器数、物理内存量和正在使用的作系统确定。 在跟踪会话运行时,无法更改此值。
衰减时间(分钟)
指定在释放前保留未使用的跟踪缓冲区的时间(以分钟为单位)。 默认值为 15。 此选项的值显示在跟踪会话列表的“年龄”列中。
此参数仅在 Windows 2000 上有效。 在跟踪会话运行时,无法更改此值。
圆形缓冲区大小(MB)
指定跟踪缓冲区是循环的,并指定每个缓冲区的最大大小(以 MB 为单位)。
当循环缓冲区已满时,新的跟踪消息将写入缓冲区的开头,覆盖最早的跟踪消息。 默认情况下,跟踪缓冲区是连续的,而不是循环的。
在跟踪会话运行时,无法更改此值。
顺序缓冲区大小(MB)
指定跟踪缓冲区是否按顺序排列,并指定每个缓冲区的最大大小(以 MB 为单位)。
当顺序缓冲区已满时,跟踪消息将写入另一个缓冲区或丢失。 默认情况下,跟踪缓冲区是顺序的,而不是循环的,每个缓冲区为 200 MB。
在跟踪会话运行时,无法更改此值。
缓冲区大小达到 (MB) 时新建文件
每当现有日志达到指定值时,创建一个新的跟踪日志文件(.etl)。 该值指定每个日志文件的最大大小(以 MB 为单位)。
此选项的值显示在跟踪会话列表的“新建文件”列中。
仅当提供程序生成跟踪日志(即在日志会话选项页上选择了“日志跟踪事件数据到文件”选项时)时,此选项才有效。 此选项对循环缓冲区或 NT 内核记录器跟踪会话中的日志没有影响。 Windows 2000 不支持它。
使用全局序列号
为每个跟踪消息生成一个全局序列号。
全局序列号对于计算机上的所有跟踪会话都是唯一的。 此选项的默认值为 FALSE。
Windows 2000 不支持此选项,对 NT 内核记录器跟踪会话中的日志没有影响。
使用本地序列号
为每个跟踪消息生成本地序列号。 默认值 TRUE。
本地序列号在跟踪会话中是唯一的。
Windows 2000 不支持此选项,对 NT 内核记录器跟踪会话中的日志没有影响。
水平
指定跟踪提供程序的 跟踪级别 。 跟踪级别确定提供程序生成的跟踪消息。 级别值的含义由每个提供程序独立确定。 通常,它表示细节层次的不断增加。
如果 TraceView 可以找到提供程序的 跟踪消息控件 (.tmc) 文件 ,则可以从“ 跟踪标志和级别选择 ”对话框中显示的列表中选择标志和级别。 若要打开“跟踪标志和级别选择”对话框,请单击“日志会话参数选项”对话框中标志或级别选项的 SET 值。
有关跟踪级别的详细信息,请参阅 Microsoft Windows SDK 中 EnableTrace 函数的 EnableLevel 参数的说明。
WinDbg
除了在 TraceView 窗口中显示跟踪消息外,还会将跟踪消息重定向到 KD 或 WinDbg(无论启用哪种情况)。 此选项还将缓冲区大小设置为 3 KB,即 WinDbg 允许的最大大小。 “ 缓冲区大小 ”选项显示的值将被忽略。
若要在调试器中显示跟踪消息,wmitrace.dll 和 traceprt.dll 必须位于主计算机上的调试器的搜索路径中。 这些 DLL 也包含在 Windows 调试工具 中,若要使调试器能够查找 跟踪消息的跟踪消息格式(.tmf)文件 ,TMF 文件必须位于主计算机上的调试器的搜索路径中。 若要设置调试器的搜索路径,请使用 !wmitrace.searchpath 专用调试器扩展或设置 %TRACE_FORMAT_SEARCH_PATH% 环境变量的值。 有关 WinDbg 和 WMI 跟踪扩展的信息,请参阅适用于 Windows 的调试工具。
忽略 TraceView
抑制由 TraceView 操作产生的跟踪信息。
虚拟文件大小
指示 TraceView 在开始覆盖最早的消息以腾出新消息空间之前存储的最大跟踪消息数。
值为 0 表示没有最大值。 TraceView 会保留所有消息,并且永远不会覆盖它们。 此选项的默认值 65536 是大多数系统建议的值。 较大的值可能会导致重大延迟。
此值显示在跟踪会话列表的“最大跟踪记录”列中。