优化首页 TraceID 全局搜索的预计算延迟
0x01 背景
a. 现状
- 首页全局搜索 TraceID 走
monitor_web.overview.search.TraceSearchItem。 - 数据源仅为租户级共享的预计算结果表（
DataLink.pre_calculate_config.cluster[*].table_name）。 - 预计算由实时聚合任务异步写入，从 Span 落原始库到落预计算库存在分钟级延迟。
b. 痛点
- 用户复制刚产生的 TraceID 到首页搜索，分钟级窗口内持续返回空结果。
- 命中失败的现象与"无此 Trace"无法区分，用户无从判断是延迟还是真无数据。
- 现有路径无法绕过：预计算是唯一数据源。
c. 目标
- 让用户在 Span 写入原始库后即可在首页搜到对应 Trace。
- 不削弱预计算路径对老数据的广度覆盖。
- 单次首页搜索的资源开销与响应时延控制在可接受范围。
0x02 需求范围
SearchSerializer增加非必填bk_biz_id（用户当前所在业务），仅作候选输入，不强制语义。- 在预计算路径之外新增一条"应用原始 Trace 直查"快速通道。
- 候选业务来源固定为：
bk_biz_id入参、UserConfig.DEFAULT_BIZ_ID、UserVisitRecord中用户最近访问过的 APM 应用所属业务。 - 候选应用按"访问记录分层 + 业务来源 + 服务数"加权，取 TopN（默认
15）。 - 预计算路径与直查路径并行收集，按
application_id去重后流式累计最多K=3条。 - Trace 收集使用绝对
5sdeadline，与Searcher.get(timeout=5)对齐；超时保留已有0～2条并正常结束。 - 命中后装配的 item 字段与现有
TraceSearchItem输出保持一致。
0x03 非目标
- 不替换、不重写预计算路径，老数据仍由预计算覆盖。
- 不引入应用级权限前置过滤（保留现状，由前端跳转时处理）。
- 不改动预计算任务本身的写入链路与频率。
- 不扩大候选业务为"用户全部有权限业务"，避免雪崩式 ES 并发。
- 不引入
SearchItem.item_timeout等单项特判超时体系。 - 本期不改造 SSE
event: end协议以携带结束原因。 - 不强制取消已发出的 UQ 请求；停止信号只阻止尚未发起的新查询。
0x04 方法论
- 直查路径复用
apm_web.handlers.db_handler.DbQuery.get_q的BK_APM数据源构造，时间字段切到OtlpKey.END_TIME。 - 候选应用通过
Application模型直接查询，不走 API 层。 K、TopN、并发与 Trace 超时参数集中在TraceSearchItem内部；K不复用page_size。Searcher回到流式汇聚 +get(timeout=5)；Trace 内部deadline=5自行收口。- 设计、文件级落点、加权公式、并发控制与验收标准统一沉淀到 PLAN.md。
0x05 验收标准
- 用户对一条新写入原始库、尚未进入预计算的 Trace，在首页搜索能在
5s内命中。 - 老 Trace（已落预计算）的命中率与首条结果时延不退化。
- 直查路径 miss 时不抛错、不阻塞预计算路径返回。
- 直查并发数严格不超过 TopN 上限；预计算并发不超过
5。 - 累计命中达到
K=3后立即停止提交新查询。 K<3时，候选耗尽或到达5sdeadline 均可结束，并保留已有结果。- 候选业务/应用的去重、加权与业务来源覆盖在测试用例中可逐项追溯。
0x06 参考
monitor_web/overview/search.py：TraceSearchItem、Searchermonitor_web/overview/views.py：SearchSerializer、SearchViewSetmonitor_web/overview/resources.py：GetFunctionShortcutResource.get_recent_shortcutsmonitor/models/models.py：UserConfig.Keys.DEFAULT_BIZ_IDapm_web/models/application.py：Application.service_count、trace_result_table_idapm_web/models/visit_record.py：UserVisitRecordapm_web/handlers/db_handler.py：DbQuery.get_q