Azure Function (v3) 中修改默认RequestTelemetry自定义属性失败，求可行实现方案

我之前在做Azure Functions遥测定制的时候也碰到过这个问题——直接修改RequestTelemetry的Properties或GlobalProperties有时候就是不生效。这主要是因为函数运行时的遥测生命周期和初始化时机的问题，下面给你两个经过验证的解决方案：

方案一：使用TelemetryInitializer（官方推荐，最可靠） #

这是微软官方推荐的定制遥测的方式，它能确保你的自定义属性在所有遥测（包括默认生成的RequestTelemetry）被发送前被正确添加。

1. 创建自定义TelemetryInitializer类 #

这个类需要实现ITelemetryInitializer接口，在Initialize方法里修改RequestTelemetry的属性：

using Microsoft.ApplicationInsights.Channel;
using Microsoft.ApplicationInsights.Extensibility;
using Microsoft.AspNetCore.Http;

public class CustomRequestTelemetryInitializer : ITelemetryInitializer
{
    private readonly IHttpContextAccessor _httpContextAccessor;

    // 通过依赖注入获取HttpContext，方便获取请求中的参数（比如你的name路由参数）
    public CustomRequestTelemetryInitializer(IHttpContextAccessor httpContextAccessor)
    {
        _httpContextAccessor = httpContextAccessor;
    }

    public void Initialize(ITelemetry telemetry)
    {
        if (telemetry is RequestTelemetry requestTelemetry)
        {
            // 从HttpContext获取你需要的自定义数据，比如上传的文件名
            var httpContext = _httpContextAccessor.HttpContext;
            if (httpContext != null && httpContext.Request.RouteValues.TryGetValue("name", out var fileName))
            {
                requestTelemetry.Properties.Add("UploadedFileName", fileName.ToString());
            }

            // 添加你需要的请求级自定义属性
            requestTelemetry.Properties.Add("someproperty", "123");
            // 如果是全局属性（所有遥测都要带），可以用下面的方式
            // requestTelemetry.Context.GlobalProperties.Add("GlobalCustomProp", "globalValue");
        }
    }
}

2. 在Startup类中注册Initializer #

如果你的函数是进程内模型（In-Process），需要创建一个Startup类来注册这个初始化器：

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

[assembly: FunctionsStartup(typeof(YourFunctionNamespace.Startup))]
namespace YourFunctionNamespace
{
    public class Startup : FunctionsStartup
    {
        public override void Configure(IFunctionsHostBuilder builder)
        {
            // 注册HttpContextAccessor，用于在Initializer中获取请求上下文
            builder.Services.AddHttpContextAccessor();
            // 注册自定义的遥测初始化器
            builder.Services.AddSingleton<ITelemetryInitializer, CustomRequestTelemetryInitializer>();
        }
    }
}

方案二：在函数代码中直接修改（适合简单场景） #

如果你不想用Initializer，也可以尝试在函数代码中确保正确修改RequestTelemetry，但要注意操作时机：

[FunctionName("Upload")]
[StorageAccount("AzureWebJobsStorage")]
public static async Task<IActionResult> Upload(
    [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = "upload/{name}")] HttpRequest req,
    string name,
    ILogger log,
    ExecutionContext context,
    // 注入TelemetryClient，方便操作遥测上下文
    TelemetryClient telemetryClient)
{
    // 获取当前请求的RequestTelemetry
    var requestTelemetry = req.HttpContext?.Features.Get<RequestTelemetry>();
    if (requestTelemetry != null)
    {
        // 先检查属性是否存在，存在则更新，不存在则添加
        if (requestTelemetry.Properties.ContainsKey("someproperty"))
        {
            requestTelemetry.Properties["someproperty"] = "123";
        }
        else
        {
            requestTelemetry.Properties.Add("someproperty", "123");
        }

        // 也可以通过TelemetryClient设置全局属性（所有遥测共享）
        telemetryClient.Context.GlobalProperties.Add("GlobalUploadProp", "globalUploadValue");
    }

    // 你的业务逻辑...
    return new OkObjectResult(name + "Uploaded successfully.");
}

为什么之前的方法没生效？ #

在Azure Functions V3中，默认的RequestTelemetry是由运行时在请求处理的早期阶段创建的。当你在函数代码里获取到它时，可能已经错过了属性初始化的最佳时机，或者运行时在后续流程中覆盖了这些属性。而TelemetryInitializer会在遥测被发送前的最后一步执行，能确保你的自定义属性被保留。

最后别忘了确认你的函数应用已经正确配置了Application Insights——在Azure门户的函数应用设置里，确保APPINSIGHTS_INSTRUMENTATIONKEY已经正确设置。

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