一个日志框架的开源，有些不错的创意。

题外篇

曾经有段时间，在公司维护IBM ds8000系统，就是服务器。当时的工作就是分析系统的日志，查看是否有运行错误。虽然有一些脚本分析工具，但是一旦发生了问题，还是靠人力，任何工具都没有用。

当时，如果发现了问题，首先就是把最近的打包日志下载到公司的ftp，然后打开一个pad,找问题发生的时间的所有相关日志，帖在一起。

如果没有经验，就会把所有模块的日志都帖在一起，慢慢看，那简直就是sb了。有经验的工程师，就会先分析有可能出现问题的模块，然后解压日志再合并查看。

当时觉得这样的工作非常的无聊，但是又没有好的思路。现在，总算给我找到解决方法了。

前言

本框架参考了 Microsoft.Enterprise.lib, log4net,同时集成了一些比较先进的日志思想和技术，能够方便程序开发以及后期的维护。

与此技术相关的讨论区在：

http://groups.google.com/group/pixysoft

优势与特点

1. 伪XML技术（Pesudo XML）：使用伪xml结构记录日志，实现了日志的结构化存储。同时对.net的xml操作部分全部重写，使io性能接近文件流的处理，既摒弃了xml结构化带来的性能问题，又不丧失xml的结构化存储、查询的特性。
2. 并行日志技术（Parallel Logging）：采用了AOP技术，能够对某一类的入口、出口、异常进行全方位跟踪，并且记录输入参数、传出参数；实现代码运行与日志记录的平行（我称其为 Parallel Logging， 并行日志技术）。使用此技术，在项目开发中能够得心应手。
3. 异常报告技术（Exception Report）：当发生异常的时候，能够查询程序调用的堆栈，并且收集此调用过程中相关的其他日志，进行日志合并，更加方便系统debug。
4. 日志查询技术（Log Searching）：支持时间段查询、日志主键查询、日志级别查询；支持跨文件查询；支持不同模块日志合并查询，查询性能接近文件流操作。

日志片段展示

以下是一个正常的日志记录：

<log level="info" time="2009-11-28 23:33:06:906" id="7cb203b2-b9c9-4818-aa59-4efd8ccec464">
hello
</log>

以下是关于异常的日志记录，能够捕获所有调用的堆栈：

<log level="fatal" time="2009-11-28 23:36:39:437" id="339b4e11-a2f2-48c5-b6e3-f15754b36310">
<message>
hello
</message>
<frame class="Pixysoft.OpenSource.Logs.TestDriven.Hello" method="Helloworld" dll="Pixysoft.OpenSource.Logs.TestDriven.dll" file="E:\xxxx\xxxx\develop\Pixysoft.OpenSource.Logs\Pixysoft.OpenSource.Logs.TestDriven\testcase.cs" line="50" column="13" id="339b4e11-a2f2-48c5-b6e3-f15754b36310"/>
<frame class="System.Runtime.Remoting.Messaging.Message" method="Dispatch" dll="mscorlib.dll" file="" line="0" column="0" id="339b4e11-a2f2-48c5-b6e3-f15754b36310"/>
<frame class="System.Runtime.Remoting.Messaging.StackBuilderSink" method="SyncProcessMessage" dll="mscorlib.dll" file="" line="0" column="0" id="339b4e11-a2f2-48c5-b6e3-f15754b36310"/>
</log>

一段并行日志记录：

<log level="info" time="2009-11-27 23:59:17:843" id="6651d0f8-cc6d-498a-a3ba-2431dedfb844">
Pixysoft.Framework.Logs.dll::Pixysoft.Framework.Logs._testdriven.Hello.Helloworld(String para1, Hello para2, String[] paras3)
::para1 = null;
::para2 = null;
::paras3 = System.String[].Count = 0;

</log>

演示代码

using System;
using System.Collections.Generic;
using System.Text;

namespace Pixysoft.OpenSource.Logs.TestDriven
{
    public class testcase
    {
        /// <summary>
        /// summary:
        /// 测试写入日志
        /// 
        /// output: 
        /// 在debug目录下面出现helloworld的目录，里面有helloworld.log的日志
        /// </summary>
        public void test001()
        {
            for (int i = 0; i < 1000; i++)
            {
                Console.WriteLine(Logger.Instances["helloworld"].Info("hello"));
            }
        }


