链路追踪说明

编写人：刘洋

系统：行政协同平台

日期：0000-00-00

采样：生产 100%

状态：网页到数据库可串起来

一、追踪目的

一次点击从网页到应用再到数据库，共用一个 traceId，方便把慢的那一段找出来。生产流量每天约几千次请求，全部采样。预发同样全采样。编号格式 TR- 加数字，写进日志和埋点。员工页面的错误详情里也显示这个编号，便于发给值班人。陈静于 9月13日拿自己的一次请假把三段时间对上了。

二、传递路径

样例是陈静提交事假 LV-0000-080。网页 180 毫秒是她看到成功的时间。通知 1.2 秒发生在请求返回之后，所以员工不用等企业微信才看到提交成功。数据库慢于 200 毫秒时，李莉用同一个编号在慢日志里过滤。

三、采样与保留

1. 生产和预发都是 100%。若日请求超过 20 万，再改为 10%，目前远低于这条线。
2. 追踪数据保留 15 天，与运行大盘相同。日志里的 traceId 跟随日志保留 30 天。
3. 健康检查使用固定编号 TR-HEALTH，不计入业务耗时报表。

四、值班用法

员工报「提交中」时，先要页面上的 traceId。值班人在日志里搜到 action 和 bizId，再看数据库那一段的毫秒数。9月16日列表变慢的几次请求都能用编号找到扫描行数。没有编号的旧客户端只剩会议室平板，平板不走这条网页，因此不在追踪范围内。刘洋保证新页面都带上响应头。9月13日陈静的 TR-0000-771 在日志、数据库注释和待办发送记录里各出现 1 次，三段编号相同。王芳在 9月19日的 Edge 预订上也看到响应头，编号 TR-0000-902，与新建的 BK-0000-230 写在同一行日志里。