技术实践

得物以日志MCP和Skills串联故障定位

智能体系统AI 基础设施应用与实践Agent 工具调用Agent Harness智能体互操作协议Agent Skills可观测性编程MCP

概述

作者把「在日志平台搜日志、复制类名方法名到 IDE 找代码、一次找不准再回去搜」这一固定流程自动化:日志平台侧推出基于 MCP 协议的日志查询服务,Claude Code 通过 SSE 长连接与 MCP Server 通信(鉴权为日志管理后台申请 secretKey→acquireTokenTool 换 accessToken,有效期 1 小时、最多并存 5 个→再调用 logsQuery/logSqlQuery/countLogTool),/log-diagnosis 则以 .claude/skills/log-diagnosis/SKILL.md 描述行为规范,Claude Code 收到命令即自动加载执行。 完整链路为:加载 SKILL.md→读 .diagnosis/config.json→检查并自动刷新 accessToken→从 traceId 第 9-16 位 16 进制时间戳推算日志时间范围→调用 MCP 分页拉取全量日志(最多 20 页)→切换指定代码分支并按日志关键词检索代码→综合上游日志、当前服务日志与代码逻辑得根因→生成飞书文档或本地 Markdown 诊断报告→恢复原始代码分支。 核心能力包括 Token 自动管理、禁止只查首页即下结论的分页全量拉取、自动识别上下游服务做跨服务交叉验证、以及日志中类名/方法名到代码的精确定位。诊断入口支持 traceId 与告警信息两种触发方式。