产品需求文档 · 待评审
接口请求量异常告警配置
二、需求目的及范围
在后台调整接口告警阈值、重复告警间隔及启停状态，查看告警和修改记录。
适用中国站、越南站，各站独立配置。站点由后台环境识别，不提供站点筛选。
入口：风控管理 → 风控配置 → 接口请求量告警。
页面包含阈值配置、告警记录、操作日志。不提供新增、删除及模拟检测。
三、数据来源
1请求次数：沿用现有运维监控数据，不使用客户端上报数据，前端不自行计算。具体来自网关日志、服务日志还是其他计数，由运维与后端核实；正式上线前确认是否存在漏计、重复计数。
2接口目录：由后端维护，包含接口名称、地址及方法。当前原型的 11 个接口按产品提供的清单录入，研发需核对。
3阈值、间隔、状态：由后台服务保存，监控服务读取。运营按权限修改。原型中的 15、100、5 等数值仅供演示，正式初始值由后端和运维结合流量评估。
4告警记录：由监控服务提供，保存触发时的数据；操作日志由后台服务记录。
5时间：以服务端时间为准，后台与消息使用同一业务时区，不受用户设备时间影响。具体时区待后端、运维确认。原型使用演示时间。
四、查询规则
| 筛选项 | 使用规则 |
|---|
| 接口 | 单选，默认全部。下拉内可输入接口地址或说明搜索；选项第一行显示说明，第二行显示方法及地址。输入只筛选候选项，选中后再点击查询。 |
| 状态 | 阈值配置为全部、已启用、已停用；告警记录不设状态筛选；操作日志为全部、编辑规则、启用规则、停用规则。 |
| 日期 | 阈值配置显示修改开始／结束日期；告警记录显示告警开始／结束日期；操作日志显示操作开始／结束日期。 |
日期仅用于查询，含开始和结束当天，不影响告警生效。可只填一端；均不填表示不限。开始晚于结束时提示，不执行查询。
点击查询按所选条件共同筛选；重置恢复全部。切换页签保留接口，清空状态和日期。阈值配置按最近修改时间倒序；告警记录按触发时间倒序；操作日志按操作时间倒序，即时间由近到远。时间相同时按记录编号由大到小排序。修改或启停规则后，该规则按新的修改时间重新排序。无结果显示暂无记录。
五、阈值配置
列表显示接口、检测口径、阈值、重复告警间隔、状态、最近修改时间和修改人。操作为编辑、启用／停用、告警记录。
检测口径列仅显示“每 1 分钟检测”。点击告警记录，进入该接口的历史记录。
编辑时接口只读，可修改：
4告警阈值：必填，1—100000000 的整数，单位次／分钟，达到或超过该值告警。
5重复告警间隔：必填，1—1440 的整数，单位分钟，允许运营按接口修改。
不符合要求时在输入框附近提示，不允许保存。取消、关闭弹窗不保存。
保存成功后更新列表并记录修改前后内容；没有修改不写日志。保存失败保留输入，提示“保存失败，请重试”。保存期间禁止重复提交；多人同时修改时，后提交者需刷新后再修改，避免覆盖。
列表启停须二次确认，失败时保持原状态。启用及配置修改从下一次检测生效；停用后不再生成新告警，历史记录保留。无需保持后台页面打开。
六、告警规则
1每分钟检测一次，查看前 3 个完整分钟中，哪一分钟请求最多。取该次数与阈值比较，不将三分钟相加。
例：14:17 检测 14:14、14:15、14:16 三分钟，请求分别为 12、15、9 次，实际请求次数为 15。阈值为 15 时触发，阈值为 16 时不触发。
3按站点、接口地址、请求方法分别统计。统计监控实际采集到的请求，不因业务成功或失败排除。路径参数按接口模板合并，不能按各个手机号拆开统计。
4告警模板中的结束时间 14:16:00 表示最后一个统计分钟，包含该分钟至 14:16:59 的请求。
5同一接口首次达到阈值时告警。发送成功后开始计算重复告警间隔，间隔内不重复告警；间隔结束后仍达到阈值才再次告警。不同接口独立计时，监控持续运行。
6修改或重新启用保留上次成功发送的时间。按当前配置间隔判断是否允许再发，避免重新启用立即重复告警。恢复正常不发送恢复通知。
7停用前已生成的消息按现有告警服务流程处理。消息发送、重试和去重由现有服务处理，本期后台不展示发送状态、失败原因和通知渠道，也不提供手动重发。
8监控数据缺失时跳过判断，由运维排查；不能当作零请求。确实没有请求且采集正常时按 0 处理。读取新配置失败时沿用最近一次有效配置；没有有效配置时不执行该规则并记录异常。
七、告警记录及详情
列表显示触发时间、接口、统计范围、实际请求次数、触发阈值及查看告警。
历史告警保存触发时的名称、地址、方法、站点、阈值及统计结果，后续修改不影响历史。通知发送到现有对应站点的接口告警群，具体群由运维确认。
详情按以下模板展示，并补充各分钟请求次数：
【接口请求量异常告警】
站点：中国站
接口名称：登出
接口地址：/api/user/auth/logout
请求方法：POST
触发时间：2026-10-26 14:17:00
统计范围：2026-10-26 14:14:00 至 2026-10-26 14:16:00(取其中单分钟最高)
统计窗口：每 1 分钟
实际请求次数：15 次
告警条件：单分钟请求次数 ≥ 15 次
触发时间为生成告警的时间，不是消息发送完成时间。
八、权限与记录
查看配置、编辑配置、启停、查看告警、查看操作日志分别授权，后台服务同时校验权限。
操作日志记录操作人、操作时间、接口、动作、修改前后的阈值／间隔／状态。只读，不提供删除。
列表加载失败显示“加载失败，请重试”，不显示为暂无数据。正式分页及数据保留期限沿用后台现有规范；如无规范，由业务与研发评审确认。
九、验收重点
2状态、日期组合筛选正确；日期含起止当天，不能控制告警生效。
3等于阈值触发，低于不触发；三分钟取最高，不求和。
4修改下一轮生效，历史不变；启停和取消操作正确，日志可追溯。
5间隔内不重复发送，结束后仍异常可再发；不同接口互不影响。
6三个列表均按对应时间由近到远排序；时间相同时按记录编号倒序，编辑或启停后顺序正确。
7保存失败、监控缺数、权限不足、多人修改均不会误改配置。
8测试需验证真实监控数据 → 后台配置 → 告警记录 → 群消息全流程。原型仅验证页面交互，不能代替接入验收。
十、上线前确认
由后端、运维确认实际采集来源及统计完整性、业务时区、初始阈值、默认间隔、接收群、重试策略和配置读取方式。产品与测试按确认后的口径验收。