Enterprise Library: Logging and Instrumentation Application Block概述<?xml:namespace prefix = o ns = "urn:schemas-microsoft-com:office:office" />

?

Written by: Rickie Lee (rickieleemail#yahoo.com)

My blog:http://www.cnblogs.com/rickie

Enterprise Library中的Logging and Instrumentation Application Block讓記錄日志信息到不同的目的位置更加方便，新的Logging Block非常直觀并功能豐富。每個應用程序都會需要一系列logging功能，并且還需要優(yōu)雅地處理和記錄未捕獲的異常信息。本文簡單介紹了Logging and Instrumentation Application Block的功能特點。

?

Enterprise Library Logging and Instrumentation Application Block讓開發(fā)人員在應用程序集成標準的logging and Instrumentation功能，應用程序可以使用該Application Block記錄日志事件到不同的位置：

• Event Log （Windows事件日志）

• Email消息

• 數(shù)據(jù)庫

• 消息隊列（MSMQ）

• 文本文件

• WMI

?

Client-Distributor架構

Application Block主要由2部分組成：Client和Distributor。Client負責創(chuàng)建消息，這些消息將由Distributor寫入目標位置。在多數(shù)情況下，Client和Distributor在同一臺機器上，但是你也可以分離這2個部分到不同的進程或不同的機器上。

Distributor設置

Client根據(jù)分發(fā)策略（Distribution Strategies）發(fā)送消息到Distributor，在Application Block中提供了2個分發(fā)策略：In Process和MSMQ，默認是In Process策略。你可以刪除In Process strategy，然后添加MSMQ strategy。當選擇MSMQ strategy，Client需要創(chuàng)建日志消息并發(fā)送到MSMQ消息隊列。另外一個進程則等待到達的消息，并寫入合適的日志接收池（Logging Sink）。

Distributor Service

Application Block中包含一個Windows Service: MSMQ Distributor Service。當安裝該服務后，該服務會在指定的時間間隔檢測消息隊列。

?

定制Sink

在某些情況下，也許Logging and Instrumentation Application Block提供的sink（接收池）并不能滿足要求，你也可以創(chuàng)建定制的sink，如下所示：

[C#]

public class DebugSink : LogSink, IConfigurationProvider

?

[Visual Basic]

Public Class DebugSink

? Inherits LogSink

? Implements IConfigurationProvider

定制的sink需要實現(xiàn)IConfigurationProvider接口，并繼承LogSink抽象類。另外需要增加SendMessageCore方法到定制sink類中，確保實現(xiàn)必要的動作來記錄日志信息到定制的sink。

?

目錄Categories

在Logging and Instrumentation Application Block配置文件中，Distributor Settings下包含有許多目錄Categories，默認有Gereral和Trace，如下圖所示。

Logging and Instrumentation Application Block提供靈活的松耦合機制來記錄日志消息，每一個日志消息將寫入指定目錄，每一個目錄可以有0或多個目標存儲位置，目標存儲位置指向接收池（sink）和可選的格式化器。

缺省情況下，General目錄設定為default目錄，并設計將消息寫入Application事件日志。你可以通過修改Distributor Settings節(jié)點的DefaultCategory屬性值來改變缺省的目錄設置。你也可以指定缺省的Formatter格式化日志消息。

?

Formatters控制格式化輸出

使用Formatters，Logging Block允許你精確控制消息的輸出格式。Logging Block內置了一個TextFormatter的實現(xiàn)，TextFormatter使用帶Token的模板。你可以通過Configuration Console配置工具創(chuàng)建和管理你的模板。當消息準備寫入接收池（sink）時，Formatter會使用日志消息屬性值替換每一個token。如下是默認的模板（Property: Token）：

Timestamp: {timestamp}

Message: {message}

Category: {category}

Priority: {priority}

EventId: {eventid}

Severity: {severity}

Title:{title}

Machine: {machine}

Application Domain: {appDomain}

Process Id: {processId}

Process Name: {processName}

Win32 Thread Id: {win32ThreadId}

Thread Name: {threadName}

Extended Properties: {dictionary({key} - {value}

)}

Client Settings

Client Settings節(jié)點提供了一系列選項，用來控制Logging Block的行為，如LoggingEnabled用來控制Logging行為有效或失效。當Logging失效時，可以產生最少的時間開銷。CategoryFilterSettings屬性允許你配置特定目錄有效或失效（Enable or Disable），你也可以基于數(shù)字優(yōu)先級（numberic priority）來過濾日志消息。在配置設置中，你可以定義消息分發(fā)的最小優(yōu)先級閥值。具體屬性列表如下所示：

下一篇文章將演示Logging and Instrumentation Application Block的具體應用。

***

作者：Rickie Lee (rickieleemail#yahoo.com)

本文參考如下References文檔及其鏈接。

?

References:

1. Microsoft Enterprise Library, Logging and Instrumentation Application Block.

2. Logging with Enterprise Library, http://blog.hishambaz.com/archive/2005/01/30/202.aspx

3. Rickie, Microsoft patterns & practices Enterprise Library January 2005 [中文稿], http://www.cnblogs.com/rickie/archive/2005/01/30/99443.html

4. Rickie, Enterprise Library released! http://www.cnblogs.com/rickie/archive/2005/01/29/99106.html

?

轉載于:https://www.cnblogs.com/rickie/archive/2005/02/13/103983.html

總結

以上是生活随笔為你收集整理的Enterprise Library: Logging and Instrumentation Application Block概述的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內容還不錯，歡迎將生活随笔推薦給好友。