Codar 预置工作流

问题调试定位

系统性排查线上或测试环境的异常,从日志、监控和代码层面定位根因

通用6 个步骤v1更新于 2026-11-19

流程图

  • 数据输入
  • 预处理
  • 核心分析
  • 结果输出

步骤说明6 步

  1. 采集现象和上下文数据输入

    收集错误信息、日志、堆栈跟踪、复现步骤和环境信息。确认问题的影响范围和频率。

    下一步02 分析日志和监控

  2. 分析日志和监控预处理

    检查应用日志、数据库慢查询、请求链路和资源监控(CPU、内存、网络)。找出异常时间点和关联事件。

    下一步03 代码层面定位

  3. 代码层面定位核心分析

    根据堆栈跟踪定位到具体代码,检查逻辑分支、边界条件、并发处理和资源释放。必要时添加调试日志。

    下一步04 构造根因假设05 验证假设

  4. 构造根因假设核心分析

    基于现象和代码分析,提出根因假设(配置错误、数据异常、并发竞争、资源耗尽等)。

    下一步05 验证假设

  5. 验证假设核心分析

    通过本地复现、单元测试或补充日志验证假设。排除无关因素,缩小问题范围。

    下一步06 输出根因和修复方案

  6. 输出根因和修复方案结果输出

    明确根本原因、触发条件和影响范围,提出修复方案和预防措施。

使用原则

  • 参考上述步骤、工具和依赖关系,结合本次目标、数据与可用工具安排研究过程。
  • 可以调整顺序、补充必要检查或省略不适用的步骤,重要调整需说明原因。
  • 用户本次的明确要求优先于此参考;关键意图不清楚时先提问。

workflow.md

查看工作流源文件
---
format: codar-workflow
schemaVersion: 1
layoutDirection: TD
id: "debug-trace-hwctl5ix"
version: 1
name: "问题调试定位"
domain: "通用"
description: "系统性排查线上或测试环境的异常,从日志、监控和代码层面定位根因"
---

# 问题调试定位

## 流程图

```mermaid
flowchart TD
    n1["采集现象和上下文"]
    n2["分析日志和监控"]
    n3["代码层面定位"]
    n4["构造根因假设"]
    n5["验证假设"]
    n6["输出根因和修复方案"]
    n1 --> n2
    n2 --> n3
    n3 --> n4
    n3 --> n5
    n4 --> n5
    n5 --> n6
```

## 节点

### 采集现象和上下文 {#n1}
- 类别: 数据输入
- 位置: 40, 40
- 说明: |
  收集错误信息、日志、堆栈跟踪、复现步骤和环境信息。确认问题的影响范围和频率。

### 分析日志和监控 {#n2}
- 类别: 预处理
- 位置: 40, 176
- 说明: |
  检查应用日志、数据库慢查询、请求链路和资源监控(CPU、内存、网络)。找出异常时间点和关联事件。

### 代码层面定位 {#n3}
- 类别: 核心分析
- 位置: 40, 312
- 说明: |
  根据堆栈跟踪定位到具体代码,检查逻辑分支、边界条件、并发处理和资源释放。必要时添加调试日志。

### 构造根因假设 {#n4}
- 类别: 核心分析
- 位置: 40, 448
- 说明: |
  基于现象和代码分析,提出根因假设(配置错误、数据异常、并发竞争、资源耗尽等)。

### 验证假设 {#n5}
- 类别: 核心分析
- 位置: 40, 584
- 说明: |
  通过本地复现、单元测试或补充日志验证假设。排除无关因素,缩小问题范围。

### 输出根因和修复方案 {#n6}
- 类别: 结果输出
- 位置: 40, 720
- 说明: |
  明确根本原因、触发条件和影响范围,提出修复方案和预防措施。

## 使用原则

- 参考上述步骤、工具和依赖关系,结合本次目标、数据与可用工具安排研究过程。
- 可以调整顺序、补充必要检查或省略不适用的步骤,重要调整需说明原因。
- 用户本次的明确要求优先于此参考;关键意图不清楚时先提问。