如何为Azure Function v3的BlobTrigger绑定的RequestTelemetry添加自定义属性

BlobTrigger属于非HTTP触发器，运行时不会为其创建HttpContext实例，因此无法沿用HttpTrigger中通过HttpRequest获取RequestTelemetry的实现逻辑，以下是两种经过验证的可行实现思路：

方案1：通过当前Activity添加自定义属性（最简方案） #

Azure Function v3运行时会为每一次函数触发创建对应的System.Diagnostics.Activity实例，该实例的Tag会自动同步到生成的RequestTelemetry的自定义属性中，无需额外注入依赖，直接调用即可：

using System.Diagnostics;

[FunctionName("Create-Thumbnail")]
public async Task CreateThumbnail([BlobTrigger("input/{name}",  Source = BlobTriggerSource.EventGrid, Connection = "AzureWebJobsStorage")] Stream image,
    IDictionary<string,string> metadata,
    string name,
    ExecutionContext context)
{ 
    // 直接给当前Activity加Tag，会自动同步到RequestTelemetry的Properties
    Activity.Current?.AddTag("MyProp", "Some value");
    // 也可以从Blob的元数据、触发参数中读取值作为自定义属性
    Activity.Current?.AddTag("BlobName", name);
    
    // 其余业务逻辑
    ...
}

该方案不需要额外安装NuGet包，也不需要修改Startup配置，适配所有类型的Azure Function触发器

方案2：通过自定义ITelemetryInitializer统一添加属性 #

如果你需要为所有触发器的RequestTelemetry统一添加通用属性，可以自定义实现ITelemetryInitializer，在全局层面处理遥测数据的属性追加：

1. 首先创建自定义的Initializer类：

using Microsoft.ApplicationInsights.Channel;
using Microsoft.ApplicationInsights.DataContracts;
using Microsoft.ApplicationInsights.Extensibility;

public class CustomTelemetryInitializer : ITelemetryInitializer
{
    public void Initialize(ITelemetry telemetry)
    {
        if (telemetry is RequestTelemetry requestTelemetry)
        {
            // 在这里统一添加自定义属性
            requestTelemetry.Properties.Add("AppVersion", "1.0.0");
            
            // 也可以判断是否是BlobTrigger的请求，按需添加
            if (requestTelemetry.Operation.Name.StartsWith("Create-Thumbnail"))
            {
                // 可以结合其他上下文信息补充属性
            }
        }
    }
}

2. 在函数的Startup类中注入该Initializer：

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

[assembly: FunctionsStartup(typeof(YourNamespace.Startup))]
namespace YourNamespace
{
    public class Startup : FunctionsStartup
    {
        public override void Configure(IFunctionsHostBuilder builder)
        {
            builder.Services.AddSingleton<ITelemetryInitializer, CustomTelemetryInitializer>();
        }
    }
}

注意事项 #

• 确保函数配置中已经正确设置APPINSIGHTS_INSTRUMENTATIONKEY或APPLICATIONINSIGHTS_CONNECTION_STRING应用配置，保证遥测数据可以正常上报
• Activity添加的Tag命名建议遵循通用规范，避免使用特殊字符，方便后续在Application Insights中查询过滤

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