能力可见性
能力可见性(Feature Visibility)控制 Argus 各产品能力对组织的对外可见性——它决定”哪些组织能看到 某个新能力入口”,区别于控制业务代码行为的 Feature Flags。
可见性 vs Feature Flag:能力可见性管的是”Argus 平台能力对客户组织可不可见”(平台侧灰度放量); Feature Flag 管的是”你的应用里某段代码走不走新分支”(业务侧开关)。两者机制相似但用途不同。
核心概念
每个能力以 vis_* 前缀的键(capability_key)标识,其可见性由**三个维度组合(OR 关系,命中任一即
可见)**决定:
| 维度 | 说明 |
|---|---|
| 组织白名单 | 列出的 org_id 直接可见 |
| 套餐过滤 | 命中指定套餐档位的组织可见 |
| 哈希放量百分比 | 按组织哈希放量,逐步扩大可见面 |
外加**阶段(stage)**标记能力的成熟度,以及 Kill Switch——紧急一键对所有组织隐藏某能力。
Console 使用
打开 Console → Settings → Capabilities(/settings/capabilities):
- 表格列出每个能力:
capability_key、阶段、受众(三维度组合)、对本组织是否可见。 - 以套餐视角预览:切换套餐档位,预览该视角下本组织的可见性求值结果。
- 配置受众:为某能力设置组织白名单、套餐过滤、放量百分比。
- Kill Switch:紧急关闭某能力对所有组织的可见性(立即生效)。
打开某能力的 Kill Switch 会对所有组织立即隐藏该能力。用于线上事故的紧急止血,操作前请确认 影响面。
常见问题
Q:能力可见性和套餐额度有关系吗? 可见性的”套餐过滤”维度可以让某能力只对特定档位可见,但它控制的是”看不看得到入口”,不是”用量额度”。 额度见 套餐、配额与计费。
Q:为什么我看不到某个新能力? 可能该能力还在灰度阶段、你的组织不在白名单 / 放量范围、或该能力被 Kill Switch 关闭。
Q:这和运营后台(console-admin)是一回事吗? 运营侧在 console-admin 做全域可见性管理;本页是你在自己组织视角下的可见性查看与配置入口。