ASP.NET Core 6.0中RequestTelemetry在Service Fabric下未记录Operation_id问题

一、Application Insights自动生成OperationId的默认机制 #

• ASP.NET Core应用中，Microsoft.ApplicationInsights.AspNetCore包默认通过RequestTrackingTelemetryModule自动初始化请求追踪流程：在请求进入时生成operationId，并将其绑定到当前请求的TelemetryContext中，后续所有依赖遥测、自定义遥测都会自动继承这个operationId。
• 若手动调用TrackRequest时未显式设置operationId，默认会读取当前TelemetryContext中的值，因此无需手动赋值也能正常关联。

二、导致Service Fabric环境下缺失OperationId的常见代码变更点 #

结合你的场景，近期代码变更可能触发了以下问题：

1. 中间件注册顺序错误

   • 若自定义追踪中间件注册在AI请求追踪中间件（UseApplicationInsightsRequestTelemetry()）之前，此时TelemetryContext尚未初始化，手动创建的RequestTelemetry无法获取自动生成的operationId。
   • 而Azure App Service的默认宿主环境会自动保证AI中间件的优先级，因此不会出现此问题。

2. 手动创建RequestTelemetry未关联上下文

   • 若近期代码改为手动实例化RequestTelemetry（而非复用AI自动生成的实例），且未从当前TelemetryContext或HttpContext中提取已有的operationId，则会导致遥测缺失该字段。

3. 禁用了自动请求追踪模块

   • 若在AddApplicationInsightsTelemetry()配置中设置了DisableRequestTracking = true，或移除了默认的请求追踪中间件，AI将不再自动生成operationId。

4. 自定义TelemetryInitializer覆盖了OperationId逻辑

   • 若新增了自定义ITelemetryInitializer，且在逻辑中清空或覆盖了已生成的operationId，也会导致字段缺失。

三、修复步骤 #

1. 修正中间件注册顺序 #

确保AI请求追踪中间件优先于自定义追踪中间件注册：

// Program.cs 示例代码
var app = builder.Build();

// 先注册AI请求追踪中间件，确保TelemetryContext提前初始化
app.UseApplicationInsightsRequestTelemetry();

// 再注册自定义请求追踪中间件
app.UseCustomRequestTrackingMiddleware();

// 其他中间件注册...

2. 复用或关联上下文的RequestTelemetry #

• 复用AI自动生成的实例：直接从HttpContext的Feature中获取AI已创建的RequestTelemetry，修改后无需手动调用TrackRequest（AI会自动提交）：

  // 自定义中间件内的代码
  var requestTelemetry = context.Features.Get<RequestTelemetry>();
  if (requestTelemetry != null)
  {
      // 修改操作名称
      requestTelemetry.Name = "你的自定义操作名称";
      // 添加自定义属性
      requestTelemetry.Properties.Add("CustomProperty", "PropertyValue");
  }
  

• 手动创建时关联上下文：如果必须手动实例化RequestTelemetry，需从TelemetryClient的上下文继承operationId：

  // 自定义中间件内的代码
  var telemetryClient = context.RequestServices.GetRequiredService<TelemetryClient>();
  var requestTelemetry = new RequestTelemetry
  {
      Name = "你的自定义操作名称",
      // 关联当前上下文的operationId
      Context = { Operation = { Id = telemetryClient.Context.Operation.Id } }
  };
  requestTelemetry.Properties.Add("CustomProperty", "PropertyValue");
  telemetryClient.TrackRequest(requestTelemetry);
  

3. 检查自动请求追踪配置 #

确保未禁用AI的自动请求追踪：

builder.Services.AddApplicationInsightsTelemetry(options =>
{
    // 确认此选项为false（默认值即为false，若未修改可省略）
    options.DisableRequestTracking = false;
});

4. 校验自定义TelemetryInitializer #

若存在自定义初始化器，确保逻辑中不会覆盖已存在的operationId：

public class CustomTelemetryInitializer : ITelemetryInitializer
{
    public void Initialize(ITelemetry telemetry)
    {
        // 仅当operationId为空时才生成，避免覆盖已有的值
        if (string.IsNullOrEmpty(telemetry.Context.Operation.Id))
        {
            telemetry.Context.Operation.Id = Guid.NewGuid().ToString();
        }
        // 其他自定义初始化逻辑...
    }
}

四、为什么之前无需显式设置也能正常工作 #

之前的代码未变更时，要么是中间件顺序正确，AI提前初始化了TelemetryContext；要么是直接复用了AI自动生成的RequestTelemetry实例，因此operationId会被自动关联，无需手动赋值。近期的代码变更打破了这一默认流程，导致字段缺失。

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