不要用第三方日志包了Microsoft.Extensions.Logging功能就很強大

在.NET中,Microsoft.Extensions.Logging是一個廣泛使用的日志庫,用于記錄應用程序的日志信息。它提供了豐富的功能和靈活性,使開發人員能夠輕松地記錄各種類型的日志,并將其輸出到不同的目標,包括日志文件。本文將詳細介紹Microsoft.Extensions.Logging的各種基礎功能以及如何按天生成日志文件。
一、Microsoft.Extensions.Logging基礎功能
1. 創建Logger
首先,我們需要創建一個Logger實例,以便在應用程序中記錄日志。以下是創建Logger的基本方法:
using Microsoft.Extensions.Logging;
var loggerFactory = LoggerFactory.Create(builder =>
{
builder.AddConsole(); // 輸出日志到控制臺
});
var logger = loggerFactory.CreateLogger<Program>();在上面的示例中,我們首先創建了一個LoggerFactory實例,然后通過它創建了一個Logger。我們還使用AddConsole方法將日志輸出到控制臺。
2. 記錄日志消息
一旦有Logger實例,我們可以使用它來記錄不同級別的日志消息。
Microsoft.Extensions.Logging定義了以下日志級別(按嚴重性遞增排列):
- Trace
- Debug
- Information
- Warning
- Error
- Critical
下面是如何使用Logger記錄不同級別的日志消息的示例:
logger.LogInformation("這是一條信息日志");
logger.LogWarning("這是一條警告日志");
logger.LogError("這是一條錯誤日志");
logger.LogCritical("這是一條嚴重錯誤日志");3. 提供上下文信息
通常,我們需要將一些上下文信息記錄到日志中,以幫助排查問題。可以使用LogInformation等方法的重載版本,傳遞額外的參數,如下:
var userId = 123;
logger.LogInformation("用戶 {UserId} 登錄成功", userId);在上述示例中,我們將userId作為參數傳遞給日志消息,以便將其包含在日志中。
4. 使用日志范圍
有時,我們希望在一段代碼塊中記錄一組相關日志消息,并希望這些消息具有相同的上下文信息。這時可以使用LogScope,如下所示:
using (logger.BeginScope("交易處理 - 訂單 {OrderId}", orderId))
{
logger.LogInformation("訂單處理中...");
// 執行一些訂單處理邏輯
logger.LogInformation("訂單處理完成");
}在上述示例中,我們使用BeginScope方法創建了一個日志范圍,將其包含在指定的上下文信息中。在范圍內的所有日志消息都會自動包含這些上下文信息。
5. 配置日志級別
我們可以在應用程序中配置所需的最低日志級別,以決定哪些日志消息將被記錄。通常,這是在應用程序的配置文件中完成的。以下是一個示例:
var loggerFactory = LoggerFactory.Create(builder =>
{
builder.AddConsole();
builder.SetMinimumLevel(LogLevel.Information); // 設置最低日志級別
});在上述示例中,我們使用SetMinimumLevel方法來配置最低日志級別。只有達到或高于指定級別的日志消息才會被記錄。
二、按天生成日志文件
現在,讓我們來看看如何按天生成日志文件。通常,我們會希望將日志消息記錄到文件中,并按日期對日志文件進行歸檔。
1. 安裝相關包
首先,我們需要安裝一些必要的包,以便實現按天生成日志文件。使用NuGet包管理器或.NET CLI可以輕松完成這一步驟:
dotnet add package Microsoft.Extensions.Logging.File2. 配置文件日志提供程序
接下來,我們需要配置文件日志提供程序,以便將日志消息記錄到文件中。以下是如何配置文件提供程序的示例:
var loggerFactory = LoggerFactory.Create(builder =>
{
builder.AddFile("logs/myapp-{Date}.txt");
builder.SetMinimumLevel(LogLevel.Information);
});在上述示例中,我們使用AddFile方法配置文件日志提供程序,并指定日志文件的名稱模式。{Date}將根據日志消息的日期自動替換為實際日期。
3. 示例代碼
以下是一個完整的示例代碼,演示了如何使用
Microsoft.Extensions.Logging按天生成日志文件:
using System;
using Microsoft.Extensions.Logging;
using Microsoft.Extensions.Logging.File;
class Program
{
static void Main()
{
var loggerFactory = LoggerFactory.Create(builder =>
{
builder.AddFile("logs/myapp-{Date}.txt");
builder.SetMinimumLevel(LogLevel.Information);
});
var logger = loggerFactory.CreateLogger<Program>();
for (int i = 0; i < 10; i++)
{
logger.LogInformation("這是一條信息日志 - {LogCount}", i);
}
}
}上述示例中,我們配置了文件日志提供程序,日志文件的名稱模式包含了{Date},并循環記錄了10條日志消息。每天,日志文件將被歸檔到不同的文件中,以便跟蹤和檢查以前的日志。
Microsoft.Extensions.Logging是.NET中強大的日志庫,可以用于記錄各種類型的日志消息。通過配置文件日志提供程序,我們可以按天生成日志文件,以便更好地管理和分析日志。

























