.NET Core 下使用 Exceptionless 记录日志

ExceptionLess是一套免费开源分布式系统日志收集框架，也是我无心中发现的，支持本身部署和平台托管的方式接入使用。

• ExceptionLess官网：https://exceptionless.com
• ExceptionLess开源地址：https://github.com/exceptionless/Exceptionless
• ExceptionLess.NET客户端开源地址：https://github.com/exceptionless/Exceptionless.Net

安装

若是是本身小项目，能够直接使用托管的方式接入ExceptionLess，可是若是是公司项目仍是建议本身部署吧。

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

成功后，打开：http://localhost:5000，能够看到dashboard界面，注册帐号登陆，建立一个项目。

能够看到选择不一样的项目类型，配置方法也写的很是清楚，在 .NET Core 照着配置便可。

更多安装方式参考：https://github.com/exceptionless/Exceptionless/wiki/Self-Hosting

使用

安装 NuGet 程序包到项目中：

Install-Package Exceptionless.AspNetCore

在dashboard界面能够获得一个api密钥，和dashboard服务地址，能够放在配置文件中。

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

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    ...
    app.UseExceptionless(Configuration);
    ...
}

UseExceptionless有多个重载方法，根据须要选择，这里将IConfiguration对象传进去，获取Exceptionless配置的服务地址和api密钥。

而后在项目中随意写几个接口并访问，在dashboard界面就能够实时看到访问日志了，仍是挺方便的。

如今您的项目能够自动将全部未处理异常发送到Exceptionless了，也能够经过 ex.ToExceptionless().Submit()向Exceptionless发送已处理的异常。

更多使用方法请参考：https://github.com/exceptionless/Exceptionless.Net/wiki