Traceway

Traceway 是 dusanstanojeviccs 在 GitHub 组织 tracewayapp 下开源的可观测性（observability）平台，基于 OpenTelemetry。它把一个线上应用的日志、链路追踪（traces）、指标、异常报错、会话回放（session replay）和值班告警放进同一个后台；后端只要把 OpenTelemetry 数据发过来就能接上，网页和手机应用用 Traceway 自己的 SDK。和 AI 有关的部分有两块：一是 AI 调用追踪，记录大模型调用的成本、token 数、延迟和完整对话；二是仓库附带的两个 Agent Skill，traceway-setup 让 Claude Code、Cursor、Codex 这类编程代理读你的代码、帮你接上监控，traceway 让代理装好命令行工具（CLI），去查线上的报错和日志，一路追到问题原因。README 说这个 CLI 除了归档报错（要加 --yes 确认）以外都是只读的。可以用 Docker 自己部署，也可以用官方的 Traceway Cloud。它特别的地方在于，README 说所有功能都在同一份 MIT 许可的代码里，自己部署和云端跑的是同一套，没有只留给付费版的功能。

适合谁：需要排查线上应用或 AI 代理（Agent）运行问题的开发者和运维人员。不写代码的读者用不上。

使用前提：自己部署要用 Docker，README 给的 docker compose 会启动 Traceway、PostgreSQL 和 ClickHouse，占用 80 端口；配置里的数据库密码和 JWT 密钥是示例占位，SECURITY.md 说只供本地开发，正式使用必须换掉。Traceway Cloud 是可选的付费托管，价格以官网为准。接入前要清楚它默认会采集哪些数据：网页 SDK 默认开启会话回放，用 rrweb 记录页面内容（DOM）和用户的点击、滚动、输入等操作，每 30 秒切一段，出现报错时把当时的录像一起上传；打开 recordAllSessions 后会持续上传每一次访问的全部录像。默认只遮蔽密码输入框，姓名、邮箱、金额、聊天内容、头像这些，都要你自己在页面里加 rr-mask、rr-block、rr-ignore 标记才会被遮住，也可以设 sessionRecording: false 整个关掉。AI 调用追踪会记录完整对话和工具调用，README 建议把 user.id 设成稳定的客户编号。这些数据都会发到你自己部署的服务器或你选的云端，接入前请想好遮蔽范围、怎么告知你的用户、保存多久。traceway-setup 会读取并修改你的代码仓库：加入 SDK、把令牌写进不提交到 Git 的 env 文件、在 CI 里加 source map 上传；SKILL.md 规定先给你看项目规划，等你确认后才改代码。CLI 的安装脚本默认下载最新版，装到 /usr/local/bin 或 ~/.local/bin，只有发布页附带校验文件时才核对 SHA-256。仓库里另有一个 CLI 内部测试用的 Skill 和可选的主机监控代理安装器，本站没有核查推荐。MIT 许可。

以上根据项目公开说明整理，本站没有实际测试。