.NET Core 下使用 Exceptionless 記錄日志

ExceptionLess是一套免費開源分布式系統(tǒng)日志收集框架，也是我無意中發(fā)現(xiàn)的，支持自己部署和平臺托管的方式接入使用。

• ExceptionLess官網(wǎng)：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界面，注冊賬號登錄，創(chuàng)建一個項目。

可以看到選擇不同的項目類型，配置方法也寫的非常清楚，在 .NET Core 照著配置即可。

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

使用

安裝 NuGet 程序包到項目中：

Install-Package Exceptionless.AspNetCore

在dashboard界面可以得到一個api密鑰，和dashboard服務(wù)地址，可以放在配置文件中。

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

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

UseExceptionless有多個重載方法，根據(jù)需要選擇，這里將IConfiguration對象傳進去，獲取Exceptionless配置的服務(wù)地址和api密鑰。

然后在項目中隨意寫幾個接口并訪問，在dashboard界面就可以實時看到訪問日志了，還是挺方便的。

現(xiàn)在您的項目可以自動將所有未處理異常發(fā)送到Exceptionless了，也可以通過?ex.ToExceptionless().Submit()向Exceptionless發(fā)送已處理的異常。

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