trace_correlate
Correlate traceIds across frontend evidence and backend logs, validate trace coverage, and trace full request chains from browser to backend.
Instructions
traceId 深度关联工具(v1.9.5 起合并 browser_trace_chain 和 trace_correlation_check)。通过 mode 参数区分子模式:view(默认,根据 traceIds 反查前端证据包和后端日志,实现前后端联调闭环)/ check(校验浏览器请求和后端日志是否共享同一 traceId/runId,输出 trace 覆盖率和关联性评分,等价于已废弃的 trace_correlation_check)/ chain(全链路调用链追溯,从 traceId 或时间点追溯前端→API→后端的完整请求链路,等价于已废弃的 browser_trace_chain)。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | URL 包含过滤(mode=chain 时使用) | |
| mode | No | 关联模式:view(默认,traceId 深度关联)/ check(trace 覆盖率校验,等价于 trace_correlation_check)/ chain(全链路调用链追溯,等价于 browser_trace_chain) | view |
| since | No | 只检查此 ISO 时间点之后的请求(mode=check 时使用),默认使用当前 checkpoint | |
| traceId | No | 单个 traceId(与 traceIds 二选一,mode=view/chain 时使用) | |
| traceIds | No | 要关联的 traceId 列表(mode=view 时使用) | |
| statusMin | No | 最小 HTTP 状态码过滤(mode=chain 时使用,如 400 只显示错误请求) | |
| urlContains | No | 只检查 URL 包含此字符串的请求(mode=check 时使用) | |
| useSshBackend | No | 是否通过 SSH 远程查询后端日志(需配置 backend_logs 工具) | |
| backendLogPath | No | 后端日志文件本地路径,将在文件中搜索 traceId | |
| backendLogLines | No | 每个 traceId 返回的后端日志行数上限,默认 10 | |
| includeBackendLogs | No | 是否同时从后端服务器 grep 日志(mode=chain 时使用,需要 SSH 免密) |