讲师中心 微信公众号
AI工具推荐 视频效率加速

C# Activity分布式追踪上下文 C#如何手动创建和传播Activity

小明大大_2410

小明大大_2410

发布时间:2026-02-24 10:34:02

|

695人浏览过

|

来源于php中文网

原创

Activity手动创建必须设置Kind和IdFormat,否则跨进程传播时丢失TraceId;默认构造函数创建的Activity无效;需用new Activity("name")后调用Start()或SetParentId();IdFormat须设为W3C以兼容TraceContext;服务端应从traceparent头解析而非新建;Baggage和TraceState必须显式传播;跨线程需显式捕获并恢复ActivityContext;HttpClient应禁用自动追踪并手动注入traceparent。

c# activity分布式追踪上下文 c#如何手动创建和传播activity

Activity手动创建必须设置Kind和IdFormat

不设置ActivityKind或IdFormat会导致后续无法正确序列化上下文,尤其在跨进程传播时会丢失TraceId。默认构造函数创建的Activity处于Stopped状态且无有效ID,不能用于分布式追踪。

  • Activity必须用new Activity("name")构造,然后立即调用SetParentId()或Start()(后者自动分配Id)
  • 若需手动控制ID格式(如兼容W3C TraceContext),必须设activity.IdFormat = ActivityIdFormat.W3C
  • 服务端接收请求时,应优先从HTTP头(如traceparent)解析并用Activity.ExtractRootId()还原,而非新建

手动传播ActivityContext需同步Baggage和TraceState

仅复制Activity.TraceId和Activity.SpanId不够——Baggage(业务透传键值)和TraceState(供应商扩展字段)也需显式传递,否则下游服务无法获取完整上下文。

C#
C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载
  • 发送方:用activity.Context.ToTraceParentString() + activity.Baggage分别写入HTTP头(traceparent、tracestate、baggage)
  • 接收方:用ActivityContext.TryParse()解析traceparent,再用ActivityContext.CreateBaggage()重建Baggage
  • 注意Baggage是只读集合,修改需调用WithBaggageItem()生成新实例

跨线程/异步任务中Activity不会自动继承

.NET 6+ 默认启用Activity.Current在线程/Task间自动流转,但仅限于async/await路径;手动启线程(Task.Run、ThreadPool.QueueUserWorkItem)或同步阻塞调用会丢失上下文。

  • 显式捕获:在父上下文中调用Activity.Current?.Context保存
  • 显式恢复:在子线程入口处用Activity.StartActivity(activityName, ActivityKind.Internal, context)传入原始ActivityContext
  • 避免使用AsyncLocal<Activity>手动管理——它已被Activity.Current底层封装,直接操作易破坏一致性

HttpClient调用时不要依赖默认Activity自动创建

HttpClient在.NET 5+中默认开启Activity自动追踪,但其行为受HttpHandler配置和DiagnosticSource订阅影响,手动传播时容易与自动逻辑冲突,导致重复Span或Context覆盖。

  • 禁用自动追踪:构造HttpClient时传入new SocketsHttpHandler { ActivityHeadersPropagated = false }
  • 手动注入:在发送前设置request.Headers.TryAddWithoutValidation("traceparent", context.ToTraceParentString())
  • 注意traceparent字符串必须严格符合W3C格式(如00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01),否则接收方解析失败
实际中最容易被忽略的是Baggage的显式传播和IdFormat的预设——这两个点一旦遗漏,跨语言服务(如Go/Java下游)就收不到预期的业务标识字段,排查时往往卡在“上下文看起来存在,但关键数据没了”。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
什么是分布式
什么是分布式

分布式是一种计算和数据处理的方式,将计算任务或数据分散到多个计算机或节点中进行处理。本专题为大家提供分布式相关的文章、下载、课程内容,供大家免费下载体验。

2053

2023.08.11

分布式和微服务的区别
分布式和微服务的区别

分布式和微服务的区别在定义和概念、设计思想、粒度和复杂性、服务边界和自治性、技术栈和部署方式等。本专题为大家提供分布式和微服务相关的文章、下载、课程内容,供大家免费下载体验。

3194

2023.10.07

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1758

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2744

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

6104

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

5769

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

7414

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

10894

2024.04.29

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

0

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn