返回交互原型Lark域名告警配置
端:PC管理后台 版本:v1.2 修订日期:2026-09-22 状态:评审稿
一、需求背景
FB、DB三方服务异常时,同一域名或同一出口IP可能在短时间内产生大量重复失败告警,影响运营查看其他有效信息。需要增加告警白名单及冷却时间配置,减少Lark群内的重复消息。
二、需求目标
- 支持配置域名告警冷却时间和IP告警冷却时间。
- 支持维护不发送Lark告警的域名白名单。
- 告警过滤不影响原有健康检测、失败统计、动态切换和自动禁用。
- 后台配置修改可追溯。
三、需求范围
| 平台 | 中站、越站(是否共用同一套配置,评审确认) |
|---|
| 业务 | FB、DB动态域名异常告警;系统可以识别域名所属业务,两类业务分别配置、分别感知 |
|---|
| 涉及端 | PC管理后台、动态域名异常告警服务 |
|---|
| 菜单 | 运营管理 → 资源配置管理 → 动态域名配置下方新增“Lark域名告警配置” |
|---|
| 权限 | 优先复用动态域名配置菜单的查看、编辑权限;最终以权限评审结果为准 |
|---|
四、功能需求
4.1 告警规则
| 配置项 | 规则 |
|---|
| FB域名告警冷却时间 | 必填,单位分钟,仅允许1~1440的正整数,默认3分钟 |
| FB IP告警冷却时间 | 必填,单位分钟,仅允许1~1440的正整数,默认3分钟 |
| DB域名告警冷却时间 | 必填,单位分钟,仅允许1~1440的正整数,默认3分钟 |
| DB IP告警冷却时间 | 必填,单位分钟,仅允许1~1440的正整数,默认3分钟 |
| 保存 | 四项参数独立保存、独立生效;修改FB配置不影响DB,反之亦然。保存成功后关闭弹窗并提示“保存成功” |
4.2 告警白名单
| 字段/操作 | 规则 |
|---|
| 域名 | 必填,仅支持单个完整域名;不支持协议、路径、端口和通配符;不区分大小写;同一域名不可重复添加;创建后不可修改 |
| 业务类型 | 系统根据域名归属自动识别FB或DB,只读且不可修改;无法识别时不允许保存 |
| 状态 | 启用/停用,新增时默认启用 |
| 备注 | 非必填,最多100字 |
| 列表字段 | 业务类型、域名、状态、备注、创建人、创建时间、更新时间、操作 |
| 查询 | 支持按域名模糊查询、按业务类型和状态筛选;支持查询、重置和分页,默认10条/页 |
| 编辑 | 仅允许修改状态和备注 |
| 启停 | 操作成功后列表立即更新,并提示“启用成功”或“停用成功” |
| 删除 | 删除前二次确认,弹窗展示具体域名;删除后提示“删除成功” |
4.3 操作记录
如现有后台已有统一操作日志,直接复用;否则本页面提供操作记录,记录操作时间、操作人、操作类型、操作对象及变更内容。
五、业务规则
- 检测到动态域名异常后,系统先识别域名所属业务,再依次判断:该业务启用中的告警白名单 → 该业务域名冷却 → 该业务IP冷却。
- 白名单判断维度为“业务类型+域名”;域名冷却判断维度为“业务类型+域名”;IP冷却判断维度为“业务类型+客户端真实出口IP”。
- FB与DB分别计算冷却时间,FB产生的域名或IP冷却不得过滤DB告警,DB同理。
- 同一业务内,IP冷却不区分用户和域名;IP实际取值字段由后端和运维评审确认。
- 命中任一过滤条件时不发送Lark,但异常仍参与健康检测、失败统计、动态切换和自动禁用。
- Lark接口返回发送成功后,更新对应业务下该域名和IP的最近告警时间;被过滤或发送失败的事件不刷新冷却时间。
- 冷却结束后再次发生异常,且未命中其他过滤条件时,允许重新发送并重新计算冷却时间。
- 同一时刻发生并发异常时,同一业务下的同一域名或同一IP在冷却规则内只能产生一条Lark告警,具体实现方式由技术确定。
- 告警消息沿用现有动态域名Lark告警模板、告警群及机器人配置,不新建模板。
六、异常与校验
| 场景 | 处理 |
|---|
| 冷却时间为空、非整数、小于1或大于1440 | 不允许保存,字段下提示“请输入1~1440之间的正整数” |
| 域名为空或格式错误 | 不允许保存,字段下提示“请输入正确的域名” |
| 域名重复 | 不允许保存,字段下提示“该域名已存在” |
| 无法识别域名所属业务 | 不允许保存,提示“未查询到该域名所属业务,请确认域名是否已配置” |
| 查询无数据 | 表格区域展示“暂无数据” |
| 接口失败 | 保留当前页面内容并提示“操作失败,请稍后重试” |
七、验收标准
- FB、DB各自的域名冷却和IP冷却均可独立编辑,修改一方不影响另一方。
- 白名单支持自动展示业务类型,并支持按FB、DB筛选。
- 同一IP连续访问两个FB域名失败,FB仅发送第一次;同一IP先访问FB失败、再访问DB失败,FB和DB各允许发送一次。
- 同一FB或DB域名更换用户或IP后再次失败,命中对应业务的域名冷却。
- 启用白名单的域名不发送Lark,停用或删除后恢复按所属业务的冷却规则判断。
- Lark发送成功才刷新对应业务的域名和IP冷却时间,被过滤或发送失败的事件不刷新。
- 并发异常场景下,同一业务、同一维度只发送一条告警。
- 所有被过滤事件仍执行原有检测、统计、切换和自动禁用逻辑。
- 有编辑权限的账号可操作,无编辑权限的账号只读;所有配置变更可追溯。
八、评审确认项
| 确认项 | 确认方 |
|---|
| 中站、越站是否共用同一套FB/DB配置 | 运营、后端 |
| 客户端真实出口IP的取值字段及CDN/代理场景处理 | 后端、运维 |
| Lark发送失败后的现网重试机制 | 后端 |
| 保存后的最大生效延迟、多实例并发去重方式 | 后端 |
| 是否已有统一后台操作日志 | 后端 |
| 测试环境是否能够构造FB/DB同IP、同域名、跨域名及并发异常 | 测试、后端 |