版本与灰度发布
把每次发版登记为一个版本,Argus 按崩溃率、ANR 率、启动时长、FPS 聚合出 0–100 的版本健康分, 并支持灰度放量(按百分比 / 用户 / 区域 / 设备)与回滚,让你在问题扩散前就发现劣化版本。
核心概念
| 概念 | 说明 |
|---|---|
| 版本(Release) | 一次发版记录,以版本号(如 2.3.0)标识,可附发版说明 |
| 健康分(Health Score) | 按崩溃率 / ANR 率 / 启动时长 / FPS 聚合出的 0–100 分,越高越健康 |
| 状态 | staging(预发)→ rolling_out(灰度中)→ released(已发布),或 rolled_back(已回滚) |
| 灰度比例(Rollout %) | 灰度中版本对外放量的百分比 |
| 自动回滚规则 | 项目级配置:崩溃率超阈值时触发回滚 |
核心信号从哪来
健康分是崩溃与性能数据的聚合,因此版本管理依赖你已接入这些能力:
只要端上 SDK 上报时带上 appVersion(各平台初始化参数,见 快速开始),数据即按版本
归集。
Console 使用
打开 Console → Releases(/releases):
- 登记版本:填版本号(如
2.3.0)与发版说明,点「登记版本」。 - 查看健康分:列表每行显示版本、状态、健康分、灰度比例。点某行「健康度」展开该版本的崩溃率 / ANR / 启动 / FPS 明细。
- 灰度放量:对
staging/rolling_out版本设置放量比例,逐步扩大受影响用户面。 - 回滚 / 发布:
staging→ 「标记发布」置为released;rolling_out/released→ 「回滚」置为rolled_back;rolled_back→ 「重置预发」回到staging重新开始。
- 自动回滚规则:在「自动回滚规则」面板配置崩溃率阈值,作为灰度门禁的输入。
灰度放量与回滚为手动操作始终可用;自动回滚以规则配置形式提供,用于把崩溃率超阈值作为 门禁信号。请以你所在部署的实际行为为准验证自动执行。
MCP 工具
在 Claude / Cursor 里可用只读工具查询版本健康度(详见 MCP Server):
| 工具 | 用途 |
|---|---|
release.health | 查询某版本的健康分与崩溃 / 性能聚合明细 |
配额与计费
版本管理本身不额外计量;其健康分来自崩溃与 APM 事件,计量归入对应能力。见 套餐、配额与计费。
常见问题
Q:健康分为什么是空的 / 偏低样本? 版本需要足够的崩溃与性能样本才能算出稳定健康分。刚登记、放量比例很小的版本样本不足,分数仅供参考。
Q:回滚会影响已经上报的数据吗? 不会。回滚只改变版本状态与放量策略,历史事件数据保持不变。
Q:性能回归会自动触发告警吗? 版本的崩溃率 / 性能劣化可作为 告警与通知 的输入信号,需在告警规则中配置。