Flashduty 状态页允许用户主动订阅服务状态更新。当状态页中有新事件发布或事件状态变更时,你可以选择向订阅者推送通知。Documentation Index
Fetch the complete documentation index at: https://docs.flashcat.cloud/llms.txt
Use this file to discover all available pages before exploring further.
订阅方式
不同类型的状态页支持不同的订阅方式:| 状态页类型 | 订阅方式 | 说明 |
|---|---|---|
| 公开状态页 | 邮件 | 访客通过邮件地址订阅,需完成邮件确认 |
| 公开状态页 | RSS/Atom | 通过 RSS 阅读器或自动化工具订阅事件更新,无需邮件确认 |
| 内部状态页 | IM 集成 | 组织内部用户通过已绑定的 IM 平台接收推送 |
用户自助订阅
邮件订阅(公开状态页)
访客在公开状态页上输入邮件地址后,系统会发送一封确认邮件。确认邮件的有效期为 5 分钟,过期后需重新发起订阅。如果访客在确认前修改了订阅范围,系统会更新待确认的订阅内容,不会重新发送确认邮件。
IM 订阅(内部状态页)
组织内部用户访问内部状态页后,可通过已绑定的 IM 集成(飞书、钉钉、企业微信、Slack)接收事件推送通知。IM 订阅无需邮件确认。RSS/Atom 订阅(公开状态页)
公开状态页会自动提供 RSS 和 Atom 两种格式的事件 Feed,方便访客通过 RSS 阅读器(如 Feedly、Inoreader)或自动化工具订阅状态更新。Feed 为匿名访问,无需注册或邮件确认。 每个公开状态页提供以下四个 URL,内容完全一致,feed.* 与 history.* 互为别名(后者用于兼容 Atlassian Statuspage 的链接习惯):
| URL 格式 | 格式 |
|---|---|
{状态页地址}/feed.rss | RSS 2.0 |
{状态页地址}/feed.atom | Atom 1.0 |
{状态页地址}/history.rss | RSS 2.0(别名) |
{状态页地址}/history.atom | Atom 1.0(别名) |
{状态页地址} 指公开状态页的访问地址,既可以是自定义域名(如 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)、订阅方式和订阅的组件。批量导入
管理员可以批量导入订阅者,适用于迁移场景或需要为特定用户群体预先设置订阅的情况。导入时需提供:| 字段 | 说明 |
|---|---|
| 接收人 | 邮件地址或用户标识 |
| 订阅范围 | 全部更新,或指定组件 ID / 事件 ID |
| 语言偏好 | 通知的语言设置 |
通过管理员导入的订阅不需要邮件确认,会直接生效。导入相同接收人的订阅时,系统会替换该接收人之前的订阅设置。
导出订阅者
管理员可以导出订阅者列表,包括每位订阅者的接收地址、订阅方式、订阅的组件等信息。订阅者自助管理
每位订阅者都拥有一个唯一的管理令牌,可以通过该令牌自助管理自己的订阅:- 查看当前订阅:查看自己订阅了哪些组件和事件
- 修改订阅范围:更改订阅的组件或事件
- 取消订阅:完全退出订阅