大网数据广告活动
.NET 与 C# 开发

配置跟踪

· 52CE 我爱测

本主题描述您可以如何启用跟踪,配置要发出跟踪的跟踪源并设置跟踪级别,设置活动跟踪和传播以支持端对端的跟踪关联,以及设置要访问跟踪的跟踪侦听器。

本主题描述您可以如何启用跟踪,配置要发出跟踪的跟踪源并设置跟踪级别,设置活动跟踪和传播以支持端对端的跟踪关联,以及设置要访问跟踪的跟踪侦听器。

有关在生产或调试环境中的跟踪设置建议,请参阅建议的设置,用于跟踪和消息日志记录。

Important: 在 Windows 8 上,您必须以提升的权限(以管理员身份运行)运行应用程序,应用程序才能生成跟踪日志。

启用跟踪

Windows Communication Foundation (WCF) 将输出诊断跟踪的以下数据:

  • 对进程里程碑的跟踪跨应用程序的所有组件,如操作调用、代码异常、警告及其他重大处理事件。

  • 跟踪功能出现故障时发生的 Windows 错误事件。 请参阅事件日志记录。

WCF 跟踪构建的xref:System.Diagnostics。 若要使用跟踪,应在配置文件或代码中定义跟踪源。 WCF 为每个 WCF 程序集定义一个跟踪源。 System.ServiceModel跟踪源的最常规的 WCF 跟踪源,并在 WCF 通信堆栈,从进入/离开传输到进入/离开用户代码记录处理里程碑。 System.ServiceModel.MessageLogging 跟踪源记录流过系统的所有消息。

默认情况下不启用跟踪。 若要激活跟踪,必须创建一个跟踪侦听器,并配置; 中设置的级别不同"关闭"状态的所选的跟踪源的跟踪级别否则,WCF 不会生成任何跟踪。 如果不指定侦听器,则会自动禁用跟踪。 如果定义侦听器,但不指定级别,则默认情况下级别将设置为“Off”,这意味着不会发出任何跟踪。

如果使用 WCF 扩展点,如自定义操作调用程序,则应发出自己的跟踪。 这是因为如果实现了扩展点,WCF 不再发出标准跟踪中的默认路径。 如果未通过发出跟踪实现手动跟踪支持,则可能看不到预期跟踪。

可以通过编辑应用程序的配置文件(对于 Web 承载的应用程序,为 Web.config;对于自承载的应用程序,为 Appname.exe.config)来配置跟踪。 下面的示例演示如何进行这样的编辑。 有关这些设置的详细信息,请参阅"配置跟踪侦听器要使用跟踪"部分。

<configuration>  
   <system.diagnostics>  
      <sources>  
            <source name="System.ServiceModel"   
                    switchValue="Information, ActivityTracing"  
                    propagateActivity="true">  
            <listeners>  
               <add name="traceListener"   
                   type="System.Diagnostics.XmlWriterTraceListener"   
                   initializeData= "c:\log\Traces.svclog" />  
            </listeners>  
         </source>  
      </sources>  
   </system.diagnostics>  
</configuration>  

Note: 若要编辑的 Visual Studio 中的 WCF 服务项目的配置文件,右键单击应用程序的配置文件 — 的 Web 承载的应用程序,则为 Appname.exe.config 中的自托管应用程序的 Web.config解决方案资源管理器. 然后选择编辑 WCF 配置上下文菜单项。 这将启动配置编辑器工具 (SvcConfigEditor.exe),这样您就可以修改使用图形用户界面的 WCF 服务的配置设置。

配置要发出跟踪的跟踪源

WCF 定义每个程序集的跟踪源。 在程序集中生成的跟踪由为该跟踪源定义的侦听器访问。 定义下列跟踪源:

  • System.ServiceModel:记录所有阶段的 WCF 处理,每当读取配置,在传输过程中处理消息,安全处理一条消息调度在用户代码中,依次类推。

  • System.ServiceModel.MessageLogging:记录流过系统的所有消息。

  • System.IdentityModel。

  • System.ServiceModel.Activation。

  • System.IO.Log:.NET Framework 接口对公用日志文件系统 (CLFS) 日志记录功能。

  • System.Runtime.Serialization:日志读取或写入对象时。

  • CardSpace。

