如何在Azure Functions中全局复用TelemetryClient实现日志？

我正尝试在Azure Functions应用中实现Application Insights日志功能，但在.NET Core中直接实例化TelemetryClient已被弃用。目前我通过以下方式实现：

startup.cs

public class Startup : FunctionsStartup
{
    public override void Configure(IFunctionsHostBuilder builder)
    {
        builder.Services.AddApplicationInsightsTelemetry();
    }
}

Function1.cs

public class Function1
{
    TelemetryClient _telemetry;
    
    public Function1(TelemetryClient telemetry)
    {
        _telemetry = telemetry;
    }

    [FunctionName("Function1")]
    public async Task<IActionResult> Run([HttpTrigger(AuthorizationLevel.Function, "get", "post", Route = null)] HttpRequest req, ILogger log)
    {
        // APPINSIGHTS LOG! 
        _telemetry.TrackTrace("Testing the appinsights");
        string name = req.Query["name"];

        string requestBody = await new StreamReader(req.Body).ReadToEndAsync();
        dynamic data = JsonConvert.DeserializeObject(requestBody);
        name = name ?? data?.name;

        string responseMessage = "This HTTP triggered function executed successfully.";
        return new OkObjectResult(responseMessage);
    }
}

上述方式使用TelemetryClient没问题，但我想知道如何在整个应用中复用该对象（过去我会创建单例全局使用）。比如我在另一个类中通过构造注入使用：

Student.cs

using Microsoft.ApplicationInsights;

private TelemetryClient _telemetryClient;

public Student(TelemetryClient telemetryClient)
{
    _telemetryClient = telemetryClient;
}

在方法中调用：

_telemetryClient.TrackEvent("We are in SQL Server -> Student.cs File");

我是否需要在所有需要日志的类的构造函数中都注入该对象？有没有更优的实现方式？

1. 关于TelemetryClient的实例复用 #

你不用担心中注入多个实例的问题：AddApplicationInsightsTelemetry()默认会把TelemetryClient注册为单例模式，所有通过构造注入获取的TelemetryClient都是同一个实例，和你之前手动创建单例的效果完全一致。

2. 是否需要每个类都构造注入？ #

• 标准推荐方式：构造注入
  这是.NET Core依赖注入的规范用法，能清晰展示类的依赖关系，同时方便单元测试（比如可以注入Mock的TelemetryClient）。虽然看起来每个类都要写构造函数，但这是保持代码可维护性的最佳实践。

• 替代方案1：使用ILogger<T>集成Application Insights
  Application Insights已经和.NET的原生日志系统深度集成，你可以直接使用ILogger<T>来记录日志，这些日志会自动同步到Application Insights中。这种方式不需要直接操作TelemetryClient，更符合.NET的日志规范：

  // 在类中注入ILogger<T>
  public class Student
  {
      private readonly ILogger<Student> _logger;
      
      public Student(ILogger<Student> logger)
      {
          _logger = logger;
      }
      
      public void DoSomething()
      {
          // 日志会自动出现在Application Insights的Trace中
          _logger.LogInformation("We are in SQL Server -> Student.cs File");
      }
  }
  

• 替代方案2：封装静态日志工具（不推荐大规模使用）
  如果你觉得构造注入太繁琐，可以封装一个静态类，在Startup时从DI容器中获取TelemetryClient并赋值给静态属性：

  // 静态工具类
  public static class AppInsightsLogger
  {
      public static TelemetryClient Instance { get; set; }
      
      public static void TrackEvent(string eventName)
      {
          Instance?.TrackEvent(eventName);
      }
  }
  
  // 在Startup中初始化
  public class Startup : FunctionsStartup
  {
      public override void Configure(IFunctionsHostBuilder builder)
      {
          builder.Services.AddApplicationInsightsTelemetry();
          var serviceProvider = builder.Services.BuildServiceProvider();
          AppInsightsLogger.Instance = serviceProvider.GetRequiredService<TelemetryClient>();
      }
  }
  
  // 使用时直接调用
  AppInsightsLogger.TrackEvent("We are in SQL Server -> Student.cs File");
  

  这种方式虽然简化了调用，但会让依赖关系变得不透明，也不利于单元测试，只适合小范围简单场景。

3. 关键注意事项 #

• 永远不要手动创建TelemetryClient实例，DI容器会自动处理它的生命周期和配置（比如从appsettings.json读取InstrumentationKey）。
• 如果需要自定义事件、指标等高级操作，还是需要直接使用TelemetryClient，此时构造注入是最优选择。

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