Traceway Skill：让 AI Agent 自己查生产可观测性数据的开源神器

Skill超级捕获手 技术创作者 2026-08-31 14 阅读

Traceway 是一个开源可观测性平台，核心思路是把生产环境的日志、链路追踪、指标、异常、会话回放全部打通，让 AI Agent 能直接用自然语言查询生产环境数据、自己找根因。传统调试流程要在多个平台之间来回切换、手动关联日志——Traceway 通过内嵌 AI 链路，把这个过程压缩成一句话就能搞定。

功能与设计原则

Traceway 提供两个 Claude Code Skill：traceway-setup 负责初始化项目，将后端、前端、移动端各类应用接入 Traceway 实例；traceway 则是运行时查询 CLI，通过 /traceway slash command 直接查询异常、日志、端点性能、AI 追踪数据，并结合上下文给出根因分析。设计原则是”AI-First”——不是给人看的仪表盘，而是给 AI Agent 看的结构化数据接口。

认可度

traceway-setup Skill 在 SkillsMP 拥有 1,069 stars（截至 2026-08-31）；GitHub 主仓库 tracewayapp/traceway 约 859 stars，近一个月有 HN 首页曝光，社交讨论度高。项目采用 MIT 许可证，完全开源。

链接

GitHub: https://github.com/tracewayapp/traceway

原作者

tracewayapp（组织），项目采用 MIT 许可证，主要贡献者来自社区，Discord 活跃。

介绍

Traceway 是一款 OpenTelemetry 原生的自托管可观测性平台，用 Go 语言编写，生产部署只需一条 docker compose up --build，号称”90 秒启动完整可观测性栈”。平台功能覆盖：

  • 日志（Logs）：结构化、链路关联、亚秒级搜索
  • 链路追踪（Traces）：跨服务完整 span 水瀑布，点击日志直接跳转到对应 trace
  • 指标（Metrics）：主机、运行时、自定义指标，多维度图表
  • 异常（Exceptions）：SHA-256 归一化堆栈分组，source-map 支持（webpack/esbuild/Vite）
  • 会话回放（Session Replay）：Web（任意 JS 框架）和 Flutter，移动端也支持
  • AI 追踪（AI Observability）：LLM 成本、tokens、延迟、完整对话记录，支持 OpenRouter 及兼容 OTel 的 AI 网关

核心技术栈：后端 Go/Gin + ClickHouse + PostgreSQL，前端 SvelteKit，OTel SDK 直连，不需要额外的 Collector 或厂商 SDK。

特点

  • 零基础设施依赖：不需要 OTel Collector，不需要每种语言单独的 vendor SDK，OTLP/HTTP 直收
  • 90 秒自托管：一条 docker compose up 跑完整栈，MIT 许可证，无 BSL、无”开源核心”限制
  • AI Agent 原生集成：Agent 可以自己查询生产可观测性数据，告别”复制日志到 ChatGPT”的老套路
  • 嵌入式追踪：Go 应用可以直接在进程内运行 Traceway，无需外部数据库，适合本地开发和测试
  • 生产问题即问即答：输入 /traceway users report 500s on checkout since this morning，Agent 自动查异常、查日志、定位根因并生成修复方案

使用方法

安装 Skill：

npx skills add tracewayapp/traceway

初始化项目接入：

/traceway-setup with token <your-token>

后端使用 OpenTelemetry over OTLP/HTTP 接入，前端/移动端使用 Traceway SDK，主机指标使用 Traceway OTel Agent。

运行时查询：

/traceway exceptions list --since 24h --search checkout
/traceway logs query --trace-id <id>
/traceway what's broken in prod

使用场景与人群

  • 需要快速定位生产问题的开发者（”2 分钟修好线上 bug”不再夸张）
  • 希望用 AI Agent 自动分析异常日志、降低人工排查成本的团队
  • 需要对 AI 编码过程做可观测性追踪（LLM 调用成本、tokens 消耗）的工程团队
  • 不想被 Datadog/Sentry 等商业产品绑定的自托管爱好者

输入与输出案例

输入：

/traceway users report 500s on checkout since this morning

输出：

TypeError: cart is null · 412 events · first seen 09:14
Root cause: repeat purchase reuses an expired cart.
Fix ready for review in src/checkout/session.ts:42.

输入：

/traceway-setup with token abc123

输出：

[traceway-setup] 开始分析项目结构...
已检测到后端: Node.js/Express，已注入 OpenTelemetry SDK
已检测到前端: SvelteKit，已安装 @traceway/web-sdk
端点报告已激活，指标上报已开启
✅ 项目接入完成，数据将在 30 秒内出现在 Traceway 仪表盘

GitHub: https://github.com/tracewayapp/traceway

评论区

0 条评论

登录后可评论。

Skill超级捕获手 14 阅读