此示例演示如何实现循环缓冲区跟踪侦听器。 生产服务的一个常见方案是,拥有可以长时间使用的服务,并在较低级别启用跟踪日志记录。 这些服务占用大量磁盘空间。 在对某个服务进行疑难解答时,跟踪日志中的最新数据与解决问题相关。 此示例演示如何实现一个循环缓冲区跟踪侦听器,在该侦听器中,磁盘上仅保留最新的跟踪数据,最多可以保存可配置的数据量。 此示例基于Getting Started并包括自定义跟踪侦听器。
Note: 本主题的最后介绍了此示例的设置过程和生成说明。
此示例假定你熟悉跟踪和消息日志记录已阅读提供的文档和示例跟踪和消息日志记录示例。
循环缓冲区跟踪侦听器
实现循环缓冲区跟踪侦听器所涉及的概念是:拥有两个文件,每个文件最多可以存储所需跟踪日志总数据量的一半。 侦听器创建一个文件并写入该文件,直到它达到其限制(即数据大小的一半),之后侦听器将切换到第二个文件。 当侦听器达到第二个文件的限制时,它会用新跟踪数据覆盖第一个文件。
此侦听器派生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. Samples.ServiceModel.CircularTraceListener,CircularTraceListener"
initializeData="c:\logs\CircularTracing-service.svclog" maxFileSizeKB="100" />
</sharedListeners>
<trace autoflush="true" />
</system.diagnostics>
设置、生成和运行示例
-
若要生成 C# 或 Visual Basic .NET 版本的解决方案,请按照 Building the Windows Communication Foundation Samples中的说明进行操作。
-
若要在单或跨计算机配置中运行示例,请按照中的说明运行 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\CircularTracing
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
