43 lines
1.3 KiB
Markdown
43 lines
1.3 KiB
Markdown
---
|
||
title: "ExecutionTracing"
|
||
type: concept
|
||
tags: []
|
||
last_updated: 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 的根本原因
|
||
- 评估代码变更的潜在影响范围
|
||
|
||
## Related Concepts
|
||
|
||
- [[CodebaseOnboarding]] — 代码库 onboarding 的方法论
|
||
- [[MentalModel]] — 为开发者构建准确的心智模型
|