Traceway 学习指南
一、用途 Traceway 是一个可观测性平台。应用向其发送遥测数据：后端通过 OpenTelemetry（OTLP/HTTP）发送，浏览器和移动应用通过 Traceway SDK 发送。Traceway 将这些数据转化为问题（issues）、请求与任务分析、追踪、日志、指标与仪表盘、会话回放、AI 成本追踪和性能剖析。在此之上，它还运行在线状态监控、公开状态页、告警和值班呼叫。本指南用于解释产品各个部分：每个页面展示什么、使用什么术语、团队应如何使用它，以及智能体如何通过 traceway CLI 或 MCP 服务器读取或修改它。
二、如何使用本指南
- 从下列主题文件中回答“X 如何工作”“我在哪里找到 X”“X 是什么意思”这类问题。只读取问题所需的一到两个文件。
- 引用仪表盘使用的确切名称（标签名、按钮名、规则类型），以便用户能够找到它们。
- 当用户需要实时数据时，切换到 traceway 技能（或 MCP 工具）：其中包含调试与性能操作手册。
- 当用户需要修改内容时，traceway-write 技能涵盖智能体被允许进行的更改。其余更改都在仪表盘中完成，主题文件会说明这一点。
- 当用户需要为应用接入埋点时，使用 traceway-setup 技能。
三、核心概念
- 组织（Organization）拥有人员、项目、仪表盘、值班和状态页。项目（Project）是一个应用，几乎所有页面都以其为作用域。一个追踪可以跨越一个组织的多个项目。
- 角色：owner、admin、user、readonly，并可为 user 和 readonly 成员设置按项目的覆盖权限。
- 时间窗口：每个遥测页面都受保存在 URL 中的范围限制（?preset=24h，或 ?from=&to=）。预设值包括：5m、30m、60m、3h、6h、12h、24h、3d、7d、1M、3M。CLI 和 MCP 读取接受 --since 或 --from/--to。
- Span 是基本单位。端点、任务、AI 追踪和问题都是在采集时提升出来的 span。一个 trace id 将一次请求与其下游调用、日志和异常关联起来。
- 告警（alert）、呼叫（page）、事故（incident）是不同的东西。告警是发送通知的规则。呼叫是值班升级，持续进行直到有人确认。事故是某个监控不可用的一段时间（或手动记录的一段时间），可在状态页上提供可选的公开说明。
四、主题 | 主题 | 文件 | MCP 资源 | 涵盖内容 | | Issues | issues.md | traceway://knowledge/learn/issues | 异常、指纹识别、issue 与 occurrence 页面、归档、回归 | | 端点与任务 | endpoints-and-tasks.md | traceway://knowledge/learn/endpoints-and-tasks | P50、P95、P99、影响分、Apdex、预期性能标记、请求、后台任务 | | Span、追踪与日志 | traces-and-logs.md | traceway://knowledge/learn/traces-and-logs | span 浏览器、整条追踪瀑布图、分布式追踪、日志搜索、实时尾部 | | 指标与仪表盘 | metrics-and-dashboards.md | traceway://knowledge/learn/metrics-and-dashboards | 指标名称与标签、聚合与 rate、仪表盘、组件、模板、收藏 | | 会话、AI 追踪、剖析 | sessions-and-ai.md | traceway://knowledge/learn/sessions-and-ai | 会话回放、LLM 调用、对话、被标记内容、火焰图 | | 监控与状态页 | monitors.md | traceway://knowledge/learn/monitors | HTTP、TCP 和浏览器检查、运行、事故、公开状态页、事后复盘 | | 告警 | alerts.md | traceway://knowledge/learn/alerts | 每种规则类型及其设置、渠道、冷却、静默、历史 | | 值班 | on-call.md | traceway://knowledge/learn/on-call | 团队、排班、层级、覆盖、升级策略、呼叫、联系方式 | | 组织与访问 | organization.md | traceway://knowledge/learn/organization | 项目、角色、主页、组织视图、Connection、Account、Settings、智能体访问 |
五、页面映射 | 页面 | 路径 | 主题 | | 仪表盘（主页） | / | organization.md | | Issues | /issues, /issues/<hash> | issues.md | | 日志 | /logs | traces-and-logs.md | | 端点 | /endpoints, /endpoints/<endpoint> | endpoints-and-tasks.md | | 任务 | /tasks | endpoints-and-tasks.md | | Span | /spans, /spans/<traceId> | traces-and-logs.md | | 剖析 | /profiles | sessions-and-ai.md | | 会话 | /sessions（浏览器和移动项目） | sessions-and-ai.md | | AI 追踪 | /ai-traces | sessions-and-ai.md | | 仪表盘 | /dashboards | metrics-and-dashboards.md | | 监控 | /monitors（Monitors、Status Pages、Post-Mortems 标签） | monitors.md | | 公开状态页 | /status/<slug> | monitors.md | | 告警 | /notifications（Channels、Rules、History 标签） | alerts.md | | 值班 | /on-call（Pages、Overview、Teams、Schedules、Policies 标签） | on-call.md | | Connection | /connection | organization.md | | Account | /account | organization.md, on-call.md | | Settings | /settings（owner 和 admin） | organization.md | | 组织 | /organization（Servers、Issues、Monitors、On-Call、Projects） | organization.md | | 项目设置 | /setup | organization.md |
浏览器和移动项目只显示 Issues、Sessions、Alerts、On-Call 和 Connection。
六、常见问题 | 问题 | 回答位置 | | 为什么两个错误归入同一个 issue，或一个错误被拆成两个？ | issues.md, Fingerprinting | | 影响分是什么意思，为什么这个端点是 Critical？ | endpoints-and-tasks.md | | 当我确认一个呼叫时会发生什么？下一个被呼叫的是谁？ | on-call.md, Pages and Escalation policies | | 现在谁在值班，我如何换班？ | on-call.md, Schedules and Overrides | | 对一个嘈杂的告警是静默还是禁用？ | alerts.md, Disable versus snooze | | 为什么我的监控一次失败就 down，或者多次失败仍不 down？ | monitors.md, States and runs | | 我如何向客户公布可用性？ | monitors.md, Status pages | | 我在哪里撰写事故复盘？ | monitors.md, Post-mortems | | 为什么瀑布图中缺少一个 span？ | traces-and-logs.md | | 为什么我的计数器指标只增不减？ | metrics-and-dashboards.md, Aggregations | | 智能体能否修改 Traceway 中的内容？ | organization.md, How agents get access |
七、限制 本资料为使用指南文档，未提供收费、价格、具体部署平台等信息。