如何在.NET中捕获代理对象内部函数调用以完善全链路追踪？

核心问题 #

在ASP.NET Core应用中基于OpenTelemetry实现函数级链路追踪时，采用DispatchProxy仅能捕获外部对服务的首次调用，内部方法调用会直接访问被代理对象而非代理实例：同步调用的耗时会被归入父调用，异步调用则直接从追踪树中消失，无法实现完整的函数级链路追踪，且不想通过手动埋点增加样板代码。

可行解决方案 #

1. 替换DispatchProxy：使用Castle DynamicProxy实现全方法拦截 #

Castle DynamicProxy的拦截器机制可以覆盖所有方法调用（包括内部调用），只要目标类的方法是虚方法或基于接口定义。

实现步骤：

• 安装NuGet包：Castle.Core、OpenTelemetry.Extensions.Hosting
• 编写OpenTelemetry拦截器：

public class OpenTelemetryInterceptor : IInterceptor
{
    private readonly ActivitySource _activitySource;

    public OpenTelemetryInterceptor(ActivitySource activitySource)
    {
        _activitySource = activitySource;
    }

    public void Intercept(IInvocation invocation)
    {
        var activityName = $"{invocation.TargetType.Name}.{invocation.Method.Name}";
        using var activity = _activitySource.StartActivity(activityName);
        
        // 可选：添加方法参数作为追踪标签
        foreach (var parameter in invocation.Method.GetParameters())
        {
            activity?.SetTag($"param.{parameter.Name}", invocation.Arguments[parameter.Position]);
        }

        try
        {
            invocation.Proceed();
            activity?.SetStatus(ActivityStatusCode.Ok);
        }
        catch (Exception ex)
        {
            activity?.SetStatus(ActivityStatusCode.Error, ex.Message);
            throw;
        }
    }
}

• 在DI容器中注册代理服务：

services.AddTransient<OpenTelemetryInterceptor>();

services.AddTransient<IMainService>(sp =>
{
    var proxyGenerator = new ProxyGenerator();
    var interceptor = sp.GetRequiredService<OpenTelemetryInterceptor>();
    return proxyGenerator.CreateInterfaceProxyWithTarget<IMainService>(
        new MainService(sp.GetRequiredService<ISecondaryService>()),
        interceptor);
});

// SecondaryService按相同逻辑注册

此时，无论外部调用还是服务内部的方法调用（通过接口实例触发），都会被拦截并生成对应的追踪活动。

2. 编译时代码织入：使用Fody实现无侵入追踪 #

Fody是编译时代码织入工具，可在编译阶段自动将追踪代码注入目标方法，无需运行时代理，性能更优，且能捕获所有方法（包括非虚方法）。

实现步骤：

• 安装NuGet包：OpenTelemetry.Fody（社区维护扩展）
• 在项目根目录创建FodyWeavers.xml配置文件：

<Weavers>
  <OpenTelemetry ActivitySourceName="YourApp.ActivitySource" />
</Weavers>

• 定义全局ActivitySource：

public static class Telemetry
{
    public static readonly ActivitySource ActivitySource = new ActivitySource("YourApp.ActivitySource");
}

编译后，所有方法会自动注入追踪逻辑，内部调用也能被完整捕获，无需手动代理或埋点。

3. 框架级自动仪器化（补充方案） #

OpenTelemetry提供了针对常见框架的自动仪器化包，可自动捕获特定场景的调用：

• ASP.NET Core控制器：OpenTelemetry.Instrumentation.AspNetCore
• Entity Framework Core：OpenTelemetry.Instrumentation.EntityFrameworkCore
• HttpClient调用：OpenTelemetry.Instrumentation.Http
  但这类扩展仅覆盖框架级调用，无法满足自定义服务的全函数级追踪需求，需结合前两种方案使用。

方案对比 #

注意事项 #

• 使用Castle DynamicProxy时，服务内部方法需通过接口实例调用（即this为代理实例时，虚方法/接口方法会被拦截），避免直接调用非虚方法或通过this调用未代理的内部方法。
• Fody方案需确保NuGet包版本兼容，编译配置正确。

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