将用户名添加到 Serilog

Question

我在 program.cs

中有这个 Serilog 配置

public class Program
    {
        public static IConfiguration Configuration { get; } = new ConfigurationBuilder()
            .SetBasePath(Directory.GetCurrentDirectory())
            .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
            .AddJsonFile($"appsettings.{Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT") ?? "Production"}.json", optional: true)
            .Build();

        public static void Main(string[] args)
        {
            Log.Logger = new LoggerConfiguration()
                .MinimumLevel.Override("Microsoft", LogEventLevel.Warning)
                .MinimumLevel.Override("System", LogEventLevel.Warning)
                .WriteTo.MSSqlServer(Configuration.GetConnectionString("DefaultConnection"), "dbo.Log")
                .Enrich.WithThreadId()
                .Enrich.WithProperty("Version", "1.0.0")
                .CreateLogger();
            try
            {
                BuildWebHost(args).Run();
            }
            catch (Exception ex)
            {
                Log.Fatal(ex, "Host terminated unexpectedly");
            }
            finally
            {
                Log.CloseAndFlush();
            }

        }

        public static IWebHost BuildWebHost(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .UseStartup<Startup>()
                .UseSerilog()
                .Build();
    }

现在我想将HttpContext.Current.User.Identity.Name 添加到所有日志消息中。

我尝试按照文档 https://github.com/serilog/serilog/wiki/Configuration-Basics#enrichers 创建新的 Enrich 类

class UsernameEnricher : ILogEventEnricher
    {
        public void Enrich(LogEvent logEvent, ILogEventPropertyFactory propertyFactory, HttpContext httpContext)
        {
            logEvent.AddPropertyIfAbsent(propertyFactory.CreateProperty(
                    "Username", httpContext.User.Identity.Name));
        }
    }

但是与不知道HttpContext的ILogEventEnricher有冲突。

我也尝试安装包含 Username Enricher 的 Nuget 包 Serilog.Web.Classic，但目标框架 .Net Framework 和 .Net Core 之间存在冲突，因此我无法使用此插件。

有什么想法吗？

Answer 1

您可以创建一个中间件将所需的属性放入 LogContext。

public class LogUserNameMiddleware
{
    private readonly RequestDelegate next;

    public LogUserNameMiddleware(RequestDelegate next)
    {
        this.next = next;
    }

    public Task Invoke(HttpContext context)
    {
        LogContext.PushProperty("UserName", context.User.Identity.Name);

        return next(context);
    }
}

您还需要将以下内容添加到您的记录器配置中：

.Enrich.FromLogContext()

在Startup中添加中间件LogUserNameMiddleware，还要注意中间件要放在UserAuthentication之后，才能初始化context.User.Identity

例如

    app.UseAuthentication();     

    app.UseMiddleware<LogUserNameMiddleware>();

Answer 2

如果您使用Serilog.AspNetCore，添加身份验证/用户属性非常容易。

    app.UseSerilogRequestLogging(options =>
    {
         options.EnrichDiagnosticContext = PushSeriLogProperties;
    });



    public void PushSeriLogProperties(IDiagnosticContext diagnosticContext, HttpContext httpContext)
    {
            diagnosticContext.Set("SomePropertyName", httpContext.User...);
    }

Answer 3

使用中间件的另一种方法是使用操作过滤器。

using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc.Filters;
using Serilog.Context;

namespace Acme.Widgets.Infrastructure
{
    public class LogEnrichmentFilter : IActionFilter
    {
        private readonly IHttpContextAccessor httpContextAccessor;

        public LogEnrichmentFilter(IHttpContextAccessor httpContextAccessor)
        {
            this.httpContextAccessor = httpContextAccessor;
        }

        public void OnActionExecuting(ActionExecutingContext context)
        {
            var httpUser = this.httpContextAccessor.HttpContext.User;

            if (httpUser.Identity.IsAuthenticated)
            {
                var appUser = new AppIdentity(httpUser);
                LogContext.PushProperty("Username", appUser.Username);
            }
            else
            {
                LogContext.PushProperty("Username", "-");
            }
        }

        public void OnActionExecuted(ActionExecutedContext context)
        {
            // Do nothing
        }
    }
}

在您的Startup.ConfigureServices 中，您需要：

1. 确保将IHttpContextAccessor 添加到 IoC 容器中
2. 将 LogEnrichmentFilter 添加到 IoC 容器中，范围为请求
3. 将LogEnrichmentFilter注册为全局操作过滤器

Startup.cs:

services.TryAddSingleton<IHttpContextAccessor, HttpContextAccessor>();
services.AddScoped<LogEnrichmentFilter>();

services.AddMvc(o =>
{
    o.Filters.Add<LogEnrichmentFilter>();
});

您应该在MVC action invocation pipeline 中运行的代码的日志上下文中拥有当前用户名。我想如果您使用 resource filter 而不是操作过滤器，用户名将附加到更多日志条目，因为它们在管道中运行得稍早（我才刚刚发现这些！）

Answer 4

@Alex Riabov 建议的方法存在许多问题。

1. 需要Dispose推送的属性
2. 中间件中的Invoke方法是异步的，所以你不能只是return next()，你需要await next()
3. 请求信息由UseSerilogRequestLogging()中间件记录。如果该属性在到达之前被弹出，则该属性变为空。

要修复它们，我可以建议进行以下修改。

在中间件中：

public async Task Invoke(HttpContext context)
{
    using (LogContext.PushProperty("UserName", context.User.Identity.Name ?? "anonymous"))
    {
        await next(context);
    }
}

在Startup.cs:

appl.UseRouting()
    .UseAuthentication()
    .UseAuthorization()
    .UseMiddleware<SerilogUserNameMiddleware>()
    .UseSerilogRequestLogging()
    .UseEndpoints(endpoints =>
    {
        endpoints.MapControllers();
        endpoints.MapRazorPages();
        endpoints.MapHealthChecks("/health");
    });