.net 微服务jeager链路跟踪

在 .NET 微服务中集成 Jaeger 链路跟踪可以帮助你监控和分析服务之间的调用关系和性能瓶颈。下面是实现步骤和示例代码：

1. 安装必要的 NuGet 包

需要安装以下包到每个微服务项目中：

• OpenTelemetry.Extensions.Hosting
• OpenTelemetry.Instrumentation.AspNetCore
• OpenTelemetry.Exporter.Jaeger

2. 配置 Jaeger 链路跟踪

在 Program.cs 中添加 Jaeger 配置：

using OpenTelemetry;using OpenTelemetry.Resources;using OpenTelemetry.Trace;var builder = WebApplication.CreateBuilder(args);// 添加服务builder.Services.AddControllers();// 配置 Jaeger 链路跟踪builder.Services.AddOpenTelemetryTracing(tracerProviderBuilder =>{ tracerProviderBuilder // 设置服务资源信息 .SetResourceBuilder(ResourceBuilder.CreateDefault() .AddService(serviceName: builder.Environment.ApplicationName, serviceVersion: \"1.0.0\")) // 启用 ASP.NET Core instrumentation .AddAspNetCoreInstrumentation() // 启用 HttpClient instrumentation (用于跟踪服务间调用) .AddHttpClientInstrumentation() // 配置 Jaeger 导出器 .AddJaegerExporter(options => { // Jaeger 服务地址，默认端口是 6831 options.AgentHost = \"localhost\"; options.AgentPort = 6831; // 可选：配置服务名称（如果未通过 ResourceBuilder 设置） // options.ServiceName = builder.Environment.ApplicationName; });});var app = builder.Build();// 中间件配置app.UseRouting();app.UseAuthorization();app.MapControllers();app.Run();

3. 手动创建自定义跨度（Span）

如果需要跟踪特定的代码块，可以手动创建跨度：

using Microsoft.AspNetCore.Mvc;using OpenTelemetry.Trace;namespace JaegerDemo.Controllers;[ApiController][Route(\"[controller]\")]public class WeatherForecastController : ControllerBase{ private static readonly string[] Summaries = new[] { \"Freezing\", \"Bracing\", \"Chilly\", \"Cool\", \"Mild\", \"Warm\", \"Balmy\", \"Hot\", \"Sweltering\", \"Scorching\" }; private readonly ILogger<WeatherForecastController> _logger; private readonly Tracer _tracer; private readonly HttpClient _httpClient; public WeatherForecastController( ILogger<WeatherForecastController> logger, Tracer tracer, HttpClient httpClient) { _logger = logger; _tracer = tracer; _httpClient = httpClient; } [HttpGet(Name = \"GetWeatherForecast\")] public async Task<IEnumerable<WeatherForecast>> Get() { // 创建自定义跨度 using var customSpan = _tracer.StartActiveSpan(\"CustomWeatherProcessing\"); try { // 添加自定义标签 customSpan.SetAttribute(\"location\", \"Beijing\"); // 调用其他服务（会自动被跟踪） var response = await _httpClient.GetAsync(\"https://api.example.com/weather\"); response.EnsureSuccessStatusCode(); return Enumerable.Range(1, 5).Select(index => new WeatherForecast { Date = DateOnly.FromDateTime(DateTime.Now.AddDays(index)), TemperatureC = Random.Shared.Next(-20, 55), Summary = Summaries[Random.Shared.Next(Summaries.Length)] }) .ToArray(); } catch (Exception ex) { // 记录错误到跨度 customSpan.RecordException(ex); customSpan.SetStatus(Status.Error); throw; } }}

4. 启动 Jaeger 服务

可以使用 Docker 快速启动 Jaeger：

docker run -d --name jaeger \\ -e COLLECTOR_ZIPKIN_HOST_PORT=:9411 \\ -p 5775:5775/udp \\ -p 6831:6831/udp \\ -p 6832:6832/udp \\ -p 5778:5778 \\ -p 16686:16686 \\ -p 14268:14268 \\ -p 14250:14250 \\ -p 9411:9411 \\ jaegertracing/all-in-one:1.47

启动后，访问 http://localhost:16686 可以打开 Jaeger UI 查看跟踪数据。

5. 关键配置说明

• ServiceName：每个微服务应该有唯一的服务名，便于在 Jaeger UI 中区分
• AgentHost 和 AgentPort：Jaeger Agent 的地址，默认是 localhost:6831
• 自动 instrumentation 会跟踪：
  • HTTP 请求（ASP.NET Core）
  • HttpClient 调用
  • 数据库操作（需额外安装对应 instrumentation 包）

通过这种方式，你可以实现 .NET 微服务的分布式链路跟踪，帮助诊断跨服务调用中的问题。