订阅方式
不同类型的状态页支持不同的订阅方式:用户自助订阅
邮件订阅(公开状态页)
访客在公开状态页上输入邮件地址后,系统会发送一封确认邮件。确认邮件的有效期为 5 分钟,过期后需重新发起订阅。1
输入邮件地址
访客在状态页底部的订阅区域填写邮件地址。
2
选择订阅范围
选择订阅所有更新,或仅订阅特定组件或事件的更新。
3
确认订阅
访客在收到的确认邮件中点击确认链接,完成订阅。
如果访客在确认前修改了订阅范围,系统会更新待确认的订阅内容,不会重新发送确认邮件。
IM 订阅(内部状态页)
组织内部用户访问内部状态页后,可通过已绑定的 IM 集成(飞书、钉钉、企业微信、Slack)接收事件推送通知。IM 订阅无需邮件确认。RSS/Atom 订阅(公开状态页)
公开状态页会自动提供 RSS 和 Atom 两种格式的事件 Feed,方便访客通过 RSS 阅读器(如 Feedly、Inoreader)或自动化工具订阅状态更新。Feed 为匿名访问,无需注册或邮件确认。 每个公开状态页提供以下四个 URL,内容完全一致,feed.* 与 history.* 互为别名(后者用于兼容 Atlassian Statuspage 的链接习惯):
其中
{状态页地址} 指公开状态页的访问地址,既可以是自定义域名(如 https://status.example.com),也可以是 Flashduty 分配的默认 URL。
Feed 的内容规则如下:
- 包含最近 90 天 内发布的事件(包括故障事件和维护事件),最多返回 50 条,按事件开始时间倒序
- 仅包含当前可见的组件影响记录:被设置为隐藏的分组或组件不会出现在 Feed 中
- 每条事件的
<updated>使用最新一次时间线更新的时间;订阅者重新抓取时可据此发现新动态 - 响应支持
ETag/If-None-Match,未发生变化时返回304 Not Modified
Feed 仅对公开状态页开放。对内部状态页或不存在的状态页请求 Feed URL 会返回
404 Not Found。内部状态页请通过 IM 集成接收更新。订阅范围
订阅者可以灵活选择订阅范围:
选择”全部更新”后,组件级和事件级的订阅设置将被忽略——订阅者会收到所有通知。
管理员管理订阅
查看订阅者
在状态页设置的 订阅管理 中,管理员可以查看当前订阅者列表,并按订阅方式或组件进行筛选。列表支持分页浏览,展示每位订阅者的邮件地址(或用户 ID)、订阅方式和订阅的组件。批量导入
管理员可以批量导入订阅者,适用于迁移场景或需要为特定用户群体预先设置订阅的情况。导入时需提供:通过管理员导入的订阅不需要邮件确认,会直接生效。导入相同接收人的订阅时,系统会替换该接收人之前的订阅设置。
导出订阅者
管理员可以导出订阅者列表,包括每位订阅者的接收地址、订阅方式、订阅的组件等信息。订阅者自助管理
每位订阅者都拥有一个唯一的管理令牌,可以通过该令牌自助管理自己的订阅:- 查看当前订阅:查看自己订阅了哪些组件和事件
- 修改订阅范围:更改订阅的组件或事件
- 取消订阅:完全退出订阅
邮件客户端一键退订
事件变更通知邮件同时携带 RFC 8058 定义的List-Unsubscribe 与 List-Unsubscribe-Post 头。Gmail、Apple Mail、Outlook、Yahoo 等主流邮件客户端会在邮件顶部展示原生的”退订”按钮,订阅者点击后,邮件客户端会自动向 Flashduty 发起一次 POST 请求并立即解除该订阅。