文档

状态页

一个供你自己的客户查看的页面,显示哪些服务正常、哪些不正常。页面由我们托管,因此在你的基础设施无法响应时,它仍然能够响应。

如何搭建

先创建页面,然后向其中添加组件。组件就是你选择公开的监控项,使用客户看得懂的名称——“Checkout”,而不是 prod-api-lb-01。如果数量多到有必要,可以把它们分组到各个分区中。

添加组件就等于公开了那个监控项。它的状态、历史和事件都会对任何拿到链接的人可见。监控项的其他信息不会暴露——不包括 URL,不包括配置,也不包括检查从哪里发起——但它是正常还是宕机会变成公开信息。这正是状态页的用意,因此值得慎重决定添加哪些监控项。

你只能添加与该页面处于同一工作区的监控项。在代理商账户中,正是这一点让一个客户的监控项不会出现在另一个客户的页面上。

页面的地址

每个页面都会立即获得一个位于我们域名下的地址。从 Starter 起,你可以改为把自己的域名指向它—— status.yourcompany.com——证书由我们负责。

从 Pro 起,页面可以完全使用你的品牌:你的标志和配色,不出现任何关于我们的字样。

页面上的事件

由监控自动打开的事件会自动出现。对于我们看不到的情况——某个降级的第三方服务、一次计划中的迁移——你也可以手动发布事件,并随着进展不断更新。更新都带有时间戳并会保留下来,因此事后这个页面是一份记录,而不只是当时的一张快照。

只要打开「在状态页上显示」,计划内的维护窗口就会发布在页面上——标题、说明,以及下一次的时间——并且同样出现在页面的订阅源中。还可以在它开始和结束时通知订阅者。它在打开期间会拦下告警,但不会改写可用性数字:除非你同时关掉「继续检查」,否则检查照常运行、照常计入。

订阅者

访客可以订阅,在情况发生变化时收到电子邮件。他们需要先确认,而且每封邮件都带有无需登录即可退订的方式:收到状态更新的人是别人的客户,要求他们为了停止收到未经请求的邮件而先注册账号,正是一个页面招来垃圾邮件投诉的方式。

这些地址是你收集、由我们代你保管的个人数据。它们属于你:你可以随时导出或删除。

私密页面

设置密码后,页面在显示任何内容之前都会先要求输入密码。这适合内部页面,或依据协议只与单个客户共享的页面。

解锁状态会记录在该页面专属的 cookie 中,因此解锁一个页面不会解锁另一个;而且已经解锁页面的访客,始终获得实时版本,而不是缓存副本。

我们刻意不展示的内容

在状态页的任何位置,我们都不会说明检查是从哪里发起的。页面上不会,事件里不会,API 中也不会。检查在哪里运行由我们决定、也由我们更改——探针会在不同主机和不同地点之间迁移——因此把区域代码摆在你的客户面前,是一项关于我们基础设施的声明,它会在无人察觉的情况下过时,而且客户也无法据此做任何事。

订阅源

每个公开页面都会以订阅源的形式发布其事件,并且提供阅读器都能识别的两种格式:/feed.xml 对应 RSS,/atom.xml 对应 Atom,二者都紧挨着页面本身的地址。 页面上也放有这两个链接,因此大多数阅读器仅凭页面 URL 就能找到它们。

订阅源让别人无需交出邮箱地址就能关注你。它承载的内容与页面完全一致——最近三十天的事件、你标记为公开的那些更新,以及你选择公开的维护窗口——除此之外别无其他:没有内部备注,没有事后复盘,也没有任何关于检查从哪里发起的信息。

设有密码或访问受限的页面不提供订阅源。订阅阅读器无法被要求输入密码,因此那里的订阅源会成为绕过这道门槛的途径,而不是一项功能。

速度与可用性

状态页会在边缘节点缓存,并从一份即使我们自己的源站宕机也依然存在的副本提供服务。把状态页托管在它所报告的系统之外,全部理由就在于此:如果一个页面恰好在人们查看它的那次故障期间无法访问,它就没能完成自己唯一的任务。