traceway-learn

了解 Traceway

Traceway 是一个可观测性平台。应用会发送遥测数据：后端通过 OTLP/HTTP 发送 OpenTelemetry 数据，浏览器和移动应用则使用 Traceway SDK。Traceway 会将这些数据转化为问题、请求和任务分析、追踪、日志、指标和仪表板、会话回放、AI 成本跟踪以及性能剖析数据。此外，它还提供正常运行时间监控器、公开状态页面、告警和随叫随到通知。

本指南介绍产品的每个部分：各个页面显示什么、使用哪些术语、团队应如何使用，以及 Agent 如何通过 traceway CLI 或 MCP 服务读取或修改相关内容。

如何使用本指南

• 对于“X 如何运作”“在哪里能找到 X”以及“X 是什么意思”这类问题，请从下面的主题文件中查找答案。只需阅读问题所需的一到两个文件。
• 引用仪表板使用的准确名称（标签页名称、按钮、规则类型），方便用户查找。
• 用户需要实时数据时，请切换到 traceway skill（或使用 MCP 工具）：其中包含调试和性能分析手册。
• 用户需要修改内容时，traceway-write skill 会介绍 Agent 获准执行的修改。其他操作都在仪表板中完成，主题文件中也会说明这一点。
• 用户需要为应用添加监控时，请使用 traceway-setup skill。

核心概念

• 组织管理人员、项目、仪表板、随叫随到安排和状态页面。项目对应一个应用，几乎所有页面都限定在项目范围内。同一组织中的多个项目可以通过一条追踪串联起来。
• 角色：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 可将请求与其下游调用、日志和异常关联起来。
• 告警、通知和事件是不同的概念。告警是用于发送通知的规则。通知是持续进行的随叫随到升级流程，直到有人确认才会停止。事件是监控器不可用的一段时间（也可以手动记录），并且可以选择在状态页面上发布相关说明。

主题

主题	文件	MCP 资源	涵盖内容
问题	issues.md	traceway://knowledge/learn/issues	异常、指纹、问题和发生记录页面、归档、回归
端点和任务	endpoints-and-tasks.md	traceway://knowledge/learn/endpoints-and-tasks	P50、P95、P99、影响评分、Apdex、预期性能标记、请求、后台任务
Span、Trace 和日志	traces-and-logs.md	traceway://knowledge/learn/traces-and-logs	Span 浏览器、完整 Trace 瀑布图、分布式 Trace、日志搜索、实时流
指标和仪表板	metrics-and-dashboards.md	traceway://knowledge/learn/metrics-and-dashboards	指标名称和标签、聚合和速率、仪表板、小组件、模板、收藏
会话、AI Trace、性能分析	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、Agent 访问权限

页面索引

页面	路径	主题
仪表板（主页）	/	organization.md
问题	/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 Trace	/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（所有者和管理员）	organization.md
组织	/organization（Servers、Issues、Monitors、On-Call、Projects）	organization.md
项目设置	/setup	organization.md

浏览器和移动项目仅显示 Issues、Sessions、Alerts、On-Call 和 Connection。

常见问题

问题	答案见
为什么两个错误归入同一个问题，或者一个错误被拆成两个？	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
为什么监控器失败一次后就显示停机，或失败多次后仍未显示停机？	monitors.md，States and runs
如何向客户发布运行时间状态？	monitors.md，Status pages
应该在哪里记录事件？	monitors.md，Post-mortems
为什么瀑布图中缺少一个 span？	traces-and-logs.md
为什么我的计数器指标只增不减？	metrics-and-dashboards.md，Aggregations
Agent 能在 Traceway 中更改内容吗？	organization.md，How agents get access