如何为Azure Functions所有日志全局添加自定义日志上下文（如构建编号）且不依赖第三方日志框架

当然可以实现！不需要依赖Serilog这类第三方框架，利用Azure Functions基于.NET ILogging系统的原生扩展点就能全局添加自定义上下文（比如构建编号），而且能兼容你用到的Seq、Stackify和Application Insights所有日志接收器。

核心思路是利用全局日志Scope——这是.NET ILogging的原生特性，所有兼容的日志接收器都会自动捕获Scope中的属性并添加到日志条目中，完美满足你“通用不绑定特定接收器”的需求。

下面分两种函数运行模型给出具体实现：

1. In-process 模型（.NET Framework/.NET Core 3.1+） #

步骤1：创建全局Scope服务 #

这个服务会在函数应用启动时创建一个包含构建编号的全局日志Scope，后续所有日志都会自动带上这个属性：

using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;
using System;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;

public class GlobalLogScopeService : IHostedService
{
    private readonly ILogger<GlobalLogScopeService> _logger;
    private IDisposable _globalScope;

    public GlobalLogScopeService(ILogger<GlobalLogScopeService> logger)
    {
        _logger = logger;
    }

    public Task StartAsync(CancellationToken cancellationToken)
    {
        // 从环境变量获取构建编号，CI/CD时可自动注入
        var buildNumber = Environment.GetEnvironmentVariable("BUILD_NUMBER") ?? "unknown-build";
        
        // 创建全局Scope，添加自定义上下文项
        _globalScope = _logger.BeginScope(new Dictionary<string, object>
        {
            ["BuildNumber"] = buildNumber
        });
        
        _logger.LogInformation("全局日志上下文已添加，构建编号：{BuildNumber}", buildNumber);
        return Task.CompletedTask;
    }

    public Task StopAsync(CancellationToken cancellationToken)
    {
        _globalScope?.Dispose();
        return Task.CompletedTask;
    }
}

步骤2：注册Startup类 #

在函数项目中添加Startup类，将全局Scope服务注入到函数宿主：

using Microsoft.Azure.Functions.Extensions.DependencyInjection;
using Microsoft.Extensions.DependencyInjection;

[assembly: FunctionsStartup(typeof(YourFunctionProject.Startup))]
namespace YourFunctionProject
{
    public class Startup : FunctionsStartup
    {
        public override void Configure(IFunctionsHostBuilder builder)
        {
            // 注册全局Scope服务
            builder.Services.AddHostedService<GlobalLogScopeService>();
        }
    }
}

2. Isolated Worker 模型（.NET 5+） #

隔离进程模型的配置更直接，在Program.cs中直接注册全局Scope服务即可：

using Microsoft.Azure.Functions.Worker;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults()
    .ConfigureServices(services =>
    {
        // 注册全局Scope服务
        services.AddHostedService<GlobalLogScopeService>();
    })
    .Build();

host.Run();

// 全局Scope服务类，直接复用上面的实现即可
public class GlobalLogScopeService : IHostedService
{
    private readonly ILogger<GlobalLogScopeService> _logger;
    private IDisposable _globalScope;

    public GlobalLogScopeService(ILogger<GlobalLogScopeService> logger)
    {
        _logger = logger;
    }

    public Task StartAsync(CancellationToken cancellationToken)
    {
        var buildNumber = Environment.GetEnvironmentVariable("BUILD_NUMBER") ?? "unknown-build";
        _globalScope = _logger.BeginScope(new Dictionary<string, object>
        {
            ["BuildNumber"] = buildNumber
        });
        
        _logger.LogInformation("全局日志上下文已添加，构建编号：{BuildNumber}", buildNumber);
        return Task.CompletedTask;
    }

    public Task StopAsync(CancellationToken cancellationToken)
    {
        _globalScope?.Dispose();
        return Task.CompletedTask;
    }
}

关键细节与验证 #

注入构建编号 #

构建编号建议通过环境变量注入：

• 本地开发：在local.settings.json中添加"BUILD_NUMBER": "1.0.0-local"
• 生产环境：在Azure Portal的函数应用「配置」→「应用程序设置」中添加该变量
• CI/CD流程：在Azure DevOps、GitHub Actions等工具中，自动将构建版本号设置为该环境变量

验证效果 #

• Application Insights：查看日志的「自定义维度」，会看到BuildNumber属性
• Seq：搜索日志时可直接过滤BuildNumber，每条日志的属性面板会显示该字段
• Stackify：在日志详情中能找到自定义的BuildNumber上下文项

这种方式完全基于.NET原生日志系统，不需要修改任何日志接收器的配置，完美适配你提到的三种工具，而且所有日志（包括Functions运行时的系统日志）都会带上这个全局上下文。

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