Windows Communication Foundation (WCF) 服务跟踪查看器工具可以帮助你分析生成的 WCF 的诊断跟踪。 服务跟踪查看器使您能够轻松地合并、 查看和筛选日志中的跟踪消息,以便可以诊断、 修复和验证 WCF 服务问题。
配置跟踪
诊断跟踪提供的信息显示了应用程序操作过程中所发生的情况。 顾名思义,您可以从操作来源跟踪操作直至目标,也可以通过中间点进行跟踪。
你可以配置跟踪使用应用程序的配置文件 — Web 承载的应用程序的 Web.config 或Appname自承载应用程序的.config。 下面是一个示例:
<system.diagnostics>
<trace autoflush="true" />
<sources>
<source name="System.ServiceModel"
switchValue="Information, ActivityTracing"
propagateActivity="true">
<listeners>
<add name="sdt"
type="System.Diagnostics.XmlWriterTraceListener"
initializeData= "SdrConfigExample.e2e" />
</listeners>
</source>
</sources>
</system.diagnostics>
在此示例中,指定了跟踪侦听器的名称和类型。 将侦听器命名为 sdt 并作为类型添加了标准 .NET Framework 跟踪侦听器 (System.Diagnostics.XmlWriterTraceListener)。 initializeData属性用于设置为该侦听器的日志文件的名称SdrConfigExample.e2e。 对于该日志文件,还可以用一个简单文件名来替换完全限定路径。
此示例在名为 SdrConfigExample.e2e 的根目录中创建一个文件。 当您使用跟踪查看器以打开该文件中的"打开和查看 WCF 跟踪文件"部分所述时,可以看到已发送的所有消息。
跟踪级别由 switchValue 设置控制。 下表中描述了可用的跟踪级别。
| 跟踪级别 | 描述 |
|---|---|
| 严重 | -记录 Fail-fast 和事件日志条目,并跟踪相关信息。 下面是何时可使用“严重”级别的一些示例:-您的 AppDomain 由于未经处理的异常而关闭。-你的应用程序无法启动。的导致源自 MyApp.exe 进程失败消息。 |
| Error | -记录所有异常。 在下列情况下可以使用“错误”级别:-你的代码由于无效强制转换异常而崩溃。-A"无法创建终结点"异常导致应用程序以在启动时失败。 |
| 警告 | -条件存在随后可能会导致错误或严重故障。 在下列情况下可使用此级别:-应用程序正在接收多于其遏制设置允许更多的请求。-接收队列是容量的其配置的 98%。 |
| 信息 | 的生成消息有助于监视和诊断系统状态、 测量性能,或执行分析。 可以使用此类信息规划容量和管理性能。 在下列情况下可使用此级别:的消息到达 AppDomain 并反序列化后,将出现错误。的已创建 HTTP 绑定时出现故障。 |
| 详细 | 调试-级别同时针对用户代码跟踪应用程序和服务。 在下列情况下设置此级别:-您不能确定哪种方法在代码中的发生失败时调用。-你的配置不正确的终结点,该服务无法启动,因为保留存储区中的项被锁定。 |
| 活动跟踪 | 处理活动与组件之间的流事件。 此级别允许管理员和开发人员关联同一应用程序域中的各应用程序。 -活动边界跟踪: 启动/停止。-传输跟踪。 |
可以使用 add 指定要使用的跟踪侦听器的名称和类型。 在示例配置中,将侦听器命名为 sdt 并作为类型添加了标准 .NET Framework 跟踪侦听器 (System.Diagnostics.XmlWriterTraceListener)。 使用 initializeData 设置该侦听器的日志文件的名称。 此外,还可以用一个简单文件名来替换完全限定路径。
从.NET Framework 4.8,在某些高对比度主题中的组合框控件显示在正确的颜色。 可以通过删除中的以下设置来禁用此更改svcTraceViewer.exe.config文件:
<AppContextSwitchOverrides value="Switch.UseLegacyAccessibilityFeatures=false;Switch.UseLegacyAccessibilityFeatures.2=false" />
使用服务跟踪查看器工具
打开并查看 WCF 跟踪文件
服务跟踪查看器支持三种文件类型:
-
WCF 跟踪文件 (.svcLog)
-
事件跟踪文件 (.etl)
-
Crimson 跟踪文件
通过服务跟踪查看器,可以打开任何受支持的跟踪文件、添加和集成附加跟踪文件,或同时打开和合并一组跟踪文件。
打开跟踪文件
- 启动服务跟踪查看器通过使用命令窗口定位到 WCF 安装位置 (C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin),然后键入
SvcTraceViewer.exe。
Note: 服务跟踪查看器工具可与两种文件类型关联:.svclog 和 .stvproj。 在命令行中,可以使用两个参数来注册和注销文件扩展名。
/register:将文件扩展名“.svclog”和“.stvproj”注册为与 SvcTraceViewer.exe 相关联
/unregister:注销文件扩展名“.svclog”和“.stvproj”与 SvcTraceViewer.exe 的关联
-
服务跟踪查看器启动后,单击文件,然后指向打开。 定位到跟踪文件的存储位置。
-
双击要打开的跟踪文件。
NOTE 按住 Shift 的同时单击多个跟踪文件,可以同时选中并打开这些文件。 服务跟踪查看器合并所有文件的内容并显示为一个视图。 例如,可以同时打开客户端和服务的跟踪文件。 如果在配置中已启用消息日志记录和活动传播,则此功能十分有用。 通过这种方式,可以检查客户端和服务之间的消息交换。 此外可以将多个文件拖动到查看器中,或使用项目选项卡。有关详细信息,请参见“管理项目”一节。
-
若要将更多跟踪文件添加到处于打开状态的集合,请单击文件,然后指向添加。 在打开的窗口中,定位到跟踪文件的位置,然后双击要添加的文件。
Caution: 建议不要加载大于 200MB 的跟踪日志文件。 如果尝试加载大于此限制的文件,加载过程可能要花很长时间,具体情况取决于计算机资源。 服务跟踪查看器工具可能会长时间没有响应,或者该工具可能会耗尽计算机的内存。 建议配置部分加载以避免这种情况。 有关如何进行此配置的更多信息,请参见“加载大型跟踪文件”一节。
事件跟踪和 Crimson 跟踪
查看器的本机格式是 WCF 发出的活动跟踪格式。 对于以其他格式发出的跟踪,必须先进行转换,这样查看器才会显示它们。 目前,除了活动跟踪格式之外,查看器还支持事件跟踪和 crimson 跟踪。
打开不包含活动跟踪的文件时,查看器会尝试转换该文件。 必须为将包含转换后的跟踪数据的文件指定名称和位置。 数据转换完毕,查看器即会显示新文件的内容。
Note: 转换需要磁盘空间来存储转换后的跟踪数据。 开始转换之前,请确保有足够的可用磁盘空间来存储数据。 否则,转换将失败。
管理项目
查看器支持项目,以便查看多个跟踪文件。 例如,如果有客户端跟踪文件和服务跟踪文件,可以将它们添加到项目中。 之后,每次打开该项目时,都会同时加载项目中的所有跟踪文件。
有两种管理项目的方法:
-
在中文件菜单中,可以打开、 保存和关闭项目。
-
在中项目选项卡上,可以将文件添加到项目。
查看 WCF 跟踪
WCF 使用发出跟踪活动跟踪格式。 在活动跟踪模型中,各个跟踪按其目的在活动中进行分组。 逻辑控制流在活动之间传输。 例如,在应用程序的生存期中,许多“消息发送活动”会出现和消失。 太查看跟踪和活动,以及服务跟踪查看器的用户界面的详细信息,请参阅使用服务跟踪查看器查看相关跟踪和故障排除。
切换到不同视图
服务跟踪查看器提供下列不同的视图。 它们显示为选项卡上查看器中,左窗格中,还可以从访问视图菜单。
-
活动视图
-
项目视图
-
消息视图
-
图形视图
活动视图
后打开的跟踪文件,可以查看分组到活动并在显示的跟踪活动的左窗格中的视图。
活动视图显示活动名称,在活动中的跟踪数持续时间以及开始时间和结束时间。
单击所列出的任一活动,该活动中的跟踪都会显示在右侧跟踪窗格中。 然后,选择一个跟踪即可查看其详细信息。
您可以选择多个活动通过按Ctrl或Shift键并单击所需的活动。 跟踪窗格显示所选活动的所有跟踪。
你可以双击活动使其显示在Graph视图。 另一种方法是选择活动,然后切换到Graph视图。
Note: 活动"000000000000"是一个特殊活动,不能在关系图视图中显示。 因为所有其他活动都与它链接,因此显示此活动会严重影响性能。
单击列标题可以对活动列表进行排序。 包含警告跟踪的活动具有黄色背景,而包含错误跟踪的活动具有红色背景。
活动具有不同的类型,每种类型都与每个活动左侧的一个图标相对应。 要了解其含义,可以参阅“了解跟踪图标”一节。
项目视图
在此视图中,可以管理当前项目中的跟踪文件。 有关详细信息,请参见“管理项目”一节。
消息视图
此视图使你能够查看所有消息日志跟踪,包括操作,日期/时间,过程中,活动,从/到,并导航到相关联的消息日志跟踪的详细信息。 您可以分组以便更易于导航的消息流的活动边界、 进程/线程,或发送和接收消息日志跟踪。
图形视图
此视图以图表形式显示给定活动的跟踪数据。 通过图表形式,可以查看事件的逐步执行过程,可以查看当数据在多个活动之间移动时活动之间的相互关系。
若要切换到Graph视图中,选择中的活动活动查看,然后单击活动选项卡上或在消息日志跟踪消息视图。 如果加载了多个跟踪文件,并且活动涉及来自多个文件的跟踪,则所有相关的跟踪都会显示在“图形”视图中。 双击活动和消息日志跟踪也可以切换到Graph视图。
在中Graph视图中,每个垂直列表示的活动,并在列中的每个块都表示一个跟踪。 活动按进程(或线程)分组。 活动之间的小箭头表示传输。 进程之间的大箭头表示消息交换。 选定的活动始终为黄色。
在图形中选择跟踪
-
单击图形中的某个块。
-
使用向上键和向下键选择其相邻的跟踪。
-
查看“跟踪窗格”和“详细信息窗格”中的跟踪信息。
展开或折叠活动传输
当选定的活动传输到另一个活动时,可以展开活动传输。 这样可以追踪这些传输。
若要展开或折叠活动传输,
-
在传输图标左侧上找到与"+"号的传输跟踪。
-
单击"+",或按Ctrl和"+"使用键盘。
-
下一个活动出现在图形中。
-
一个"的"传输图标左侧的显示。 单击"-"号或按 Ctrl 和"-",会折叠活动传输。
Note: 当活动具有多个到它的传输时,如果展开其中一个传输,则会显示从根活动到新活动的活动。 这些新活动以折叠形式显示。 如果希望查看这些活动的详细信息,请在图形标题中单击展开图标将它们垂直展开。
垂直展开或折叠活动
查看器通过折叠活动在活动图形中隐藏不必要的详细信息。 在折叠的活动中,不会显示各个跟踪。 只会显示传输跟踪。 如果想要查看活动中的所有跟踪,可通过单击图形标题中该活动的展开符号将活动垂直展开。
若要垂直展开或折叠活动,
-
单击要将活动垂直展开的活动标头中的"+"图标。
-
请注意,所有跟踪都显示在图形中。
-
单击"-"要垂直折叠活动的活动标头中的图标。
-
请注意,活动中仅显示重要的传输、消息日志、警告和异常跟踪。
选项
你可以选择从两个选项选项关系图视图中的菜单。
-
显示活动边界跟踪:如果未选中此选项,则忽略图形中的活动边界跟踪。
-
显示非消息详细跟踪:如果未选中此选项,则忽略除消息跟踪以外的其他详细级别跟踪。 大多数情况下,详细级别的跟踪对于分析不是十分重要。 如果不希望分析详细级别的跟踪,而只想关注更重要的跟踪,则此选项十分有用。
布局模式
在查看器有两种布局模式:进程并线程。 此设置定义最大组织单位。 默认布局模式是进程,这意味着,活动分组关系图中的进程。
执行列表
从该下拉列表中,可以选择要在图形中显示的进程或线程。 例如,如果有两个客户端(A 和 B)的跟踪文件,并且打开了一个服务,而您只想在图形中显示该服务和客户端 A,则可以从列表中取消选择客户端 B。
查看跟踪详细信息
若要查看某个跟踪的详细信息,请在“跟踪”窗格中选择该跟踪。 详细信息显示在“详细信息”窗格中。
跟踪窗格
服务跟踪查看器中的右上窗格为“跟踪”窗格。 它列出了所选活动中的所有跟踪以及附加信息,例如跟踪级别、线程 ID 和进程名称。
您可以通过右击跟踪,并选择跟踪的原始 XML 复制到剪贴板复制到剪贴板的跟踪。
详细信息窗格
服务跟踪查看器的右下窗格为“详细信息”窗格。 它提供三个选项卡来查看跟踪的详细信息。
格式化视图更有条理的方式显示信息。 它以表和树的形式列出所有已知的 XML 元素,使得信息的读取和理解更加容易。
XML视图显示与所选跟踪相对应的 XML。 它支持突出显示和语法着色。 当你使用查找来搜索字符串,它会突出显示搜索结果。
消息视图消息日志跟踪中显示的 XML 的消息部分。 选择非消息跟踪时,该视图不可见。
筛选 WCF 跟踪
若要使跟踪的分析更加容易,可以通过以下方式对其进行筛选:
-
筛选器工具栏提供对预定义筛选器和自定义筛选器的访问。 可以通过启用视图菜单。
-
在查看器的预定义筛选器可用来有选择地筛选 WCF 跟踪的部分。 默认情况下,此筛选器设置为允许所有基础结构跟踪通过。 此筛选器的设置中定义筛选器选项下的子菜单视图菜单。
-
自定义 XPath 筛选器赋予用户对筛选的完全控制权。 它们可以在中定义自定义筛选器下视图菜单。
仅显示通过所有筛选器的跟踪。
使用筛选器工具栏
筛选器工具栏显示在工具的顶部。 如果不存在,则可以激活中视图菜单。 此工具栏具有三个组件:
-
查找:查找定义要查找在筛选器操作中的主题。 例如,如果你想要在进程 X 的上下文中查找已发出的所有跟踪,将此字段设置为 X 和搜索在进程名称字段。 如果选择了某个基于时间的筛选器,则此字段更改为 DateTime 选择器控件。
-
在中搜索:此字段定义要应用筛选器的类型。
-
级别:级别设置定义筛选器允许的最小跟踪级别。 例如,如果级别设置为“错误及严重错误”,则只会显示“错误”和“严重”级别的跟踪。 此筛选器与“查找”和“搜索范围”指定的条件结合使用。
筛选器现在按钮用于启动筛选器操作。 某些筛选器,尤其是当它们应用于大型数据集时,需要很长时间才能完成操作。 可以通过按取消筛选操作停止下的状态栏中显示的按钮Operations菜单。
清除按钮可重置预定义和自定义筛选器,以允许所有跟踪通过。
筛选器选项
查看器可以自动从视图中移除 WCF 跟踪。 它可以有选择地移除由 WCF 的特定区域发出的跟踪,例如,从视图中移除与事务相关的跟踪。
此筛选器的设置中定义筛选器选项下的子菜单视图菜单。
自定义筛选器
如果熟悉 XML 路径语言 (XPath),则可以使用它来构造自定义筛选器,以便搜索任何相关的 XML 元素的跟踪数据。 可以通过筛选器工具栏访问这些筛选器。
自定义筛选器可以使用参数。 此外,还可以导入预先存在的自定义筛选器。
创建自定义筛选器
可以通过两种方式创建筛选器:
使用模板向导创建自定义筛选器
可以单击现有跟踪并基于此跟踪的结构来创建筛选器。 此示例创建基于线程 ID 的自定义筛选器。
-
在查看器右上区域的跟踪窗格中,选择包含待筛选元素的跟踪。
-
单击创建自定义筛选器按钮位于跟踪窗格顶部。
-
在出现的对话框中,输入筛选器名称。 在此示例中,输入
Thread ID。 此外,还可以提供筛选器说明。 -
左侧的树视图显示你在步骤 1 中选择的跟踪记录的结构。 通过浏览找到要为其创建条件的元素。 在此示例中,浏览到位于 XPath 的 ThreadID:/E2ETraceEvent/System/Execution/@ThreadID节点。 在树视图中双击“ThreadID”属性。 这样可在对话框右侧为该属性创建一个表达式。
-
更改将 ThreadID 条件的参数字段从无到{0}。 通过这一步骤,在应用筛选器时就可以配置 ThreadID 值。 (请参见“如何应用筛选器”一节)最多可以定义四个参数。 条件是用“或”运算符组合在一起的。
-
单击确定创建筛选器。
Note: 使用模板向导创建筛选器后,只能手动对其进行编辑。 对于以前创建的筛选器,将无法激活向导。 此外,在模板向导中创建的 XPath 筛选器的条件是用“或”运算符组合在一起的。 如果需要“与”运算,可以在筛选器创建之后编辑筛选器表达式。
手动创建自定义筛选器
利用“自定义筛选器”菜单可以手动输入 XPath 筛选器。
-
在视图菜单中单击自定义筛选器菜单项。
-
在出现的对话框,单击新建。
-
至少应指定筛选器名称和 XPath 表达式。
-
单击 “确定” 。
应用自定义筛选器
创建了自定义筛选器后,可以通过筛选器工具栏来访问它。 选择你想要在应用的筛选器搜索在字段的筛选器工具栏。 对上一示例,选择“Thread ID”。
-
指定要查找中的值查找内容字段。 在此示例中,输入要搜索的线程 ID。
-
单击筛选器现在,并观察操作的结果。
如果筛选器使用多个参数,请在使用; 作为分隔符,在查找内容字段。 例如,以下字符串定义 3 个参数:1; findValue; text。 在查看器应用于"1"{0}筛选器的参数。 findValue 和文本将应用于{1}和{2}分别。
共享自定义筛选器
可以在不同会话和不同用户之间共享自定义筛选器。 可以将筛选器导出到一个定义文件,然后在另一个位置导入该文件。
导入自定义筛选器:
-
在中视图菜单上,单击自定义筛选器。
-
在打开的对话框中,单击导入按钮。
-
导航到自定义筛选器文件 (.stvcf),单击该文件,然后单击打开按钮。
导出自定义筛选器:
-
在视图菜单中单击自定义筛选器。
-
在打开的对话框中选择要导出的筛选器。
-
单击导出按钮。
-
指定的名称和位置的自定义筛选器定义文件 (.stvcf),然后单击保存按钮。
Note: 这些自定义筛选器只能从服务跟踪查看器导入和导出。 其他工具无法读取这些筛选器。
查找数据
查看器提供了以下方式来查找数据:
-
通过查找工具栏,可以快速访问最常用的查找选项。
-
“查找”对话框提供了更多查找选项。 它是可通过访问编辑菜单中,或通过快捷键 Ctrl + f。
“查找”工具栏显示在查看器的顶部。 如果不存在,则可以激活中视图菜单。 此工具栏具有两个组件:
-
查找内容:可以输入搜索关键字。
-
所示:可以输入搜索范围。 可以选择在所有活动中搜索,也可以选择仅在当前活动中搜索。
查找对话框提供两个附加选项:
-
查找目标:
-
"原始日志数据"选项会在所有原始数据中搜索关键字。
-
"XML 文本"和"XML 属性"选项仅在 XML 元素中搜索。
-
"已记录消息"选项仅在消息中搜索关键字。
-
-
忽略根活动:搜索会忽略"000000000000"活动中的跟踪。 如果根活动有数千个跟踪,而其中大多数为传输跟踪时,选择此选项会提高大型跟踪文件的性能。
定位跟踪
由于在应用程序运行时期间,跟踪是逐步记录的,因此定位跟踪有助于调试应用程序。 服务跟踪查看器提供多种定位跟踪方法。
逐步向前或逐步向后
如果在程序中行作为考虑每个跟踪,逐步向前是代码的非常类似于"逐过程"在 Visual Studio 集成开发环境 (IDE)。 区别在于,在跟踪中还可以逐步向后。 逐步向前意味着移动到活动中的下一个跟踪。
-
逐步向前:使用活动菜单中或按"F10"。 您还可以在跟踪窗格中"降低"中使用箭头键。
-
向后的步骤:使用活动菜单中或按"F9"。 您还可以在跟踪窗格中"up"中使用箭头键。
Note: 这可以帮助您的活动发生在不同进程中或者甚至不同计算机,因为 WCF 消息可以传送跨计算机的活动 Id。
追踪传输
传输跟踪是跟踪文件中的特殊跟踪。 一个活动可以通过传输跟踪而传输到另一个活动。 例如,"活动 A"可能会将传输到"活动 B"。 在这种情况下,没有传输跟踪在"活动 A"名称"到:活动"和传输图标。 此传输跟踪是两个跟踪之间的链接。 在"活动 B",还可能要将传送回"活动 A"的活动结束时的传输跟踪。 它类似于程序中的函数调用:A 调用 B,然后 B 返回。
"追踪传输"是类似于"单步执行"在调试器中。 它追踪从 A 到 B 的传输。它对其他跟踪没有任何影响。
有两种追踪传输的方法:使用鼠标或使用键盘:
-
使用鼠标:双击跟踪窗格中的传输跟踪。
-
使用键盘:选择传输跟踪,并使用"追踪传输"中活动菜单中或按"F11"
Note: 在很多情况下,当活动 A 传输到活动 B 时,活动 A 会等待,直到活动 B 传输回活动 A 为止。这意味着活动 A 在活动 B 主动跟踪期间没有记录跟踪。 但是,也有可能活动 A 不等待,而是持续记录跟踪。 此外,活动 B 还可能不传输回活动 A。因此在这个意义上,活动传输与函数调用仍有不同。 在图形视图中可以更好地理解活动传输。
跳转到下一个或上一个传输
在分析当前活动或选定的活动(如果选择了多个活动)时,可能希望快速找到它传输到的活动。 "跳转到下一个传输",可在活动中查找下一个传输跟踪。 一旦找到传输跟踪,您可以使用"追踪传输"来单步执行下一个活动。
-
跳转到下一个传输:使用活动菜单中或按"Ctrl + F10"。
-
跳转到上一个传输:使用活动菜单中或按"Ctrl + F9"。
在图形视图中定位
尽管在活动窗格和跟踪窗格中导航是类似于调试,但使用Graph视图提供了更好的体验,在导航栏中。 有关详细信息,请参阅"关系图视图"部分。
加载大型跟踪文件
跟踪文件可能非常大。 例如,如果启用跟踪,在"详细"级别,结果跟踪文件运行几分钟时间很容易就可以达到数百兆字节或更大,具体取决于网络速度和通信模式。
在服务跟踪查看器中打开极大型的跟踪文件时,系统性能可能会受到负面影响。 加载速度和加载后的响应时间可能会很慢。 实际速度不总是相同,具体取决于硬件配置。 在大多数 PC 中,如果加载大于 200M 的跟踪文件,则会严重影响性能。 对于大于 1G 的跟踪文件,此工具可能会用尽所有可用的内存,或者长时间停止响应。
为了避免慢速加载和分析大型跟踪文件中的响应时间,服务跟踪查看器提供了一个名为"部分加载",即一次仅加载跟踪的一小部分功能。 例如,您可能有一个大于 1GB 的跟踪文件,在服务器上已运行了几天。 当发生某些错误,又想分析该跟踪时,将不必打开整个跟踪文件。 您可以加载可能发生错误的某个时间段内的跟踪。 由于缩小了范围,服务跟踪查看器工具可以更快地加载文件,而您可以使用一个较小的数据集来标识这些错误。
启用部分加载
部分加载不需要手动启用。 如果试图加载的跟踪文件的总大小超过 40MB,服务跟踪查看器会自动显示“部分加载”对话框,供您选择要加载的部分。
Note: 由于跟踪在时间跨度内不一定均匀分布,因此,在“部分加载”工具栏中指定的时间段长度也不一定与显示的加载大小成正比。 实际加载大小可以小于部分加载对话框中的“估计大小”。
调整部分加载
部分加载跟踪文件之后,可能希望更改已加载的数据集。 通过调整查看器顶部的“部分加载”工具栏,可以实现此操作。
-
使用鼠标移动工具栏,或输入“开始时间”和“结束时间”。
-
单击调整按钮。
了解跟踪图标
下面是该服务跟踪查看器工具中使用的图标列表活动视图中, Graph视图并跟踪窗格中表示不同的项。
Note: 某些未分类的跟踪 (例如,"消息已关闭") 没有图标。
活动跟踪
| 图标 | 描述 |
|---|---|
| 警告跟踪 | 警告跟踪:在警告级别发出的跟踪 |
| 错误跟踪 | 错误跟踪:在错误级别发出跟踪。 |
| 活动开始跟踪: | 活动开始跟踪:标记活动开头的跟踪。 它包含活动的名称。 应用程序设计人员或开发人员应为每个进程或线程的每个活动 ID 定义一个活动“开端”跟踪。 如果活动 ID 在跟踪关联的跟踪源之间传播,随后将可看到同一活动 ID 有多个“开端”(每个跟踪源一个)。 如果为跟踪源启用了 ActivityTracing,则会发出“开端”跟踪。 |
| 活动停止跟踪 | 活动停止跟踪:标记活动结束的跟踪。 . 它包含活动的名称。 应用程序设计人员或开发人员应为每个跟踪源的每个活动 ID 定义一个活动“结尾”跟踪。 在给定跟踪源发出的活动结尾之后不会显示该跟踪源中的任何跟踪,除非跟踪时间间隔不够小。 如果发生这种情况,时间相同的两个跟踪(包括“结尾”跟踪)在显示时可能会交错。 如果活动 ID 在跟踪关联的跟踪源之间传播,将可看到同一活动 ID 有多个“结尾”(每个跟踪源一个)。 如果为跟踪源启用了 ActivityTracing,则会发出“结尾”跟踪。 |
| 活动挂起跟踪 | 活动挂起跟踪:标记将活动的时间的跟踪已暂停。 在活动继续之前,不会在挂起的活动中发出任何跟踪。 挂起的活动表示不会在该活动的跟踪源范围内进行任何处理。 “挂起”/“继续”跟踪对于进行分析十分有用。 如果为跟踪源启用了 ActivityTracing,则会发出“挂起”跟踪。 |
| 活动继续跟踪 | 活动恢复跟踪:标记在暂停后恢复活动的时间的跟踪。 可以在该活动中再次发出跟踪。 “挂起”/“继续”跟踪对于进行分析十分有用。 如果为跟踪源启用了 ActivityTracing,则会发出“继续”跟踪。 |
| Transfer | 传输:当逻辑控制流从一个活动传输到另一个时,发出跟踪。 作为传输来源的活动可以继续与作为传输目标的活动并行工作。 如果为跟踪源启用了 ActivityTracing,则会发出“传输”跟踪。 |
| 将从传输 | 将从传输:定义从另一个活动到当前活动的传输跟踪。 |
| Transfer To | 将传输到:定义逻辑控制流从当前活动到另一个活动的传输跟踪。 |
WCF 跟踪
| 图标 | 描述 |
|---|---|
| 消息日志跟踪 | 消息日志跟踪:当 WCF 消息记录的消息日志记录功能时,发出的跟踪时System.ServiceModel.MessageLogging启用跟踪源。 单击此跟踪可以显示消息。 有一条消息的四个可配置的记录点:ServiceLevelSendRequest、 TransportSend、 TransportReceive 和 ServiceLevelReceiveRequest,还可以通过指定messageSource消息日志跟踪中的属性。 |
| 消息已接收跟踪 | 消息已接收跟踪:发出的跟踪时收到 WCF 消息时,如果System.ServiceModelInformation 或 Verbose 级别启用跟踪源。 此跟踪是必需的活动中查看消息相关箭头Graph视图。 |
| 消息已发送的跟踪 | 消息已发送的跟踪:如果发送 WCF 消息时发出的跟踪System.ServiceModelInformation 或 Verbose 级别启用跟踪源。 此跟踪是必需的活动中查看消息相关箭头Graph视图。 |
活动
| 图标 | 描述 |
|---|---|
| Activity | 活动:指示当前活动为一般活动。 |
| 根活动 | 根活动:指示的根活动的进程。 |
WCF 活动
| 图标 | 描述 |
|---|---|
| 环境活动 | 环境活动:创建、 打开或关闭 WCF 主机或客户端活动。 在这些阶段中发生的错误将出现在此活动中。 |
| 侦听活动 | Listen 活动:日志跟踪与侦听器相关的活动。 可以在此活动内查看侦听器信息和连接请求。 |
| 接收字节活动 | 接收字节活动:一个与两个终结点之间的连接上接收传入字节相关的所有跟踪进行都分组的活动。 在与传播其活动 ID 的传输活动(比如 http.sys)建立关联时,此活动是必需的。 诸如中止等连接错误将出现在此活动中。 |
| 处理消息活动 | 处理消息活动:一个与创建 WCF 消息相关的跟踪进行分组的活动。 由于包装错误或消息格式不正确而导致的错误将出现在该活动中。 可以在此活动内检测消息头,以确定是否从调用方传播了活动 ID。 如果已传播,则在传输到“处理操作”活动(下一个图标)时,我们还可以为该活动分配传播的活动 ID,以便在调用方和被调用方的跟踪之间建立关联。 |
| 消息日志跟踪 | 处理操作活动:跨两个终结点与 WCF 请求相关的所有跟踪进行都分组的活动。 如果配置中两个终结点上的 propagateActivity 都设置为 true,则会将来自两个终结点的所有跟踪合并为一个活动,以便直接关联。 此类活动将包含由于传输或安全处理、延伸到用户代码边界及回退(如果存在响应)而发生的错误。 |
| 处理消息活动 | 执行用户代码活动:一个用于处理请求的用户代码跟踪进行分组的活动。 |
疑难解答
如果没有写入注册表的权限,您收到以下错误消息"未向系统注册 Microsoft 服务跟踪查看器"时使用"svctraceviewer /register"命令,注册工具。 如果出现这种情况,您应使用对注册表有写访问权限的帐户登录。
此外,服务跟踪查看器工具会将一些设置(例如,自定义筛选器和筛选器选项)写入其程序集文件夹中的 SvcTraceViewer.exe.settings 文件。 如果没有该文件的读权限,您仍然能够启动工具,但无法加载设置。
如果在打开 .etl 文件时收到错误消息“处理一个或多个跟踪时出现未知错误”,则意味着 .etl 文件的格式无效。
如果打开使用阿拉伯语操作系统创建的跟踪日志,您可能会注意到时间筛选器不起作用。 例如,2005 年对应于阿拉伯日历中的 1427 年。 但是,服务跟踪查看器工具筛选器所支持的时间范围不支持早于 1752 年的日期。 这表示您不能在筛选器中选择正确的日期。 若要解决此问题,可以创建自定义筛选器 (视图/自定义筛选器) 使用 XPath 表达式包含特定的时间范围。
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