        /// <summary>
        /// summary:
        /// 测试aop日志+Exception的记录
        /// 
        /// output:
        /// 1. Hello.Nick可以显示，但是Helloworld不能显示。
        /// 2. 所有调用过程全部记录在debug/helloworld-aop目录的helloworld-aop.log里面
        /// 3. Exception的所有调用堆栈信息都被记录
        /// </summary>
        public void test002()
        {
            Console.WriteLine(new Hello().Nick());

            try
            {
                Console.WriteLine(new Hello().Helloworld("1", new Hello(), "2", "3"));
            }
            catch (Exception ex)
            {
            }
        }


        /// <summary>
        /// summary:
        /// 测试注册
        /// 
        /// output:
        /// 在debug/log目录下，出现.log文件，记录了当前模块的注册信息
        /// </summary>
        public void test003()
        {
            Logger.Instances["hello"].Register();
        }


        /// <summary>
        /// summary:
        /// 测试日志的查询
        /// 
        /// output:
        /// 正确显示日志HELLOWORLD的查询结果
        /// </summary>
        public void test004()
        {
            ILogCommand command = Logger.Instance["HELLOWORLD"].CreateCommand();

            command.Range.From = DateTime.Parse("2009-11-27 23:58:27");

            //command.Range.To = DateTime.Now.AddDays(10);

            command.Level = LogLevel.ALL;

            command.CrossFiles = false;

            ILogDocument docs = command.ExecuteReader();

            //command.SerializeReader();

            Console.WriteLine(docs.Serialize());

            foreach (ILogRecord record in docs.Records)
            {
                Console.WriteLine(record.Id);
                Console.WriteLine(record.Date);
                Console.WriteLine(record.Level);
                Console.WriteLine(record.Text);
                Console.WriteLine(record.Ip);

                foreach (ILogFrame frame in record.Frames)
                {
                    Console.WriteLine(frame.Dll);
                    Console.WriteLine(frame.Class);
                    Console.WriteLine(frame.File);
                    Console.WriteLine(frame.Path);
                    Console.WriteLine(frame.Line);
                    Console.WriteLine(frame.Column);
                }
            }
        }


        /// <summary>
        /// summary:
        /// 测试根据id获取日志的信息
        /// 
        /// output:
        /// 成功获取日志helloworld信息
        /// </summary>
        public void test005()
        {
            ILogRecord record = Logger.Instances["helloworld"].GetRecord("7cb203b2-b9c9-4818-aa59-4efd8ccec464", false);

            Console.WriteLine(record.Text);
        }


        /// <summary>
        /// summary:
        /// 测试生成报告
        /// 
        /// output:
        /// 获取日志id对应的日志的报告
        /// </summary>
        public void test006()
        {
            ILogReport report = Logger.Instances["helloworld"].GetReport("7cb203b2-b9c9-4818-aa59-4efd8ccec464", 20);

            Console.WriteLine("report record id = " + report.Id);
            Console.WriteLine("report record timespan = " + report.TimeSpan);
            Console.WriteLine("report record timefrom = " + report.TimeFrom);
            Console.WriteLine("report record timeto = " + report.TimeTo);
            Console.WriteLine("report record createdate = " + report.CreateDate);
            Console.WriteLine("report document.record.count = " + report.Document.Records.Count);
            Console.WriteLine("report framedocument.count = " + report.FrameDocuments.Length);
        }

    }

    [Logger("helloworld-aop")]
    class Hello : ContextBoundObject
    {
        public string Helloworld(string para1, Hello para2, params string[] paras3)
        {
            throw new Exception("hello");
        }

        public string Nick()
        {
            return "1";
        }

    }
}

测试代码下载

http://www.boxcn.net/shared/r34b6299p9

核心技术说明

日志系统最关键的就是效率，xml虽然实现了结构化的存储，但是性能非常的差。

考虑到日志的特性：增量追加＋不修改，我就使用了伪xml技术去提高xml的存储、读取性能。

• xml的存储直接使用了File.Open(xxx,Mode.Append)，因此性能 == 文件流的操作
• xml的读取使用xmlreader，因此又~=文件流的操作

开源说明

编译后的代码可以随意使用，没有任何的使用限制。

为了保证源码质量，如果希望加入开发小组，获取源码，符合以下2点的即可：

• 在博客园、csdn的博龄大于1年。
• 针对本框架，提出您的改进方案，方案要求可行、有简要的技术实现。 

请在以下讨论区提交您的改进方案。

• http://groups.google.com/group/pixysoft

我们根据您的需求，提供svn进行源码下载，维护。

技术联系

reborn_zhang@hotmail.com

http://zc22.cnblogs.com/