5.7设置跟踪标识

创建于 2026 年 8 月 17 日约 1 分钟读完

为请求指定一个唯一标识符，便于跟踪和调试。该标识符将被设置在 X-Trace-ID 请求标头中。

HTTP 声明式请求通过 TraceIdentifierAttribute 特性来设置跟踪标识。相应的 HTTP 声明式提取器实现为 TraceIdentifierDeclarativeExtractor 类型，该类型负责解析 TraceIdentifierAttribute 特性并构建 HttpRequestBuilder 实例所需的跟踪标识配置。

cs
// 在接口定义上应用，影响所有方法[TraceIdentifier("your-id")]public interface IHttpService : IHttpDeclarative{    [Get("https://furion.net/")]    Task<string> GetStringAsync();    // 在方法上应用    [TraceIdentifier("your-method-id")]    [Get("https://furion.net/")]    Task<string> GetStringAsync();}

TraceIdentifierAttribute 包含以下构造函数和属性：

  • 构造函数：

    • new(traceIdentifier)：作用于方法或接口，设置跟踪标识。

  • 属性：

    • Identifier：跟踪标识（string 类型）。