Asp.net Core全域性異常監控和記錄日誌
前言
系統異常監控可以說是重中之重,系統不可能一直執行良好,開發和運維也不可能24小時盯著系統,系統拋異常後我們應當在第一時間收到異常資訊。在Asp.net Core裡我使用攔截器和中介軟體兩種方式來監控異常。全域性異常監控的資料最好還是寫入資料庫,方便查詢。
配置NLog
NLog配置檔案
<?xml version="1.0" encoding="utf-8"?> <nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" autoReload="true" internalLogLevel="info" internalLogFile="d:\temp\internal-nlog.txt"> <!-- the targets to write to --> <targets> <!-- write logs to file --> <target xsi:type="File" name="allfile" fileName="d:\temp\nlog-all-${shortdate}.log" layout="${longdate}|${event-properties:item=EventId.Id}|${uppercase:${level}}|${logger}|${message} ${exception}" /> <!-- another file log, only own logs. Uses some ASP.NET core renderers --> <target xsi:type="File" name="ownFile-web" fileName="d:\temp\nlog-own-${shortdate}.log" layout="${longdate}|${event-properties:item=EventId.Id}|${uppercase:${level}}|${logger}|${message} ${exception}|url: ${aspnet-request-url}|action: ${aspnet-mvc-action}" /> <!-- write to the void aka just remove --> <target xsi:type="Null" name="blackhole" /> </targets> <!-- rules to map from logger name to target --> <rules> <!--All logs, including from Microsoft--> <logger name="*" minlevel="Trace" writeTo="allfile" /> <!--Skip Microsoft logs and so log only own logs--> <logger name="Microsoft.*" minlevel="Trace" writeTo="blackhole" final="true" /> <logger name="*" minlevel="Trace" writeTo="ownFile-web" /> </rules> </nlog>
注入NLog
在Program.cs裡注入NLog依賴,新增依賴前需要匯入兩個名稱空間Microsoft.Extensions.Logging、 NLog.Web。
public class Program { public static void Main(string[] args) { CreateHostBuilder(args).Build().Run(); } public static IHostBuilder CreateHostBuilder(string[] args) => Host.CreateDefaultBuilder(args) .ConfigureWebHostDefaults(webBuilder => { webBuilder.UseStartup<Startup>(); }) .ConfigureLogging(logging=> { logging.ClearProviders(); logging.SetMinimumLevel(Microsoft.Extensions.Logging.LogLevel.Trace); }) .UseNLog(); }
攔截器
在Asp.Mvc裡最常用的攔截器,在Asp.net Core裡也是支援的。先定義攔截器,再注入攔截器,這裡自定義攔截器實現介面IExceptionFilter,介面會要求實現OnException方法,當系統發生未捕獲的異常時就會觸發這個方法。這裡全域性異常資訊最好能放入資料庫裡,方便後臺查詢,再就是拋異常後最好能給負責人發郵件和傳送報警簡訊,也可以直接撥打電話。
public class GlobalExceptionFilter : IExceptionFilter { private IWebHostEnvironment _env; private ILogger<GlobalExceptionFilter> _logger; public GlobalExceptionFilter(IWebHostEnvironment _env,ILogger<GlobalExceptionFilter> _logger) { this._env = _env; this._logger = _logger; } public void OnException(ExceptionContext context) { if (context.Exception.GetType() == typeof(BusException)) { //如果是自定義異常,則不做處理 } else { } //日誌入庫 //向負責人發報警郵件,非同步 //向負責人傳送報警簡訊或者報警電話,非同步 Exception ex = context.Exception; //這裡給系統分配標識,監控異常肯定不止一個系統。 int sysId = 1; //這裡獲取伺服器ip時,需要考慮如果是使用nginx做了負載,這裡要相容負載後的ip, //監控了ip方便定位到底是那臺伺服器出故障了 string ip = context.HttpContext.Connection.RemoteIpAddress.ToString(); _logger.LogError($"系統編號:{sysId},主機IP:{ip},堆疊資訊:{ex.StackTrace},異常描述:{ex.Message}"); context.Result = new JsonResult(ResultBody.error(ex.Message)); context.ExceptionHandled = true; } }
在Startup.ConfigureServices方法裡注入全域性異常處理攔截器。
public void ConfigureServices(IServiceCollection services)
{
services.AddControllersWithViews();
//注入全域性異常處理
services.AddMvc(option =>
{
option.Filters.Add(typeof(GlobalExceptionFilter));
});
}
OK,定義了攔截器後,我們自己拋一個未捕獲的異常試試。如圖,都會返回統一的JSON返回值。
如果未使用全域性異常捕獲,則直接丟擲如下異常
客戶端丟擲異常後,可檢視磁碟寫入日誌,這裡看到我關注的系統編號,主機ip,堆疊資訊和異常描述資訊。
中介軟體
定義中介軟體,定義中介軟體時先匯入日誌名稱空間Microsoft.Extensions.Logging。
public class GlobalExceptionMiddleware
{
private readonly RequestDelegate next;
private ILogger<GlobalExceptionMiddleware> logger;
public GlobalExceptionMiddleware(RequestDelegate next, ILogger<GlobalExceptionMiddleware> logger)
{
this.next = next;
this.logger = logger;
}
public async Task Invoke(HttpContext context)
{
try
{
await next.Invoke(context);
}
catch (Exception ex)
{
await HandleExceptionAsync(context, ex);
}
}
private async Task HandleExceptionAsync(HttpContext context, Exception e)
{
if (e.GetType() == typeof(BusException))
{
//如果是自定義異常,則不做處理
}
else
{
}
//記日誌
int sysId = 1;
string ip = context.Connection.RemoteIpAddress.ToString();
logger.LogError($"系統編號:{sysId},主機IP:{ip},堆疊資訊:{e.StackTrace},異常描述:{e.Message}");
string result = System.Text.Json.JsonSerializer.Serialize(ResultBody.error(e.Message));
await context.Response.WriteAsync(result);
}
}
在Startup.Configure方法裡註冊中介軟體。
public void Configure(IApplicationBuilder app, IWebHostEnvironment env,ILoggerFactory loggerFactory)
{
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
else
{
app.UseExceptionHandler("/Home/Error");
}
//註冊異常處理中介軟體
app.UseMiddleware<GlobalExceptionMiddleware>();
app.UseStaticFiles();
app.UseRouting();
app.UseAuthorization();
app.UseEndpoints(endpoints =>
{
endpoints.MapControllerRoute(
name: "default",
pattern: "{controller=Home}/{action=Index}/{id?}");
});
}
中介軟體這裡處理異常最後向客戶端響應寫入了一個字串,這是個攔截器處理方式不同的地方。當然對客戶端或者前端來說還是JSON物件更直觀些。
參考連結
https://www.cnblogs.com/suizhikuo/p/8822352.html
https://www.cnblogs.com/viter/p/10013195.html
https://www.jianshu.com/p/cab597211