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

跟踪和消息日志记录

· 52CE 我爱测

本示例演示如何启用跟踪和消息日志记录。 生成的跟踪和消息日志使用查看Service Trace Viewer Tool (SvcTraceViewer.exe)。 此示例基于Getting Started。

本示例演示如何启用跟踪和消息日志记录。 生成的跟踪和消息日志使用查看Service Trace Viewer Tool (SvcTraceViewer.exe)。 此示例基于Getting Started。

Note: 本主题的最后介绍了此示例的设置过程和生成说明。

跟踪

Windows Communication Foundation (WCF) 使用中定义的跟踪机制xref:System.Diagnostics命名空间。 在此跟踪模型中,由应用程序实现的跟踪源生成跟踪数据。 每个源均由名称进行标识。 跟踪使用程序会创建针对要为其检索信息的跟踪源的侦听器。 若要接收跟踪数据,您必须创建针对该跟踪源的侦听器。 在 WCF 中,这可以通过将以下代码添加到服务的或客户端的配置文件,通过设置服务模型跟踪源switchValue:

<system.diagnostics>  
    <sources>  
      <source name="System.ServiceModel" switchValue="Information,ActivityTracing"  
        propagateActivity="true">  
        <listeners>  
          <add name="xml" />  
        </listeners>  
      </source>  
      <source name="System.ServiceModel.MessageLogging">  
        <listeners>  
          <add name="xml" />  
        </listeners>  
      </source>  
    </sources>  
    <sharedListeners>  
      <add initializeData="C:\logs\TracingAndLogging-service.svclog" type="System.Diagnostics.XmlWriterTraceListener"  
        name="xml" />  
    </sharedListeners>  
    <trace autoflush="true" />  
</system.diagnostics>  

有关跟踪源的详细信息,请参阅中的跟踪源节配置跟踪主题。

活动跟踪和传播

无ActivityTracing已启用并propagateActivity设置为true中system.ServiceModel客户端和服务的跟踪源提供跨终结点 (中的活动关联的处理 (活动) 的逻辑单位内的跟踪通过活动传输),并在跨越多个终结点 (通过活动 ID 传播) 的活动。

这三种机制(活动、传输和传播)可帮助您使用服务跟踪查看器工具更快地找到错误的根本原因。 有关详细信息,请参阅使用服务跟踪查看器查看相关跟踪和故障排除。

通过创建用户定义的活动跟踪可以扩展 ServiceModel 提供的跟踪。 用户定义的活动跟踪允许用户创建跟踪活动,以便执行下列操作:

  • 将跟踪分组到逻辑工作单元。

  • 通过传输和传播关联活动。

  • 降低 (例如,日志文件的磁盘空间成本) 的 WCF 跟踪的性能成本。

有关用户定义的活动跟踪的详细信息,请参阅扩展跟踪示例。

消息日志记录

可以启用消息日志记录,同时在客户端和服务的任何 WCF 应用程序。 若要启动消息日志记录,必须将下面的代码添加到客户端或服务:

<configuration>  
  <system.serviceModel>  
    <diagnostics>  
      <!-- Enable Message Logging here. -->  
      <!-- log all messages received or sent at the transport or service model levels -->  
      <messageLogging logEntireMessage="true"  
                      maxMessagesToLog="300"  
                      logMessagesAtServiceLevel="true"  
                      logMalformedMessages="true"  
                      logMessagesAtTransportLevel="true" />  
    </diagnostics>  
  </system.serviceModel>  
</configuration>  

记录消息时,跟踪类型取决于是在客户端还是在服务器上进行跟踪。 例如,发送到客户端的“Add”消息将在客户端的“TransportWrite”类别下跟踪,而同一消息将在服务的“TransportRead”类别下跟踪。

通过将下面的代码添加到客户端的 App.config 文件或服务的 Web.config 文件的 xref:System.Diagnostics 节,可以配置跟踪侦听器:

<system.diagnostics>  
    <sources>  
      <source name="System.ServiceModel" switchValue="Information,ActivityTracing"  
        propagateActivity="true">  
        <listeners>  
          <add name="xml" />  
        </listeners>  
      </source>  
      <source name="System.ServiceModel.MessageLogging">  
        <listeners>  
          <add name="xml" />  
        </listeners>  
      </source>  
    </sources>  
    <sharedListeners>  
      <add initializeData="C:\logs\TracingAndLogging-client.svclog" type="System.Diagnostics.XmlWriterTraceListener"  
        name="xml" />  
    </sharedListeners>  
    <trace autoflush="true" />  
  </system.diagnostics>  

消息将以 XML 格式记录在配置文件中指定的目标目录中。

Note: 如果开始时未创建日志目录,则不会创建跟踪文件。 请确保 C:\logs\ 目录存在,或在侦听器配置中指定一个替换日志记录目录。 有关更多信息,请参见本文档最后的初始安装说明。

有关消息日志记录的详细信息,请参阅配置消息日志记录主题。

设置、生成和运行示例
  1. 请确保您具有执行的 Windows Communication Foundation 示例的一次性安装过程。

  2. 运行“跟踪和消息日志记录”示例之前,创建 C:\logs\ 目录以便服务向其中写入 .svclog 文件。 此目录的名称在配置文件中定义为要记录的跟踪和消息的路径,并可以进行更改。 向用户授予对日志目录的网络服务写权限。

  3. 若要生成C#, C++,或 Visual Basic.NET 版本的解决方案,请按照中的说明生成 Windows Communication Foundation 示例。

  4. 若要在单或跨计算机配置中运行示例,请按照中的说明运行 Windows Communication Foundation 示例。

Important: 您的计算机上可能已安装这些示例。 在继续操作之前,请先检查以下(默认)目录:

<InstallDrive>:\WF_WCF_Samples

如果此目录不存在,请转到Windows Communication Foundation (WCF) 和.NET Framework 4 的 Windows Workflow Foundation (WF) 示例若要下载所有 Windows Communication Foundation (WCF) 和WF示例。 此示例位于以下目录:

<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Management\TracingAndLogging

请参阅

历史资料。此文对应 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(示例代码)

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

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