CodeBuddy能自动解析Nginx日志、APM链路或Prometheus指标，精准定位API慢响应根因；需确保输入数据格式合规、脱敏并单文件上传，支持CLI或VS Code插件两种分析方式，输出含P95突增窗口、瓶颈服务及可疑SQL的诊断报告。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要快速定位线上API接口响应慢的根因，比如某个/v1/orders查询接口P95延迟从120ms飙升至850ms，同时QPS下降40%，而日志里只显示“请求处理超时”，没有具体卡点。CodeBuddy能直接解析你导出的Nginx访问日志、APM链路追踪数据或Prometheus指标快照，自动识别慢请求模式、瓶颈服务节点和异常时间窗口，不用手动翻几十个图表或写临时脚本。
准备原始日志与指标数据
第一步：确认数据格式是否满足CodeBuddy解析前提。它只接受三类输入——Nginx access.log（需含$request_time和$upstream_response_time字段）、SkyWalking/Zipkin导出的JSON链路数据（必须带traceId、spanId、duration、service、endpoint）、或Prometheus的.csv导出文件（列名必须含timestamp、metric、value，且metric列包含http_server_request_duration_seconds_sum这类标准指标名）。
第二步：将原始数据整理为单个文件。不要上传多个日志片段，CodeBuddy会按文件粒度做上下文隔离；若你有3天的日志，先用awk '{print $1,$2,$3,$NF}' access.log.20260804 > clean.log合并关键字段，再上传clean.log。
【必须删除敏感字段再上传】比如access.log里的$user_agent可能含设备ID，$http_authorization头可能泄露token，这些字段不删会导致CodeBuddy拒绝解析并报错“context unsafe”。
启动CodeBuddy分析流程
方法一：CLI命令行直连分析
在项目根目录执行codebuddy analyze --input ./clean.log --type nginx --output ./report/。这会触发本地模型加载日志解析器，自动提取request_time分布、状态码比例、URI路径TOP10耗时，并生成./report/summary.md摘要文件。
方法二：VS Code插件图形化操作
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
打开VS Code → 点击左侧CodeBuddy图标 → 选择“Performance Analysis”面板 → 拖入clean.log文件 → 点击“Start Deep Scan”按钮 → 等待右下角状态栏显示“Analysis completed (2.3s)”。此时面板自动展开热力图和调用链瀑布图。
注意：图形化模式默认启用“智能归因”，会跳过常规统计，直接定位到最可疑的3个span（比如某个MySQL查询span duration标准差达±320ms，远高于其他同类型span的±15ms），这个开关无法关闭。
解读关键诊断结论
① 查看P95延迟突增时间点：在生成的report/summary.md中搜索“P95 spike window”，它会标出精确到分钟的时间段，例如“2026-08-05T14:22:00Z–2026-08-05T14:27:00Z”。这个窗口必须和你的业务告警时间对齐，否则说明数据源时间戳未同步UTC。
② 定位瓶颈服务：报告中“Top 3 Bottleneck Services”表格第二列是“Avg Duration Δ vs Baseline”，数值为正且绝对值＞200ms的服务即为嫌疑对象。比如orders-service行显示+412ms，而payment-service仅+18ms，可排除支付侧问题。
③ 验证SQL低效：若报告在“Suspicious Queries”章节列出“SELECT * FROM orders WHERE user_id = ? AND status = 'pending'”，且标注“missing index on (user_id, status)”，这就是根因。不要直接执行CREATE INDEX，先用EXPLAIN ANALYZE验证该SQL在生产库的执行计划是否真走全表扫描。
这一步操作起来很简单，直接把文件拖进去就行。