可以将每个跟踪源配置为使用相同(共享)的侦听器,如下面的配置示例中所示。

<configuration>  
    <system.diagnostics>  
        <sources>  
            <source name="System.ServiceModel"   
                    switchValue="Information, ActivityTracing"  
                    propagateActivity="true">  
                <listeners>  
                    <add name="xml" />  
                </listeners>  
            </source>  
            <source name="CardSpace">  
                <listeners>  
                    <add name="xml" />  
                </listeners>  
            </source>  
            <source name="System.IO.Log">  
                <listeners>  
                    <add name="xml" />  
                </listeners>  
            </source>  
            <source name="System.Runtime.Serialization">  
                <listeners>  
                    <add name="xml" />  
                </listeners>  
            </source>  
            <source name="System.IdentityModel">  
                <listeners>  
                    <add name="xml" />  
                </listeners>  
            </source>  
        </sources>  
  
        <sharedListeners>  
            <add name="xml"  
                 type="System.Diagnostics.XmlWriterTraceListener"  
                 initializeData="c:\log\Traces.svclog" />  
        </sharedListeners>  
    </system.diagnostics>  
</configuration>  

另外,还可以添加用户定义的跟踪源来发出用户代码跟踪,如下面的示例所示。

<system.diagnostics>  
   <sources>  
       <source name="UserTraceSource" switchValue="Warning, ActivityTracing" >  
          <listeners>  
              <add name="xml"  
                 type="System.Diagnostics.XmlWriterTraceListener"  
                 initializeData="C:\logs\UserTraces.svclog" />  
          </listeners>  
       </source>  
   </sources>  
   <trace autoflush="true" />   
</system.diagnostics>  

有关创建用户定义的跟踪源的详细信息,请参阅扩展跟踪。

配置要使用跟踪的跟踪侦听器

在运行时,WCF 为处理的数据的侦听器馈送跟踪数据。 WCF 提供了几个预定义的侦听器xref:System.Diagnostics,其用于输出的格式有所不同。 您也可以添加自定义侦听器类型。

可以使用 add 指定要使用的跟踪侦听器的名称和类型。 在示例配置中,将侦听器命名为 traceListener 并添加了标准 .NET Framework 跟踪侦听器 (System.Diagnostics.XmlWriterTraceListener) 作为要使用的类型。 可以为每个源添加任意数目的跟踪侦听器。 如果跟踪侦听器发出对文件的跟踪,则您必须在配置文件中指定输出文件的位置和名称。 通过将 initializeData 设置为该侦听器的文件名称来完成此操作。 如果不指定文件名,则会基于所用的侦听器类型生成一个随机文件名。 如果使用 xref:System.Diagnostics.XmlWriterTraceListener,则会生成不带扩展名的文件名。 如果实现自定义侦听器,则也可以使用此属性来接收除文件名以外的初始化数据。 例如,可以为此属性指定数据库标识符。

可以将自定义跟踪侦听器配置为在网络上发送跟踪,例如,发送到远程数据库。 作为应用程序部署人员,您应对远程计算机上的跟踪日志施加适当的访问控制。

您也可以通过编程方式配置跟踪侦听器。 有关详细信息,请参阅如何:创建和初始化跟踪侦听器并创建自定义 TraceListener。

Caution: 由于 System.Diagnostics.XmlWriterTraceListener 不是线程安全的,因此,跟踪源可能会在输出跟踪时以独占方式锁定资源。 当多个线程输出对配置为使用此侦听器的跟踪源的跟踪时,可能会出现资源争用,这会致使重大的性能问题。 若要解决此问题,应实现一个线程安全的自定义侦听器。

跟踪级别

跟踪级别由跟踪源的 switchValue 设置控制。 下表中描述了可用的跟踪级别。

