ASP.NET中如何通过内置ILogger在运行时修改日志级别？

核心思路是利用.NET内置的IOptionsMonitor<LoggerFilterOptions>来修改日志过滤配置，该配置会被内置日志器实时读取，无需重启应用。

实现步骤与代码示例 #

1. 创建日志控制端点
   新增一个API控制器，注入IOptionsMonitor<LoggerFilterOptions>（用于读取和修改日志过滤配置）和ILogger（记录级别修改操作），然后实现修改日志级别的接口：

using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Logging;
using Microsoft.Extensions.Options;

[ApiController]
[Route("api/log")]
public class LogController : ControllerBase
{
    private readonly IOptionsMonitor<LoggerFilterOptions> _loggerFilterConfig;
    private readonly ILogger<LogController> _logger;

    public LogController(IOptionsMonitor<LoggerFilterOptions> loggerFilterConfig, ILogger<LogController> logger)
    {
        _loggerFilterConfig = loggerFilterConfig;
        _logger = logger;
    }

    [HttpPost("changelevel/{level}")]
    public IActionResult ChangeGlobalMinimumLevel(string level)
    {
        // 解析传入的日志级别字符串
        if (!Enum.TryParse<LogLevel>(level, ignoreCase: true, out var targetLevel))
        {
            var validLevels = string.Join(", ", Enum.GetNames(typeof(LogLevel)));
            return BadRequest($"无效的日志级别，请输入以下有效值：{validLevels}");
        }

        // 修改全局最小日志级别，修改后立即生效
        _loggerFilterConfig.CurrentValue.MinimumLevel = targetLevel;
        _logger.LogInformation("全局最小日志级别已更新为：{TargetLevel}", targetLevel);

        return Ok($"日志级别已成功设置为：{targetLevel}");
    }
}

2. （可选）修改特定类别的日志级别
   如果需要针对特定日志类别（如Microsoft.AspNetCore）单独修改级别，可以操作LoggerFilterOptions.Rules集合：

[HttpPost("changelevel/category/{category}/{level}")]
public IActionResult ChangeCategoryLevel(string category, string level)
{
    if (!Enum.TryParse<LogLevel>(level, ignoreCase: true, out var targetLevel))
    {
        var validLevels = string.Join(", ", Enum.GetNames(typeof(LogLevel)));
        return BadRequest($"无效的日志级别，请输入以下有效值：{validLevels}");
    }

    var filterConfig = _loggerFilterConfig.CurrentValue;
    // 移除该类别已有的过滤规则
    var existingRule = filterConfig.Rules.FirstOrDefault(r => r.CategoryName == category);
    if (existingRule != null)
    {
        filterConfig.Rules.Remove(existingRule);
    }
    // 添加新的类别过滤规则
    filterConfig.Rules.Add(new LoggerFilterRule(null, category, targetLevel, null));

    _logger.LogInformation("类别[{Category}]的日志级别已更新为：{TargetLevel}", category, targetLevel);
    return Ok($"类别[{category}]的日志级别已成功设置为：{targetLevel}");
}

关键注意事项 #

• 实时生效：修改LoggerFilterOptions后，内置日志器会立即采用新的配置，无需重启应用。
• 配置文件优先级：如果你的应用同时通过appsettings.json配置日志级别，当配置文件被修改时，IOptionsMonitor会自动加载新配置，覆盖手动修改的设置。若需避免此情况，可移除配置文件中的日志级别配置，或自定义配置源。
• 权限控制：务必给日志级别修改端点添加权限验证（如[Authorize]属性），防止未授权访问导致的安全风险。
• 日志级别有效值：支持的级别包括：Trace、Debug、Information、Warning、Error、Critical、None。

内容的提问来源于stack exchange，提问作者Simon