0

0

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

畫卷琴夢

畫卷琴夢

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

|

635人浏览过

|

来源于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

不设置ActivityKindIdFormat会导致后续无法正确序列化上下文,尤其在跨进程传播时会丢失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.TraceIdActivity.SpanId不够——Baggage(业务透传键值)和TraceState(供应商扩展字段)也需显式传递,否则下游服务无法获取完整上下文。

360AI导航
360AI导航

360导航旗下的AI网址导航站,精选互联网资源最全的AI人工智能网站

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

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

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

  • 显式捕获:在父上下文中调用Activity.Current?.Context保存
  • 显式恢复:在子线程入口处用Activity.StartActivity(activityName, ActivityKind.Internal, context)传入原始ActivityContext
  • 避免使用AsyncLocal<activity></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助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

397

2023.08.11

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

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

247

2023.10.07

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

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

638

2023.08.03

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

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

217

2023.09.04

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

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

1558

2023.10.24

字符串介绍
字符串介绍

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

642

2023.11.24

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

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

1027

2024.03.22

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

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

980

2024.04.29

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

1228

2026.02.13

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C# 教程
C# 教程

共94课时 | 10.1万人学习

C 教程
C 教程

共75课时 | 4.9万人学习

C++教程
C++教程

共115课时 | 19.2万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号