Orbit
Orbit 项目分析
The Analytics tab is the full picture of how a project is behaving: how long builds take, how often they succeed, how much of your plan's build minutes and bandwidth the project is using, and where…
Analytics 标签页展示了项目行为的全景视图：构建耗时多久、成功频率如何、项目使用了多少计划配额的构建分钟数和带宽，以及构建缓慢时时间花在了哪里。
Analytics 位置
打开 Orbit，点击项目，然后在项目标签栏的 Observability 组下选择 Analytics。该页面标题为 Analytics，涵盖此项目的构建性能、流量和部署频率。
两个相邻的标签页以不同方式对同一数据进行分类。Build Insights 聚焦于构建时长百分位数和缓存行为，Web Vitals 涵盖真实用户性能。请参阅 Orbit Build Insights 和 Orbit Web Vitals。
摘要卡片
顶部有五张卡片：
| 卡片 | 计数内容 |
|---|---|
| 构建分钟数 | 过去六个月此项目的总构建分钟数 |
| 源站请求 | 过去六个月到达源站的请求（仅缓存未命中），共六个月 |
| 源站带宽 | 过去六个月从源站提供的字节数 |
| 成功率 | 过去30天内成功的构建数占完成构建总数的比例 |
| 缓存节省时间 | 过去100次构建中缓存命中节省的构建时间 |
源站请求和源站带宽完全是指源站：从边缘缓存提供的任何内容都不计算在内，这就是为什么一个繁忙的、高度缓存的网站可能显示出惊人的小数字。这是系统正常工作的表现，不是报告差距。
本月使用情况
卡片下方是一个标题为 Usage this month 的面板，显示您的计划名称，并明确这些数字是账户级别的，而不是按项目的。绘制了两个指标：
- 构建分钟数，针对您计划的月度配额使用情况，此项目的配额单独标出，以及您剩余的分钟数。
- 带宽（源站），形式相同，单位为 GB。
如果超过配额，面板会显示超额部分及其成本：构建分钟数按 US$0.05 每分钟计费，源站带宽按 US$0.03 每 GB 计费，均在您计划之外。
它还会根据目前的速率向月底推进，如果您继续当前的使用方式，会显示预计超额。这个推测是有用的数字，因为它告诉您一个问题，同时您仍然可以采取措施。
失控的构建循环是耗尽配额的典型方式。部署钩子连接到自身在部署时触发的任务，会乐意在整个夜间消耗分钟数。如果推测数字急剧跳升，在假设流量增长之前，请检查部署标签页是否存在重复模式。支出上限可以为您提供硬性停止：请参阅 Orbit Spending Cap。
Build Insights
Build Insights 块读取数据并用纯文本为您写出观察结果，而不是让您在图表中自己发现。出现的内容取决于您项目的实际情况，例如：
- 成功率声明，要么是对良好可靠性的肯定，要么是提示您查看最近的失败。
- 与前两周相比构建时间上升或下降，同时列出两个平均值。
- 低缓存命中率，包括使用预热缓存的构建计数以及关于在提交之间保持缓存键稳定的提示。
- 周一构建速度较慢，这通常意味着缓存在周末过期。
- 成功率最低的分支。
- 平均队列等待时间超过 90 秒，意味着构建在等待运行程序。
将这些视为线索而非判决。每一项都指向页面下方具有基础数字的一个部分。
部署频率、可靠性和活动
三个可视化涵盖节奏：
- 部署频率：过去 30 天 显示每天的部署数。
- 可靠性：过去 8 周 按周堆叠成功与失败，与过去四周的趋势相对比。
- 部署活动：过去一年 是日历热力图，按数量着色，并按当天部署是否成功着色。
年度热力图是向询问项目有多活跃的人展示的。空隙和集群一目了然。
构建性能
Build performance 将最后一次成功部署的运行绘制为条形图，显示平均和最快构建时间以及缓存命中率。悬停在条形图上会显示分支和提交，以及该构建是否命中缓存。
Build time trend 将每周缩减为其 P50 并报告本周是否比上周更快或更慢。
Build time percentiles 提供 P50、P90 和 P99。脚注是重要的部分：较低的 P90 意味着更一致的构建。如果您的 P50 很好，但您的 P90 是其三倍，那么大多数构建都很快，只是偶尔会出现问题，这是一个不同的问题，不是均匀缓慢。
缓存效率
Cache efficiency 块直接比较冷构建和缓存构建：每个的平均时长、节省的总时间和产生的速度改进。
如果缓存平均值仅略好于冷平均值，则缓存正在恢复但没有帮助，通常是因为安装步骤不是构建的缓慢部分。如果命中率本身很低，则缓存被无效化得太频繁；每次提交都会改变的锁定文件就会这样做。
Per-environment build stats 按生产、暂存和预览分解构建和缓存命中，这是您发现预览占用大部分构建分钟数的地方。
按分支和作者统计
两个表格涵盖过去 30 天：
- Per-branch build stats：按分支的部署、成功率和平均构建时间。
- Per-author deploy stats：按推送人员的相同数据。
按分支表是实用的。成功率低的分支通常是一个有破坏的测试或类型检查的分支，每个人都学会了忽略它。
队列等待和时间段
Build queue wait: last 14 days 测量构建被排队和构建程序拾取之间的间隔。脚注设定预期：5 秒以下是典型的，峰值表示竞争。
Build time by hour: last 90 days 是以 UTC 计的按周几按小时的热力图，显示您的构建何时最慢，单元格在着色前至少需要两次构建。结合队列等待，它告诉您缓慢的构建是您的构建还是忙碌的时刻。
失败原因
过去 30 天的失败部署按根本原因分类：编译错误、安装失败、测试失败、lint 错误、超时、内存不足、网络错误或未知。该部分指出了最主要的类别及其占您失败的比例。
这是从"我们的构建不断失败"到具体问题需要修复的最快路线。如果三分之二的失败是安装失败，问题在于依赖项解析，而不是您的代码。Troubleshooting Failed Builds 涵盖了对每个类别的处理方法。
工件大小
Artifact size over time 追踪每次构建输出的大小，标记为增长、收缩或稳定，并显示最旧和最新的大小。
稳步增长的工件值得在成为缓慢网站之前进行调查。常见的原因是没有人清理的图像目录和引入了巨大内容的依赖项。
Web 分析
底部部分显示过去 30 天来自真实访客的核心 Web 指标，包括热门页面、国家/地区、引荐来源和按页面 p75 性能。
如果您还没有添加收集代码片段，此部分为空并提供设置链接。请参阅 Orbit Web Vitals 了解代码片段和每个指标的含义。
后续步骤
- Orbit Build Insights 了解百分位数和缓存详情。
- Orbit Spending Cap 为超额设置上限。
- Orbit Plan Limits 了解您的计划包含的内容。