基础篇
进阶篇
高频篇
精选篇
手写篇
面经篇
AI 篇
原理篇
每日一题
小程序题库
  • 知识卡片碎片时间过考点
  • 场景篇按分类整理的大前端场景考点
  • 历年面经按年份追踪真实考点
  • 算法题库NEW在线编码即时判题
  • 专项自测100 题快速查漏
  • 前端基础
    • HTTP从报文一路讲到 HTTPS
    • 浏览器渲染、事件循环、进程
    • 计算机基础Linux、网络、操作系统
  • 进阶专项
    • 设计模式23 种模式怎么用
    • 前端系统进阶学习大型项目工程化
    • 前端综合文章长期沉淀的实践文
  • 工程与工具
    • Node学习指南从环境搭建到服务端
    • NPM工作流script、依赖与发布
    • Docker容器化部署上手
    • Canvas图形与动画实战
  • 路线与导图
    • 思维导图知识点全景图
    • 学习路线按图索骥不跑偏
  • 动态
    • 公众号动态公众号历史文章
    • 博客动态站长的技术博客
    • 开发者导航常用工具与文档站
    • AI 热点每日 AI 资讯与动向
AI 工作台
旧版
AIHT
内容
精选全部 AI 动态热点榜AI 日报收藏
分类
模型行业编程产品技术观点开源
更多
Agent 接入
返回首页开发者导航
AIHT
精选 / 资讯详情
8.0
热点
AI SCORE
编程提效2026-11-22 16:30

通过 MCP 让 Claude Code 直接查询日志

dev.to · AI#MCP#Claude Code#日志排障
Editor brief · 编辑速览

文章演示将 Rudow 的 MCP 服务接入 Claude Code,让编程代理直接搜索日志、聚合数据、查看事件和指标。服务提供 17 个只读工具,使用前需接入日志并配置 MCP 密钥。

文章思维导图
Knowledge map
拖拽缩放
AI deep read

AI 深度解读

生产报错后,开发者常常得在日志平台和 Claude Code 之间来回复制内容:先搜一轮,再补上下文,模型追问时继续找。作者提出的改法很直接:通过 MCP,让编码代理自己查询日志。

Rudow 提供日志存储和只读查询能力,Claude Code 负责串联证据、分析代码。作者用一次模拟结账故障展示了这套流程:它能缩短人工搬运信息的路径,但效果仍取决于日志是否充分,以及代理是否交代调查边界。

接上 MCP,还得先把日志送进去

MCP(Model Context Protocol)可以理解为代理调用外部工具的接口。在这里,它连接 Claude Code 与 Rudow,让代理获得搜索、聚合、列出事故和提取指标等 17 个只读工具。

连接命令只有一行:

claude mcp add --transport http rudow https://mcp.rudow.ai/mcp

注意 --transport http:这里连接的是远程 MCP 服务。随后需要提供 MCP key,在 Rudow 的 Settings → Account → MCP keys 创建,前缀为 alogmcp_。

连接成功不代表已经有数据。服务日志还要通过 Node SDK、Python SDK 或 HTTP 接入。原文分别给出了 npm install @rudow/node-logger 和 pip install rudow;Node 侧用 createLogger({ apiKey: process.env.RUDOW_API_KEY }) 初始化。

不使用 SDK,也可以直接提交日志:

curl -X POST https://api.rudow.ai/v1/ingest \
  -H "Authorization: Bearer $RUDOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"entries": [{"message": "POST /charge failed", "level": "error", "source": "payment-service"}]}'

注意 Authorization 使用的写入密钥:它在 Settings → Projects → API keys 创建,前缀为 alog_,与 MCP 查询密钥不同。原文要求将其放进环境变量,不要提交到源码仓库,并称日志会在数秒内出现在 Logs 页。

这里的职责划分很清楚:Rudow 保存并回答日志问题,Claude Code 利用结果继续调查。只读权限限制的是这条日志查询通道,不能据此推断编码代理其他工具的权限。

一次连接池故障,代理查出了什么

作者测试的是模拟结账后端,包括 checkout API、payment service,以及最大 100 个连接的 Postgres 连接池。

故障由 deploy #842 引入:每次支付调用都占用连接 8 秒,连接池逐渐耗尽,结账开始失败。作者向 Claude Code 提问:「今天 checkout 出了什么问题?检查日志。」

