---
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]] — 为开发者构建准确的心智模型