跟踪级别 被跟踪事件的特性 被跟踪事件的内容 被跟踪事件 用户目标
Off 不适用 不适用 不发出任何跟踪。 不适用
严重 "负"事件: 表示意外的处理或错误条件的事件。 将记录包括下列各项的未经处理的异常: - OutOfMemoryException-ThreadAbortException (CLR 调用任何 ThreadAbortExceptionHandler)-StackOverflowException (无法捕获)- ConfigurationErrorsException- SEHException-应用程序启动错误-故障快速报警事件-系统挂起-有害消息: 消息会导致应用程序失败的跟踪。 管理员 应用程序开发人员
Error "负"事件: 表示意外的处理或错误条件的事件。 已发生意外处理。 应用程序未能执行预期的任务。 然而,应用程序仍处于开启状态并在运行。 记录所有异常。 管理员 应用程序开发人员
警告 "负"事件: 表示意外的处理或错误条件的事件。 可能的问题已经出现或可能出现,但是,应用程序仍在正常工作。 不过,该应用程序可能不会继续正常工作。 -应用程序正在接收比其遏制设置所允许的更多请求。-接收队列即将达到其最大配置的容量。已超过超时。-凭据被拒绝。 管理员 应用程序开发人员
信息 "正"事件: 事件成功里程碑进行标记 应用程序执行的重要和成功里程碑,而不考虑该应用程序是否工作正常。 通常,生成对监视和诊断系统状态、测量性能或执行分析十分有用的消息。 可以使用此类信息规划容量和管理性能: 的创建通道。创建终结点侦听器。消息进入/离开传输。检索安全令牌。读取配置设置。 管理员 应用程序开发人员 产品开发人员。
详细 "正"事件: 事件成功里程碑进行标记。 发出用户代码和服务的低级别事件。 通常,可以使用此级别进行调试或应用程序优化。 -已理解消息头。 管理员 应用程序开发人员 产品开发人员。
活动跟踪 处理活动与组件之间的流事件。 此级别允许管理员和开发人员关联同一应用程序域中的各应用程序: -活动边界,如启动/停止跟踪。-传输跟踪。 全部
全部 应用程序可能工作正常。 发出所有事件。 先前的所有事件。 全部

从“详细”到“严重”的级别彼此堆叠,即每个跟踪级别都包括其上除“禁用”级别以外的所有级别。 例如,在“警告”级别进行侦听的侦听器会接收到“严重”、“错误”和“警告”跟踪。 “全部”级别包括从“详细”到“严重”的事件以及活动跟踪事件。

Caution: “信息”、“详细”和“ActivityTracing”级别会生成大量跟踪,这可能会对消息吞吐量产生不利影响(如果计算机上的所有可用资源均已用尽)。

配置用于关联的活动跟踪和传播

为 activityTracing 属性指定的 switchValue 值用于启用活动跟踪,这会在终结点内发出活动边界跟踪和传输跟踪。

Note: 当在 WCF 中使用的某些扩展功能时,可能会收到xref:System.NullReferenceException时启用活动跟踪。 要解决此问题,请检查应用程序配置文件,并确保跟踪源的 switchValue 属性未设置为 activityTracing。

propagateActivity 属性指示是否应将活动传播到参与消息交换的其他终结点。 将此值设置为 true 后,可以获取由任意两个终结点生成的跟踪文件,然后观察某一终结点上的一组跟踪是如何流向另一终结点上的一组跟踪的。

有关活动跟踪和传播的详细信息,请参阅传播。

这两propagateActivity和ActivityTracing布尔值均适用于 System.ServiceModel TraceSource。 ActivityTracing值还适用于任何跟踪源,包括 WCF 或用户定义的。

不能将 propagateActivity 属性与用户定义的跟踪源一起使用。 对于用户代码活动 ID 传播,请确保未设置 ServiceModel ActivityTracing,而同时仍将 ServiceModel propagateActivity 属性设置为 true。

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。