Files
nexus/wiki/concepts/ExecutionTracing.md
2026-05-03 05:42:12 +08:00

1.3 KiB
Raw Blame History

title, type, tags, last_updated
title type tags last_updated
ExecutionTracing concept
2026-05-02

Definition

Execution Tracing执行追踪是追踪请求、事件、命令在系统中完整流动路径的方法。通过追踪数据如何进入、转换、持久化和退出建立对代码库实际工作方式的准确理解。

Core Steps

  1. Identify entry point — 找到请求/命令的入口文件
  2. Follow routing logic — 追踪路由/控制器层的分发逻辑
  3. Trace business logic — 追踪核心业务逻辑的调用链
  4. Map persistence layer — 找到数据持久化或副作用发生的位置
  5. Track return path — 追踪结果如何返回到调用方

Key Signals to Track

  • Inputs: HTTP requests, CLI args, messages, files, function arguments
  • Transforms: Data validation, enrichment, computation, aggregation
  • Outputs: Responses, DB writes, files, events, rendered UI

Async & Side Channels

  • 异步 jobs 和 queues
  • Cron tasks 和定时任务
  • Background workers
  • Client-side state 变更

Usage Context

  • 理解新代码库的运行机制
  • 定位 bug 的根本原因
  • 评估代码变更的潜在影响范围