初体验-ExceptionLess+Serilog管理日志

Exceptionless 是一个开源的实时的日志收集框架，它可以应用在基于 ASP.NET，ASP.NET Core，Web Api，Web Forms，WPF，Console，MVC 等技术栈的应用程序中，并且提供了Rest接口可以应用在 Javascript，Node.js 中。它将日志收集变得简单易用并且不需要了解太多的相关技术细节及配置。

想了解更多可以查阅官网文档

https://exceptionless.com/docs/

由于公司项目中使用了Serilog组件进行记录日志。那么本文就简单的记录一下，ExceptionLess+Serilog管理日志的体验过程。

1、安装ExceptionLess

在ExceptionLess 官网文档，介绍了如何使用Docker简单部署。

由于目的只是体验，所以本文使用以下命令部署并运行

docker run --rm -it -p 5000:80 exceptionless/exceptionless:latest

2、运行起来之后，通过访问Exceptionless的页面，点击注册按钮注册一个账号，然后进行登录。

 

 

3、登录后 进入如下的界面，在两个文本框输入，组织名称以及项目名称，用来对我们的项目的异常日志进行分类管理。

 

 4、下面进入项目类型配置界面，在下拉框选择项目类型asp.net core后，出现下面的界面，说明配置完成，并且给出使用说明。到此Exceptionless的安装配置已经完成。

 

5、创建webapi项目

      5.1添加依赖 ,红框为相关的依赖

 

 

 

 5.2 配置Serilog及Exceptionless信息 

 public static void Main(string[] args)
        {
            //在这里配置Serilog，写到Exceptionless中
            Log.Logger = new LoggerConfiguration()
                //这里配置Exceptionless秘钥和地址，也可以通过读取配置文件加载
            .WriteTo.Exceptionless("78xBcc0nCATNmKnKVDvPjRp2mCdlhfXYyEm7rDIK", "http://localhost:5000",b => b.AddTags("Serilog Example"))
            .CreateLogger();

            CreateHostBuilder(args).Build().Run();
        }

        public static IHostBuilder CreateHostBuilder(string[] args) =>
            Host.CreateDefaultBuilder(args)
                .ConfigureWebHostDefaults(webBuilder =>
                {
                    webBuilder.UseStartup<Startup>();
                }).UseSerilog(); //使用Serilog

5.3 配置文件中添加Exceptionless配置项

"Exceptionless": {
"ServerUrl": "http://localhost:5000",
"ApiKey": "78xBcc0nCATNmKnKVDvPjRp2mCdlhfXYyEm7rDIK"
}}

5.4 在Startup类Configure中添加 

 app.UseExceptionless(Configuration);

5.4 最后在程序中写一些日志和抛出异常  ,Run 程序起来

6、发现Exceptionless已经记录了日志及异常信息

 

 

可以通过过滤条件查询相关的日志信息：比如查询日志等级为Error,可以通过level:Error进行过滤，更多的查询方式，通过官网https://exceptionless.com/docs/filtering-and-searching/ 了解。

 

体验完毕。更加详细信息，可以通过管理了解。