如何在.Net6 web api中記錄每次接口請(qǐng)求的日志
為什么在軟件設(shè)計(jì)中一定要有日志系統(tǒng)?
在軟件設(shè)計(jì)中日志模塊是必不可少的一部分,可以幫助開(kāi)發(fā)人員更好的了解程序的運(yùn)行情況,提高軟件的可靠性,安全性和性能,日志通常能幫我們解決如下問(wèn)題:
- 調(diào)試和故障排查:日志可以記錄程序運(yùn)行時(shí)的各種信息,包括錯(cuò)誤,異常,警告等,方便開(kāi)發(fā)人員在出現(xiàn)問(wèn)題時(shí)進(jìn)行調(diào)試和故障排查。
- 性能優(yōu)化:日志可以記錄程序的運(yùn)行時(shí)間,資源占用等信息,幫助開(kāi)發(fā)人員進(jìn)行性能優(yōu)化。
- 安全審計(jì):日志可以記錄用戶的操作行為,方便進(jìn)行安全審計(jì)和追蹤。
- 統(tǒng)計(jì)分析:日志可以記錄用戶的訪問(wèn)情況,使用習(xí)慣等信息,方便進(jìn)行統(tǒng)計(jì)分析和用戶行為研究。
- 業(yè)務(wù)監(jiān)控:日志可以記錄業(yè)務(wù)數(shù)據(jù)的變化情況,方便進(jìn)行業(yè)務(wù)監(jiān)控和數(shù)據(jù)分析。
- 數(shù)據(jù)還原:日志記錄每次請(qǐng)求的請(qǐng)求及響應(yīng)數(shù)據(jù),可以在數(shù)據(jù)丟失的情況下還原數(shù)據(jù)。
如何在.net6webapi中添加日志?
1.添加日志組件
.net6有自帶的logging組件,還有很多優(yōu)秀的開(kāi)源log組件,如NLog,serilog,這里我們使用serilog組件來(lái)構(gòu)建日志模塊。
新建.net6,asp net web api項(xiàng)目之后,為其添加如下四個(gè)包

