如何为TimerTrigger类型Azure Functions配置OpenTelemetry父链路追踪

问题根源 #

HttpTrigger能自动生成根链路，是因为它走ASP.NET Core请求管道，.AddAspNetCoreInstrumentation()会拦截每个HTTP请求并创建根Span，内部HTTP调用会自动继承这个上下文。但TimerTrigger是由Azure Functions宿主直接调度的，完全不经过ASP.NET Core的请求中间件，所以该instrumentation对它无效，导致内部调用只能生成独立的Span，无法归组。

解决方案：手动为TimerTrigger创建根Span #

你需要在TimerTrigger的函数逻辑里，手动启动一个根Span，让后续的内部HTTP调用都在这个Span的作用域内执行，这样OpenTelemetry就能自动把内部调用关联到这个根链路上。

步骤1：确认基础OpenTelemetry配置（Startup中）

确保你已经正确配置了HttpClient的Instrumentation，这样内部HTTP调用才能自动关联父Span：

public class Startup : FunctionsStartup
{
    public override void Configure(IFunctionsHostBuilder builder)
    {
        builder.Services.AddOpenTelemetry()
            .WithTracing(tracerProviderBuilder =>
            {
                tracerProviderBuilder
                    // 保留你已有的导出器配置（比如Grafana Tempo等）
                    .AddOtlpExporter(options =>
                    {
                        options.Endpoint = new Uri("你的追踪后端地址");
                    })
                    // 必须添加HttpClient Instrumentation，否则内部HTTP调用不会生成Span
                    .AddHttpClientInstrumentation()
                    // 添加Azure Functions官方Instrumentation，辅助捕获基础执行信息
                    .AddAzureFunctionsInstrumentation();
            });
    }
}

步骤2：修改TimerTrigger函数，手动创建根Span

在TimerTrigger的函数代码里，注入TracerProvider，然后在执行核心逻辑前启动根Span：

using System;
using System.Net.Http;
using System.Threading.Tasks;
using Microsoft.Azure.WebJobs;
using Microsoft.Extensions.Logging;
using OpenTelemetry.Trace;

public class TimerTriggerFunction
{
    private readonly HttpClient _httpClient;
    private readonly Tracer _tracer;

    // 构造函数注入HttpClient和TracerProvider
    public TimerTriggerFunction(HttpClient httpClient, TracerProvider tracerProvider)
    {
        _httpClient = httpClient;
        // 使用和配置中一致的Tracer名称（比如你的应用名称）
        _tracer = tracerProvider.GetTracer("你的应用标识");
    }

    [FunctionName("TimerTriggerFunction")]
    public async Task Run([TimerTrigger("0 */5 * * * *")]TimerInfo myTimer, ILogger log)
    {
        // 启动根Span，命名可自定义，比如"TimerTrigger: 定时任务执行"
        using var rootSpan = _tracer.StartActiveSpan("TimerTrigger: 定时任务执行");
        try
        {
            log.LogInformation($"C# Timer trigger function executed at: {DateTime.Now}");

            // 这里的内部HTTP调用会自动关联到上面的rootSpan
            var response = await _httpClient.GetAsync("https://你的内部API地址/endpoint");
            response.EnsureSuccessStatusCode();

            // 其他业务逻辑...
        }
        catch (Exception ex)
        {
            // 给Span标记错误状态
            rootSpan.SetStatus(Status.Error.WithDescription(ex.Message));
            throw;
        }
    }
}

步骤3：验证效果

部署修改后的代码，触发TimerTrigger后，去Grafana查看链路追踪：

• 会看到一个以你创建的根Span为起点的完整链路
• 所有内部HTTP调用的Span都会嵌套在这个根Span下面，不再分散

额外注意事项 #

• 确保HttpClient是通过DI注入的，而非手动new HttpClient()，否则OpenTelemetry的HttpClient Instrumentation无法拦截请求
• AddAzureFunctionsInstrumentation()可以捕获函数名称、触发类型等基础信息，建议保留
• 多实例运行时，根Span的TraceId会自动区分不同的执行实例，不会产生混淆

内容的提问来源于stack exchange，提问作者Roman.Pavelko