作者：Vishal Sood

IIS 高级日志记录可以扩展 Web 平台以支持实时分析，帮助向客户提供实时报告或与合作伙伴合作提供实时报告。 高级日志记录功能包含的一个选项可实时消耗日志条目。 此选项能聚合在每个请求期间发送给它的所有事件，日志定义属性 publishLogEvent 控制针对其他应用程序使用的情况引发实时事件。

实时日志记录是 IIS 高级日志记录中的每日志定义设置。 要为日志定义启用实时日志记录，请执行以下操作：

在 IIS 管理器中，打开高级日志记录功能。 单击“连接”窗格中的服务器，然后双击“主页”上的“高级日志记录”图标。

启用高级日志记录功能。 在“操作”窗格中，单击“启用高级日志记录”。

选择要为其启用实时日志记录的日志定义。

选中“发布实时事件”复选框，为所选日志定义启用事件的实时日志记录。

编写实时使用事件的 IIS 模块，如下节所述。

若要记录高级日志记录功能引发的实时事件，必须创建 IIS 模块。 本部分将回顾 IIS 跟踪基础结构，并在压缩的（压缩）文件夹中提供示例代码，以便创建一个可以用作引用的简单模块。

注意

示例代码仅供参考，尚未针对内存泄漏和其他问题进行测试。

本部分介绍用于记录实时事件的一些 IIS 跟踪概念。

要使用高级日志记录引发的实时事件，必须为全局事件注册创建的 IIS 模块。 对于系统引发的每个事件，应调用 OnGlobalTraceEvent 方法。 注册此方法后便可以访问实时日志记录事件。 有关详细信息，请参阅 CGlobalModule::OnGlobalTraceEvent 方法。

HTTP_TRACE_EVENT 结构构成了实时日志记录基础结构的主干。 实时日志记录信息以这种结构的形式传递。

有关此结构的详细信息，请参阅 HTTP_TRACE_EVENT 结构。

HTTP_TRACE_EVENT 结构包含一个或多个 HTTP_TRACE_EVENT_ITEM 结构，具体取决于生成日志的日志定义中包含的日志记录字段数。

有关此结构的详细信息，请参阅 HTTP_TRACE_EVENT_ITEM 结构。

HTTP_TRACE_EVENT 结构包含 pProviderGuid 属性，这是一个包含提供程序标识符的 LPCGUID。 务必了解它的重要性。

如 CAnalyticsGlobalModule::OnGlobalTraceEvent 中所述，会针对系统引发的每个事件调用 OnGlobalTraceEvent。 这意味着必须从传入事件中筛选不需要的事件，以便只有感兴趣的事件（实时日志记录事件）可供使用。 可以使用 pProviderGuid 属性值 3C729B22-F9A9-4096-92A4-07E0DDF403EB 执行此操作。

示例代码使用此值来筛选掉不需要的事件。

本部分显示演示本文前面介绍的实时日志记录概念的示例代码。 下载 CAnalyticsGlobalModule.zip，这是压缩（zip 格式）文件夹中示例代码的副本。

注意

示例代码仅供参考，尚未针对内存泄漏和其他问题进行测试。

ProcessLogEvent 方法会将日志记录数据复制到本地数据结构中，这样以后便可以使用此方法将数据推送到 Web 服务或数据库。

注意

不应处理请求本身中的数据，因为这可能会使请求对客户端的响应速度变慢。

注意

请注意 ProcessLogEvent 的代码，事件使用的内存可能是由 AllocateRequestMemory 分配的临时内存。 要取消阻止线程，应复制数据。

在本演练中，我们回顾了 IIS 高级日志记录功能中的实时日志记录的工作原理，以及如何通过创建简单的 IIS 模块来实时使用日志记录数据。