Title: 管理功能开关
Locale: zh
URL: https://sensorswave.com/docs/feature-gates/management-and-monitoring/
Description: 学习如何有效管理功能开关
本文介绍如何有效地管理功能开关，包括查看开关列表、状态管理、报告数据、历史记录等内容。

## 功能开关列表

### 访问列表

1. 登录 Sensors Wave 控制台
2. 点击左侧菜单的 **功能开关**
3. 查看所有功能开关列表

### 列表信息

列表展示以下信息：

| 列 | 说明 |
|---|-----|
| **开关名称** | 代码中使用的标识符 |
| **显示名称** | 友好的显示名称 |
| **状态** | 草稿、调试、运行中、已发布、结束 |
| **覆盖用户** | 当前命中规则的用户数 |
| **最后更新** | 最后修改时间 |
| **创建者** | 创建功能开关的用户 |

### 筛选和搜索

#### 按状态筛选

- **全部**：显示所有开关
- **草稿**：仅显示未发布的开关
- **调试**：仅显示调试中的开关
- **运行中**：仅显示正在运行的开关
- **已发布**：仅显示已完成发布的开关
- **结束**：仅显示已结束的开关

#### 搜索

支持按开关名称或显示名称搜索。

### 排序

支持按以下字段排序：

- **创建时间**（默认）
- **更新时间**
- **开关名称**
- **覆盖用户数**

## 功能开关详情

### 访问详情页

点击列表中的功能开关，进入详情页。

### 详情页标签

#### 概览

显示功能开关的基本信息和当前配置：

- 开关标识
- 描述和创建信息
- 默认值
- 规则列表
- 当前状态

#### 数据

显示功能开关的报告数据，包括累计流量统计和时间趋势。详见下方 [报告数据](#报告数据) 章节。

#### 历史记录

显示功能开关的所有配置变更历史。详见下方 [历史记录](#历史记录) 章节。

#### 设置

管理功能开关的高级设置。

## 状态管理

### 状态说明

功能开关共有 5 种状态：

| 状态 | 说明 |
|------|------|
| **草稿** | 开关已创建但未发布，不会对用户生效 |
| **调试** | 开关处于调试模式，用于内部测试验证 |
| **运行中** | 开关已发布并正在生效 |
| **已发布** | 开关已完成发布流程，功能稳定运行 |
| **结束** | 开关生命周期已结束，功能已全量或已下线 |

### 状态流转图

```
草稿 → 调试 → 运行中 → 已发布 → 结束
```

### 启动调试

将草稿状态的开关切换为调试模式：

1. 进入功能开关详情页
2. 检查配置是否正确
3. 点击 **调试** 按钮
4. 功能开关进入调试状态，可进行内部测试验证

### 开始运行

将调试状态的开关切换为运行中：

1. 进入功能开关详情页
2. 确认调试结果符合预期
3. 点击 **运行** 按钮
4. 功能开关开始正式对用户生效

### 发布开关

将运行中的开关标记为已发布：

1. 进入功能开关详情页
2. 确认功能稳定运行
3. 点击 **发布** 按钮
4. 功能开关标记为已发布状态

### 结束开关

将已发布的开关标记为结束：

1. 进入功能开关详情页
2. 确认功能已全量上线或已下线
3. 点击 **结束** 按钮
4. 功能开关生命周期结束

**何时结束**：
- 功能已全量发布，不再需要灰度控制
- 功能已从代码中移除
- 确认不再需要该开关

### 删除开关

永久删除功能开关：

1. 进入功能开关详情页
2. 进入 **设置** 标签
3. 点击 **删除功能开关**
4. 输入开关名称确认
5. 功能开关被永久删除

> **警告**：删除操作不可恢复，请谨慎操作。建议先将开关状态流转到结束，确认不再需要后再删除。

## 报告数据

功能开关提供详细的报告数据功能，帮助您了解功能开关的实际使用情况和流量分布。

### 访问报告数据

1. 进入功能开关详情页
2. 点击 **数据** 标签页
3. 查看报告数据

### 基础信息

报告页面顶部显示功能开关的基础信息：

| 字段 | 说明 |
|------|------|
| **运行周期** | 功能开关开始运行的时间范围，例如：2026-01-22 - 至今 |
| **规则数量** | 当前配置的规则数量 |

### 累计流量统计

累计流量表格展示各变体的流量分布情况：

| 字段 | 说明 |
|------|------|
| **变体** | 分流结果（Pass 或 Fail） |
| **累计流量数** | 该变体累计的曝光次数 |
| **累计流量比例** | 该变体在总流量中的占比 |

**示例数据**：

| 变体 | 累计流量数 | 累计流量比例 |
|------|-----------|-------------|
| Pass | 2,043 | 50.99% |
| Fail | 1,964 | 49.01% |
| **Total** | **4,007** | **100.00%** |

### 累计流量时间趋势

页面提供累计流量时间趋势图表，帮助您：

- **观察流量变化**：查看功能开关的流量随时间的变化趋势
- **验证分流比例**：确认实际分流比例是否符合预期配置
- **识别异常**：发现流量突增或突降等异常情况

### 报告数据用途

- **验证配置**：确认分流比例是否按预期生效
- **监控使用**：了解功能开关的实际覆盖范围
- **问题排查**：通过流量趋势发现潜在问题
- **决策支持**：基于数据决定是否扩大灰度比例

## 历史记录

### 查看历史

进入功能开关详情页的 **历史记录** 标签，查看所有配置变更。

### 记录内容

每条记录包含：

| 字段 | 说明 |
|-----|------|
| **变更 #** | 变更序号 |
| **操作类型** | 创建、更新、调试等 |
| **更新时间** | 操作发生的时间 |
| **更新人** | 执行操作的用户 |

## 最佳实践

### 定期审查

**建议频率**：每月一次

**审查内容**：
- [ ] 检查是否有长期处于草稿或调试状态的开关
- [ ] 检查覆盖用户数是否异常
- [ ] 检查是否有长期未使用的开关
- [ ] 及时将已全量发布的功能开关流转到结束状态
- [ ] 更新开关描述和文档

### 命名规范

统一的命名规范便于管理：

- 使用模块前缀：`recommendation_`, `payment_`, `user_`
- 使用描述性名称：`new_algorithm`, `wechat_pay_enabled`
- 避免简写和缩写：`recommendation` 而非 `recom`

详见 [最佳实践 - 命名规范](best-practices.mdx#命名规范)。

### 文档记录

为每个功能开关维护清晰的文档：

- **描述字段**：详细说明功能开关的用途
- **代码注释**：在代码中说明功能开关的作用

## 下一步

现在您已经了解了如何管理功能开关，接下来可以：

1. **[最佳实践](best-practices.mdx)**：掌握功能开关的最佳使用方法
2. **[常见问题](faq.mdx)**：查看常见问题的解答

---

**最后更新时间**：2026 年 1 月 28 日