dotnet add package Serilog.AspNetCore//核心包 dotnet add package Serilog.Formatting.Compact dotnet add Serilog.Sinks.File//提供記錄到文件 dotnet add Serilog.Sinks.MSSqlServer//提供記錄到sqlserver
2.新建SeriLogExtend擴(kuò)展類(lèi)型,配置日志格式并注入
public static class SeriLogExtend
{
public static void AddSerilLog(this ConfigureHostBuilder configureHostBuilder)
{
//輸出模板
string outputTemplate = "{NewLine}【{Level:u3}】{Timestamp:yyyy-MM-dd HH:mm:ss.fff}" +
"{NewLine}#Msg#{Message:lj}" +
"{NewLine}#Pro #{Properties:j}" +
"{NewLine}#Exc#{Exception}" +
new string('-', 50);
// 配置Serilog
Log.Logger = new LoggerConfiguration()
.MinimumLevel.Override("Microsoft", LogEventLevel.Warning) // 排除Microsoft的日志
.Enrich.FromLogContext() // 注冊(cè)日志上下文
.WriteTo.Console(outputTemplate: outputTemplate) // 輸出到控制臺(tái)
.WriteTo.MSSqlServer("Server=.;Database=testdb;User ID=sa;Password=123;TrustServerCertificate=true", sinkOptions: GetSqlServerSinkOptions(), columnOptions: GetColumnOptions())
.WriteTo.Logger(configure => configure // 輸出到文件
.MinimumLevel.Debug()
.WriteTo.File( //單個(gè)日志文件,總?cè)罩?,所有日志存到這里面
$"logs\\log.txt",
rollingInterval: RollingInterval.Day,
outputTemplate: outputTemplate)
.WriteTo.File( //每天生成一個(gè)新的日志,按天來(lái)存日志
"logs\\{Date}-log.txt", //定輸出到滾動(dòng)日志文件中,每天會(huì)創(chuàng)建一個(gè)新的日志,按天來(lái)存日志
retainedFileCountLimit: 7,
outputTemplate: outputTemplate
))
.CreateLogger();
configureHostBuilder.UseSerilog(Log.Logger); // 注冊(cè)serilog
/// <summary>
/// 設(shè)置日志sqlserver配置
/// </summary>
/// <returns></returns>
MSSqlServerSinkOptions GetSqlServerSinkOptions()
{
var sqlsinkotpions = new MSSqlServerSinkOptions();
sqlsinkotpions.TableName = "sys_Serilog";//表名稱
sqlsinkotpions.SchemaName = "dbo";//數(shù)據(jù)庫(kù)模式
sqlsinkotpions.AutoCreateSqlTable = true;//是否自動(dòng)創(chuàng)建表
return sqlsinkotpions;
}
/// <summary>
/// 設(shè)置日志sqlserver 列配置
/// </summary>
/// <returns></returns>
ColumnOptions GetColumnOptions()
{
var customColumnOptions = new ColumnOptions();
customColumnOptions.Store.Remove(StandardColumn.MessageTemplate);//刪除多余的這兩列
customColumnOptions.Store.Remove(StandardColumn.Properties);
var columlist = new List<SqlColumn>();
columlist.Add(new SqlColumn("RequestJson", SqlDbType.NVarChar, true, 2000));//添加一列,用于記錄請(qǐng)求參數(shù)string
columlist.Add(new SqlColumn("ResponseJson", SqlDbType.NVarChar, true, 2000));//添加一列,用于記錄響應(yīng)數(shù)據(jù)
customColumnOptions.AdditionalColumns = columlist;
return customColumnOptions;
}
}
}然后再program.cs中調(diào)用這個(gè)擴(kuò)展方法
var builder = WebApplication.CreateBuilder(args);
// Add services to the container.
builder.Services.AddControllers(options =>
{
options.Filters.Add(typeof(RequestLoggingFilter));
});
// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();
builder.Host.AddSerilLog();
var app = builder.Build();
// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
app.UseSwagger();
app.UseSwaggerUI();
}
app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();
app.Run();這里我設(shè)計(jì)的日志信息只包括了
- Message:日志信息
- Level:等級(jí)
- TimeStamp:記錄日志時(shí)間
- Exception:異常信息
- RequestJson:請(qǐng)求參數(shù)json
- ResponseJson:響應(yīng)結(jié)果json
其中前面四種為日志默認(rèn),后兩種為我主動(dòng)添加,在實(shí)際的設(shè)計(jì)中還有可能有不同的信息,如:
- IP:請(qǐng)求日志
- Action:請(qǐng)求方法
- Token:請(qǐng)求token
- User:請(qǐng)求的用戶
日志的設(shè)計(jì)應(yīng)該根據(jù)實(shí)際的情況而來(lái),其應(yīng)做到足夠詳盡,能幫助開(kāi)發(fā)者定位,解決問(wèn)題,而又不能過(guò)于重復(fù)臃腫,白白占用系統(tǒng)空間,我這邊的示例僅供大家參考
3.添加RequestLoggingFilter過(guò)濾器,用以記錄每次請(qǐng)求的日志
public class RequestLoggingFilter : IActionFilter
{
private readonly Serilog.ILogger _logger;//注入serilog
private Stopwatch _stopwatch;//統(tǒng)計(jì)程序耗時(shí)
public RequestLoggingFilter(Serilog.ILogger logger)
{
_logger = logger;
_stopwatch = Stopwatch.StartNew();
}
public void OnActionExecuted(ActionExecutedContext context)
{
_stopwatch.Stop();
var request = context.HttpContext.Request;
var response = context.HttpContext.Response;
_logger
.ForContext("RequestJson",request.QueryString)//請(qǐng)求字符串
.ForContext("ResponseJson", JsonConvert.SerializeObject(context.Result))//響應(yīng)數(shù)據(jù)json
.Information("Request {Method} {Path} responded {StatusCode} in {Elapsed:0.0000} ms",//message
request.Method,
request.Path,
response.StatusCode,
_stopwatch.Elapsed.TotalMilliseconds);
}
public void OnActionExecuting(ActionExecutingContext context)
{
}
}在program.cs中將該過(guò)濾器添加進(jìn)所有控制器之中
builder.Services.AddControllers(options =>
{
options.Filters.Add(typeof(RequestLoggingFilter));
});
// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();
builder.Host.AddSerilLog();
var app = builder.Build();
// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
app.UseSwagger();
app.UseSwaggerUI();
}
app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();
app.Run();測(cè)試效果
在控制器添加一個(gè)測(cè)試方法并將其調(diào)用一次
[HttpGet]
public dynamic Get123(string model)
{
return new { name = "123", id = 2 };
}
控制臺(tái)輸出

