如何在Azure Functions 4.0中更好地控制JSON日志输出？

针对你遇到的Azure Functions 4.0控制台日志格式无法定制、Serilog配置未生效的问题，以下是几个可行的方案来实现灵活的JSON日志输出控制：

1. 正确配置Serilog（解决未生效问题） #

首先确保安装必要的NuGet包：Serilog.AspNetCore、Serilog.Sinks.Console、Serilog.Formatting.Compact（用于紧凑JSON格式，也可自定义）。

针对Isolated Worker模型 #

在Program.cs中替换默认日志提供器，让Serilog完全接管控制台日志：

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults(builder =>
    {
        // 移除默认日志提供器，避免重复输出
        builder.Services.RemoveAll<ILoggerProvider>();
        // 禁用默认控制台的颜色输出，避免干扰JSON格式
        builder.Services.Configure<ConsoleLoggerOptions>(options => options.DisableColors = true);
    })
    .UseSerilog((context, config) =>
    {
        config.ReadFrom.Configuration(context.Configuration)
              .Enrich.FromLogContext()
              // 使用紧凑JSON格式化器，或替换为自定义格式化器
              .WriteTo.Console(new CompactJsonFormatter());
    })
    .Build();

host.Run();

针对In-Process模型 #

在Startup.cs的Configure方法中配置Serilog并替换默认日志：

public override void Configure(IFunctionsHostBuilder builder)
{
    Log.Logger = new LoggerConfiguration()
        .Enrich.FromLogContext()
        .WriteTo.Console(new CompactJsonFormatter())
        .CreateLogger();

    builder.Services.AddLogging(loggingBuilder =>
    {
        // 清除所有默认日志提供器
        loggingBuilder.ClearProviders();
        // 添加Serilog作为唯一日志提供器
        loggingBuilder.AddSerilog(dispose: true);
    });
}

2. 调整host.json避免默认日志干扰 #

修改host.json，禁用Functions自带的控制台JSON输出，防止与Serilog冲突：

{
    "logging": {
        "console": {
            "isJsonOutput": false,
            "disableColors": true
        },
        "logLevel": {
            "Default": "Information"
        }
    }
}

3. 自定义JSON日志结构 #

如果需要完全自定义日志的JSON字段和结构，可以实现Serilog的ITextFormatter接口：

public class CustomJsonFormatter : ITextFormatter
{
    public void Format(LogEvent logEvent, TextWriter output)
    {
        var logJson = new JObject(
            new JProperty("timestamp", logEvent.Timestamp.UtcDateTime.ToString("yyyy-MM-ddTHH:mm:ss.fffZ")),
            new JProperty("level", logEvent.Level.ToString()),
            new JProperty("message", logEvent.MessageTemplate.Render(logEvent.Properties)),
            new JProperty("event_id", logEvent.Properties.TryGetValue("EventId", out var id) ? id.ToString() : null),
            new JProperty("properties", JObject.FromObject(logEvent.Properties))
        );

        output.WriteLine(logJson.ToString(Formatting.None));
    }
}

然后在Serilog配置中替换为自定义格式化器：

.WriteTo.Console(new CustomJsonFormatter())

4. 常见排查点 #

• 确认NuGet包版本与Azure Functions 4.0兼容（如针对.NET 6/7选择对应版本的Serilog包）
• 本地调试时，确保查看的是"Azure Functions"控制台输出窗口，而非其他输出面板
• 检查是否有其他日志扩展或第三方库添加了额外的日志提供器，导致Serilog输出被覆盖
• 验证appsettings.json或环境变量中是否有覆盖Serilog配置的参数

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