30 lines
1.1 KiB
Markdown
30 lines
1.1 KiB
Markdown
---
|
||
title: "Log-Driven Debugging"
|
||
type: concept
|
||
last_updated: 2026-04-10
|
||
---
|
||
|
||
## Definition
|
||
Log-Driven Debugging 是一种通过系统日志定位问题根因的调试方法，尤其适用于分布式系统和多层配置架构。当错误信息具有误导性时，日志是最直接的系统状态反映。
|
||
|
||
## Key Insight
|
||
> **日志真的有用：Gateway 日志把问题写得明明白白，只是我自己没仔细看。**
|
||
|
||
## OpenClaw Gateway Log Example
|
||
```
|
||
provider=custom-api-deepseek-reasoner/deepseek-reasoner ctx=16000
|
||
estimatedPromptTokens=393 overflowTokens=392 reserveTokens=16384
|
||
```
|
||
这条日志直接揭示了：
|
||
1. 当前模型已被切换为 deepseek-reasoner
|
||
2. 模型 context window 为 16K
|
||
3. Safeguard 预留 16K tokens 导致 overflow
|
||
|
||
## Related
|
||
- [[Error-Surface-vs-Root-Cause]]: 日志帮助还原真实根因
|
||
- [[Hidden-Failure-Paths]]: 日志是发现隐藏故障路径的唯一可靠手段
|
||
- [[Layered-Configuration]]: 日志帮助识别配置层级问题
|
||
|
||
## Sources
|
||
- [[养虾日记4-一次「context-limit-exceeded」错误排查-我以为是小问题-结果踩了大坑]]
|