tracewayapp/traceway

这是什么？

核心功能

• 01通过原生 OTLP/HTTP 接收任意 OpenTelemetry SDK 发送的日志、链路和指标。
• 02按 SHA-256 指纹对异常分组，并支持 webpack、esbuild、Vite 的 source map 还原。
• 03按接口统计 P50/P95/P99 延迟、吞吐量和错误率。
• 04为 Web 应用和 Flutter 提供会话回放。
• 05通过 gen_ai 属性追踪 LLM 的成本、Token 与会话。
• 06支持值班轮换、升级策略，并可通过邮件、Slack、Pushover、Telegram 或短信发送告警。
• 07提供 SLO 目标、错误预算和燃烧率告警。

适用场景

• 结合会话回放和还原后的堆栈，排查 Web 或移动应用的线上异常。
• 无需单独部署 Collector，汇总微服务的日志、链路和指标。
• 监控基于大模型的功能，关注成本、延迟和对话内容。
• 用单个容器搭建 SQLite 版本的自托管可观测性系统。

快速上手

1. 1

   克隆仓库

   git clone https://github.com/tracewayapp/traceway
2. 2

   进入目录并用 Docker Compose 启动

   cd traceway && docker compose up -d

使用前须知

• !完整自托管需要运行 Docker 及外部数据库，除非选用 SQLite 或 DuckDB 镜像。
• !README 中性能分析功能标注为实验性。

收录于专题

标签

常见问题

traceway 是什么？

基于 OpenTelemetry 的开源可观测性平台，整合日志、链路追踪、指标、异常、会话回放和值班告警，可用 Docker 自托管。 Traceway 是一个原生基于 OpenTelemetry 构建的可观测性平台，把日志、链路追踪、指标、异常、Web 与 Flutter 的会话回放、LLM 调用追踪以及值班寻呼整合在同一套系统里。后端应用可以通过 OTLP/HTTP 直接把数据发送给 Traceway，无需额外部署 Collector，也不依赖特定厂商的 SDK。

traceway 可以免费使用吗？用的什么许可证？

traceway 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

traceway 还在维护吗？

活跃维护中。traceway 最近一次提交是在 2026年11月6日。

traceway 适合用来做什么？

结合会话回放和还原后的堆栈，排查 Web 或移动应用的线上异常。 无需单独部署 Collector，汇总微服务的日志、链路和指标。 监控基于大模型的功能，关注成本、延迟和对话内容。 用单个容器搭建 SQLite 版本的自托管可观测性系统。

traceway 怎么安装和运行？

克隆仓库: git clone https://github.com/tracewayapp/traceway 进入目录并用 Docker Compose 启动: cd traceway && docker compose up -d

在哪里获取 traceway？

源代码和安装说明在 GitHub 上：https://github.com/tracewayapp/traceway