.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