代理通过 Rudow 查询后,判断 payment service 在 #842 部署后耗尽数据库连接,回滚到 #841 后恢复。它给出的证据包括:

  • POST /charge 和 POST /refund 报错,出现 timeout acquiring connection from pool (waited 5000ms) 和 pool exhausted, active=100 idle=0。
  • 共查到 139 次连接池耗尽错误,从 #842 发布后 47 秒开始,到回滚时停止。
  • 连接池达到 100/100,另有 113 个请求等待。
  • 警告日志记录了 #842 每个 charge 请求占用连接 8 秒。

这些证据能串成一条相互支持的解释:部署改变连接占用时间,连接池饱和,请求等待并超时;回滚后错误停止。作者称,代理重建的时间线与部署日志一致。

不过,这是一个已知故障原因的模拟案例。原文没有提供真实生产事故中的成功率,也没有比较人工排查、直接粘贴日志与 MCP 查询分别耗时多久。附带的 44 秒真实 Claude 会话演示,也不能当作完整排障耗时的对照数据。

更有用的输出,是结论后面带着调查范围

这次案例还有一个细节:代理主动承认,它只向前读取了有限范围的错误,因此无法确认更早的部署窗口是否也失败过,也没有统计全部失败支付次数。

查到多少证据,就下多大范围的结论。

对于程序员,这比一句笼统的「已经定位问题」更有用。连接池耗尽的错误条数,不等于失败支付总数;回滚后错误停止,也不能证明所有业务影响都已消除。

作者认为,让代理直接查询生产日志会成为未来调试的重要工作方式。这属于趋势判断。案例实际展示的是:在日志已经接入、故障信号明确的情况下,代理可以自行补查证据,减少开发者反复搜索和粘贴的操作。Rudow 不写代码,也不修复缺陷,后续修改仍由编码代理和开发者完成。

我的判断

我赞成把日志查询能力交给代理,尤其是需要连续追问的调查。粘贴日志容易把上下文固定在第一次搜索结果里;代理能继续查询,才有机会检验最初的猜测。

但原文属于产品演示,尚不足以证明 Rudow 比现有日志平台或其他查询接口更有效。作者强调原生 MCP、只读设计、固定价格和硬上限,其中「原生」究竟带来多少实际收益,没有对照数据,这是经验判断与产品主张。

按原文标价,免费 Hobby 档每月包含 200,000 条日志,也开放 MCP;付费档为 Dev $9.99、Pro $29.99、Team $79.99。原文没有交代付费档具体配额,也没解释触及硬上限后的行为,不能只凭价格判断适不适合团队。

只读设计能限制日志侧的修改行为,但日志质量、敏感信息处理和访问范围仍需团队自己确认。若日志里缺少部署记录、服务来源或连接池状态,代理也无法凭空补齐证据。

能拿来做什么

  • 如果你维护 Node 后端,可以先选一个服务接入日志,确认错误消息、服务来源和部署记录能否支撑一次完整调查,再决定是否扩大接入范围。
  • 在 Claude Code 中提问时,同时要求给出时间范围、证据、统计口径和未确认事项,避免把局部查询结果当作完整事故结论。
  • 用一个原因已知的故障做验证,例如连接池耗尽,检查代理能否正确关联部署、报错与恢复时间,并核对它引用的数字。
  • 评估替换现有流程前,记录人工搬运日志的实际耗时,再比较代理查询后的效果;原文没有替你完成这项对照。
Original source

本文由 AI 通读原文后重新编写,观点部分为站内判断,细节以原文为准,来源 dev.to · AI,原文版权归原作者所有。

阅读原文
上一篇
用成本埋点和请求分流控制大模型账单
下一篇
Agent 推送前审批规则为何没有生效

资讯速览

dev.to · AI · 2026-11-22 16:30

AI 评分 8.0 / 10

相关标签

#MCP#Claude Code#日志排障

继续阅读

  • Claude Code 项目指令文件的读取优先级
  • 用成本埋点和请求分流控制大模型账单
  • Agent 推送前审批规则为何没有生效
  • 为 Agent 提交接口增加写入预演
  • 用 Claude Code 钩子拦截危险命令