數(shù)據(jù)庫(kù)記錄

項(xiàng)目根目錄下logs文件夾中日志文件記錄

到此這篇關(guān)于如何在.Net6 web api中記錄每次接口請(qǐng)求的日志的文章就介紹到這了,更多相關(guān).net記錄每次接口請(qǐng)求的日志內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
asp.net下生成英文字符數(shù)字驗(yàn)證碼的代碼
用了asp.net隨機(jī)數(shù),獲取指定位數(shù)的字母或數(shù)字以后,進(jìn)行圖片輸出的驗(yàn)證碼函數(shù)。2009-12-12
Discuz!NT數(shù)據(jù)庫(kù)讀寫(xiě)分離方案詳解
Discuz!NT這個(gè)產(chǎn)品在其企業(yè)版中提供了對(duì)‘讀寫(xiě)分離’機(jī)制的支持,使對(duì)CPU及內(nèi)存消耗嚴(yán)重的操作(CUD)被 分離到一臺(tái)或幾臺(tái)性能很高的機(jī)器上,而將頻繁讀取的操作(select)放到幾臺(tái)配置較低的機(jī)器上,然后通過(guò)‘事務(wù) 發(fā)布訂閱機(jī)制’,實(shí)現(xiàn)了在多個(gè)sqlserver數(shù)據(jù)庫(kù)之間快速高效同步數(shù)據(jù),從而達(dá)到了將‘讀寫(xiě)請(qǐng)求’按實(shí)際負(fù)載 情況進(jìn)行均衡分布的效果。2010-06-06
asp.net 漢字轉(zhuǎn)換拼音及首字母實(shí)現(xiàn)代碼
asp.net 漢字轉(zhuǎn)換拼音及首字母實(shí)現(xiàn)代碼,需要的朋友可以參考下。2011-12-12
.NET?8新預(yù)覽版使用?Blazor?組件進(jìn)行服務(wù)器端呈現(xiàn)(項(xiàng)目體驗(yàn))
這篇文章主要介紹了.NET?8新預(yù)覽版使用?Blazor?組件進(jìn)行服務(wù)器端呈現(xiàn)(項(xiàng)目體驗(yàn)),這是 Blazor 統(tǒng)一工作的開(kāi)始,旨在使 Blazor 組件能夠滿足客戶端和服務(wù)器端的所有 Web UI 需求,需要的朋友可以參考下2023-04-04
.net+FusionChart實(shí)現(xiàn)動(dòng)態(tài)顯示的柱狀圖和餅狀圖
這篇文章介紹了.net+FusionChart實(shí)現(xiàn)動(dòng)態(tài)顯示柱狀圖和餅狀圖的方法,文中通過(guò)示例代碼介紹的非常詳細(xì)。對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2022-07-07
asp.net 修改/刪除站內(nèi)目錄操作后Session丟失問(wèn)題
在Web項(xiàng)目中使用 Directory.Move(olddir,newdir)修改目錄名稱或使用Directory.Delete(true)刪除目錄后, 發(fā)現(xiàn)Session都失效。2010-01-01
在.NET Core類(lèi)庫(kù)中使用EF Core遷移數(shù)據(jù)庫(kù)到SQL Server的方法
下面小編就為大家分享一篇在.NET Core類(lèi)庫(kù)中使用EF Core遷移數(shù)據(jù)庫(kù)到SQL Server的方法,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2017-12-12
asp.net 未能寫(xiě)入輸出文件--“拒絕訪問(wèn)的解決辦法
這個(gè)是網(wǎng)站部署在IIS7上出現(xiàn)的一個(gè)問(wèn)題2012-12-12

