循环跟踪

项目
09/04/2008

此示例演示如何实现循环缓冲区跟踪侦听器。生产服务的一个常见方案是，拥有可以长时间使用的服务，并在较低级别启用跟踪日志记录。这些服务占用大量磁盘空间。在对某个服务进行疑难解答时，跟踪日志中的最新数据与解决问题相关。此示例演示如何实现一个循环缓冲区跟踪侦听器，在该侦听器中，磁盘上仅保留最新的跟踪数据，最多可以保存可配置的数据量。此示例基于入门示例并且包含一个自定义跟踪侦听器。

提示

本主题的末尾介绍了此示例的设置过程和生成说明。

此示例假设您熟悉跟踪和消息日志记录示例，而且已经阅读了为跟踪和消息日志记录示例提供的文档。

循环缓冲区跟踪侦听器

实现循环缓冲区跟踪侦听器所涉及的概念是：拥有两个文件，每个文件最多可以存储所需跟踪日志总数据量的一半。侦听器创建一个文件并写入该文件，直到它达到其限制（即数据大小的一半），之后侦听器将切换到第二个文件。当侦听器达到第二个文件的限制时，它会用新跟踪数据覆盖第一个文件。

此侦听器派生自 XmlWriteTraceListener 并允许用Service Trace Viewer Tool (SvcTraceViewer.exe) 查看日志。在尝试查看日志时，可以通过在服务跟踪查看器工具中同时打开这两个日志文件来方便地进行重新合并。服务跟踪查看器工具会自动负责对跟踪数据进行排序，以便它们按照正确的顺序显示。

配置

通过为侦听器和源元素添加下面的代码可以将服务配置为使用循环缓冲区跟踪侦听器。最大文件大小是通过在循环跟踪侦听器的配置中设置 maxFileSizeKB 属性来指定的。下面的代码对此进行了演示。

<system.diagnostics>
  <sources>
    <source name="System.ServiceModel" switchValue="Information,ActivityTracing" propagateActivity="true">
      <listeners>
        <add name="CircularTraceListener" />
      </listeners>
    </source>
  </sources>
  <sharedListeners>
    <add name="CircularTraceListener" type="Microsoft.ServiceModel.Samples.CircularTraceListener,CircularTraceListener" 
         initializeData="c:\logs\CircularTracing-service.svclog" maxFileSizeKB="100" />
  </sharedListeners>
  <trace autoflush="true" />
</system.diagnostics>

设置、生成和运行示例

请确保已经执行了 Windows Communication Foundation 示例的一次性安装过程。
若要生成 C# 或 Visual Basic .NET 版本的解决方案，请按照生成 Windows Communication Foundation 示例中的说明进行操作。
若要用单机配置或跨计算机配置来运行示例，请按照运行 Windows Communication Foundation 示例中的说明进行操作。

通过

循环跟踪

循环缓冲区跟踪侦听器

配置

设置、生成和运行示例

其他资源