Update nexus wiki content
This commit is contained in:
42
wiki/concepts/ExecutionTracing.md
Normal file
42
wiki/concepts/ExecutionTracing.md
Normal file
@@ -0,0 +1,42 @@
|
||||
---
|
||||
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]] — 为开发者构建准确的心智模型
|
||||
Reference in New Issue
Block a user