OneUptime 状态页订阅者与通知机制五种订阅通道、双重确认与公告计划的全景解析【免费下载链接】oneuptimeComplete open-source monitoring and observability platform.项目地址: https://gitcode.com/GitHub_Trending/on/oneuptime本文围绕 OneUptime 状态页的订阅者体系与通知体系展开状态页支持的五种订阅通道及其开启条件、访客订阅页的表单构成、邮箱双重确认double opt-in与退订流程、订阅者可自定义的资源与事件类型范围、通知模板定制以及公告Announcement的创建向导、时间窗口计划规则与 SSRF 安全防护。读完后你可以完整配置一个可运营的状态页订阅与通知方案并能从数据模型层面理解每个开关字段的实际作用。状态页订阅者与公告两条互补的信息通道状态页是用户主动来访问的页面而订阅者是希望不用来也能收到的那批人——他们一次性留下邮箱、电话、Slack Webhook 或 HTTP 端点之后状态更新会主动推送给他们。公告是另一半任务。监控可以告诉访客checkout 正在返回 500 错误但监控无法告诉他们周六要迁移数据库某个第三方供应商今天状态不佳或者他们昨天看的那起事件已经彻底关闭了。公告是覆盖这些检查项无法感知之事的自由文本通道且发布到同一份订阅者列表上。本文同时覆盖这两个主题五种订阅通道、访客如何订阅、订阅者可以自选哪些内容、双重确认与退订的完整流程以及公告的撰写、计划与模板化保存。五种订阅通道与开启条件一个状态页支持五种订阅通道每种通道在状态页中都有自己独立的配置项。进入状态页 → 你的页面 → 订阅者 → 订阅设置可以看到五个开关通道字段名默认状态邮箱订阅者enableEmailSubscribers开启SMS 订阅者enableSmsSubscribers关闭Slack 订阅者enableSlackSubscribers关闭Microsoft Teams 订阅者enableMicrosoftTeamsSubscribers关闭Webhook 订阅者enableWebhookSubscribers关闭从源码结构看这些字段定义在状态页数据模型 StatusPage.ts 上并在 StatusPageService.ts 等服务层被消费与文档描述的邮箱默认开、其余默认关一致。仓库中还存在一条专门删除早期总开关列enableSubscribers的数据库迁移 RemoveDeprecatedEnableSubscribersFromStatusPage迁移注释说明该旧字段早已被显示订阅页 按通道开关的方案取代superseded byshowSubscriberPageOnStatusPage the per-channelenableEmailSubscribers/enableSmsSubscribers/enableSlackSubscribersflags这也印证了当前多通道开关的设计是最终形态。每个通道还会在状态页的侧边菜单订阅者下拥有独立的列表页邮箱订阅者、SMS 订阅者、Slack 订阅者、MS Teams 订阅者和Webhook 订阅者。你可以在这些列表中查看谁已注册、手动添加订阅者或在某个订阅者条目上留下internalNote内部备注。仅开启一个开关是不够的。状态页导航栏中的订阅入口只有在显示订阅页面showSubscriberPageOnStatusPage打开、并且至少一个通道被启用时才会出现。如果你开启了邮箱订阅但关闭了显示订阅页面访客将没有任何路径到达订阅表单。同样的五个开关还会出现在高级设置页的订阅设置卡片中与显示订阅页面并排展示——底层是相同的字段。建议固定在专用的订阅设置页操作因为订阅配置的其他部分都集中在那里。访客在订阅页上看到什么订阅页Abonner有一个子菜单每个已启用的通道对应一个标签页——邮箱、SMS、Slack、MS Teams、Webhooks分别对应路由/subscribe/email、/subscribe/sms、/subscribe/slack、/subscribe/microsoft-teams和/subscribe/webhooks。每个标签页只索要它需要的信息邮箱——标题通过邮箱订阅一个字段你的邮箱占位符为abonnentfirma.dk。SMS——标题通过 SMS 订阅一个字段你的电话号码占位符为4512345678。Slack——标题通过 Slack 订阅包含Slack 工作区名称用于校验和Slack 入站 Webhook URL占位符https://hooks.slack.com/services/...。MS Teams——标题通过 Microsoft Teams 订阅包含Microsoft Teams 工作区名称和Microsoft Teams 入站 Webhook URL占位符https://outlook.office.com/webhook/...。Webhooks——标题通过 Webhook 订阅一个字段Webhook URL。每次状态页事件发生时都会向该地址发送 JSONPOST请求。提交按钮叫订阅注册成功后页面显示你已订阅Du er blevet tilmeldt.。页面还分为新建订阅和管理已有订阅两个区域已经订阅过的用户可以回到自己的设置而无需翻找旧邮件。从数据模型看这些表单字段一一对应订阅者实体 StatusPageSubscriber.ts 中的列subscriberEmail邮箱、subscriberPhone电话、subscriberWebhookWebhook、slackIncomingWebhookUrlslackWorkspaceNameSlack、microsoftTeamsIncomingWebhookUrlmicrosoftTeamsWorkspaceNameTeams。其中 Slack 与 Teams 的 Webhook URL 列被标记为仅创建可见、不可读取read: []从访问控制配置看这是一项防止公开页泄露入站 Webhook 地址的安全设计。允许订阅者自选资源与事件类型默认情况下订阅者收到页面上的全部内容。高级订阅者设置卡片中的两个开关会改变这一点允许订阅者选择资源allowSubscribersToChooseResources——默认关闭。开启后订阅表单会出现订阅所有资源复选框取消勾选后显示选择要订阅的资源让访客只挑选部分资源。允许订阅者选择事件类型allowSubscribersToChooseEventTypes——默认关闭。同样的形式一个订阅所有事件类型复选框取消后显示选择要订阅的事件类型。事件类型共三种Incident事件、Announcement公告、Scheduled Event计划事件。这与源码枚举 StatusPageEventType.ts 完全一致enum StatusPageEventType { Incident Incident, Announcement Announcement, ScheduledEvent Scheduled Event, }选择结果最终落在订阅者记录上对应 StatusPageSubscriber.ts 中的以下字段字段默认值含义isSubscribedToAllResourcestrue是否订阅全部资源isSubscribedToAllEventTypestrue是否订阅全部事件类型statusPageResourcesSubscribed to Resources—多对多关联到具体的状态页资源statusPageEventTypesSubscribed to Event Types[]订阅的事件类型列表JSON 列适用场景一个覆盖多个产品的页面。只使用你 API 的客户端并不想收到营销站点抖动时的每一条消息——与其让他们干脆退订不如让他们自己裁剪订阅范围。同一张卡片里还包含订阅者时区设置。邮箱双重确认Double Opt-In邮箱订阅者必须经过确认。当一个以邮箱地址创建的订阅者还不是已确认状态时系统会将isSubscriptionConfirmed是否已确认订阅强制置为false并生成一个六位数字的订阅确认令牌Subscription Confirmation Token。OneUptime 随后发送形如{statusPageUrl}/confirm-subscription/{statusPageSubscriberId}?verification-token{token}的确认链接。访客打开后进入确认订阅页面成功后显示订阅已确认Abonnement bekræftet。在数据模型中这两个字段都有明确定义isSubscriptionConfirmed 默认false而 subscriptionConfirmationToken 为可空短文本列且与确认标志一样被限制为不可通过读接口暴露。SMS、Slack、Microsoft Teams 和 Webhook 订阅者跳过这一步——它们在创建时即把isSubscriptionConfirmed设为true。未确认即静默。拉取通知收件人列表的查询会按isUnsubscribed: false且isSubscriptionConfirmed: true过滤。一个从未点击确认链接的邮箱地址会一直留在邮箱订阅者列表中但收不到任何消息。如果有人坚称自己已订阅却什么都没收到先检查这一列。不存在关闭邮箱确认的开关——它对所有通过状态页注册的人无条件生效。而另一个独立的字段sendYouHaveSubscribedMessage是否发送你已订阅消息默认true见 StatusPageSubscriber.ts控制的是订阅者被确认之后发送的那封你已订阅通知邮件。管理订阅与退订每封发给订阅者的邮件都带有形如{statusPageUrl}/update-subscription/{statusPageSubscriberId}的退订链接。该页面名为更新订阅会告诉访客可以在此修改设置或取消订阅。页面包含当前允许的资源与事件类型选择器一个退订复选框说明为从所有资源退订它写入isUnsubscribed已退订默认false一个名为更新订阅的按钮保存成功后显示你的更改已保存。如果访客弄丢了链接可以在订阅页的管理已有订阅区域点击发送管理链接。OneUptime 会回复说明管理邮件已发出如果没收到请检查垃圾邮件文件夹。支撑这一切的后端端点为POST .../subscribe/:statusPageId、POST .../manage-subscription/:statusPageId、POST .../get-subscription/:statusPageId/:subscriberId与PUT .../update-subscription/:statusPageId/:subscriberId。退订是翻转一个标志而不是删除记录因此该条目会一直保留在通道列表中并标记为已退订——将来需要解释为什么某个地址不再收到消息时这条历史仍在。订阅者会收到什么通知订阅者会收到上述三种事件类型的通知但每种来源都有独立的开关避免误发。公告通知公告本身带有是否通知状态页订阅者shouldStatusPageSubscribersBeNotified字段在创建表单中显示为通知状态页订阅者复选框默认开启。如果公告在**受影响监控可选**中指定了监控则通知范围限定为这些监控的订阅者留空则通知所有订阅者。计划维护事件计划维护事件Scheduled Maintenance拥有自己的一组订阅者字段是否在事件创建时通知状态页订阅者、是否在事件状态变为进行中时通知、是否在事件状态变为结束时通知以及事件前的订阅者通知和下一次事件前通知时间两个提前量配置。事件上的状态页字段决定它出现在哪些页面上而是否应在状态页显示决定它是否可见。从源码结构看通知事件粒度比三种业务事件类型更细StatusPageSubscriberNotificationEventType.ts 枚举列出了事件创建、状态变更、备注创建、复盘发布等独立事件如SubscriberIncidentCreated、SubscriberIncidentStateChanged、SubscriberScheduledMaintenanceStateChanged还包括订阅生命周期事件确认、订阅、管理与周期性报表事件供模板按事件类型分别配置文案。事件IncidentIncident是第三种事件类型。一个事件凭什么会出现在状态页上——它涉及哪些资源、哪些状态会保持它可见——参见 OneUptime 文档中事件状态与严重级别一章。状态页侧边菜单中的通知日志部分{id}/notification-logs是排查这个页面实际发送了什么时的入口。通知模板定制订阅设置中的通知模板卡片展示该状态页当前使用的模板列为模板名称、事件类型和通知方式——你可以按事件类型、按通道分别定制文案而不是对所有消息使用同一套话术。项目级模板位于上一层级状态页 → 设置 → 订阅模板与公告模板并列。邮箱页脚、自定义 SMTP 与 Twilio订阅设置上还有三张卡片控制订阅者消息如何离开你的项目邮箱页脚设置——启用自定义邮箱页脚文本和订阅者邮件通知页脚文本为订阅者邮件加上你自己的页脚自定义 SMTP——自定义 SMTP 配置让订阅者邮件走你自己的邮件服务器而非默认服务器Twilio 配置——Twilio 配置SMS 订阅者使用的 Twilio 账号。如果你有邮箱订阅者值得尽早配置自定义 SMTP来自自己域名的邮件被过滤的概率更低深夜两点读到邮件的客户也更可能信任它。公告Announcement的创建公告是项目级别的一条记录模型StatusPageAnnouncement可以发布到一个或多个状态页可选地限定到特定监控并带有显示时间窗口。创建入口在状态页 → 更多 → 公告或在单个状态页侧边菜单的公告中。创建表单是一个四步向导基本信息——公告标题必填至少两个字符、描述Markdown可选、附件与公告一起放在状态页上的文件状态页——在此状态页显示公告必填的多选列表一条公告可以同时命中多个页面受影响资源——受影响监控可选不选则所有订阅者都会收到通知时间与设置——开始显示公告的时间必填默认为现在、停止显示公告的时间可选、通知状态页订阅者默认开启。访客在/announcements阅读公告页面分为当前公告与历史公告两个区域每条都标注发布于时间戳。当前生效的公告同时悬挂在概览页顶部。如果没有任何内容可显示页面会显示没有公告并注明尚未发布任何内容。附件通过GET {statusPageCrudPath}/status-page-announcement/attachment/:statusPageId/:announcementId/:fileId提供背后是与状态页本身相同的读取校验——私有页面上的附件保持私有。公告计划Plan机制的底层规则显示时间showAnnouncementAt与结束时间endAnnouncementAt控制一切但概览页和公告列表回答的是两个不同的问题这个差异容易让人踩坑概览页当showAnnouncementAt早于当前时间且endAnnouncementAt晚于当前时间或为空时公告显示出来/announcements列表只列出showAnnouncementAt落在显示公告历史天数showAnnouncementHistoryInDays默认 14 天范围内的公告然后在客户端按活跃/历史分组。两个值得在排期时记住的推论没有结束时间的公告永不过期。如果停止显示公告的时间留空它会永远挂在概览页上。所有有时限的内容都应设置结束时间。旧但仍活跃的公告可能从列表中消失。如果公告的显示时间早于showAnnouncementHistoryInDays天之前它会从/announcements列表中消失但仍保留在概览页上。长期运营公告时应调大这个历史窗口。公告是否显示本身由高级设置中的公告设置卡片控制显示公告showAnnouncementsOnStatusPage默认true与显示公告历史天数默认 14。若显示公告关闭公告端点会直接拒绝请求。公告模板如果反复发布同一类公告——每月的维护预告、某个第三方反复出现的服务降级——就提前做成模板。状态页 → 设置 → 公告模板承载模型StatusPageAnnouncementTemplate其表单要求模板名称、模板描述、公告标题、描述、在此状态页显示公告、受影响监控可选和通知订阅者让发布范围与是否通知这两个决定一次做出而不是每次重新判断。Webhook 订阅者与 SSRF 防护Webhook 订阅者在每次状态页事件发生时收到一个 JSONPOST请求因此把状态页更新导入你自己的系统聊天机器人、内部仪表盘、工单系统是最简单的方式。由于订阅是公开页面上的公开操作OneUptime 会对目标地址做防护普通Webhook URL在接受前会被校验私有地址、回环地址、链路本地地址与云元数据地址都会被拒绝无法把一个订阅指向 OneUptime 安装所在网络内部的地址Slack 入站 Webhook URL必须以https://hooks.slack.com/services/开头。如果一个 Webhook 订阅在注册时被拒绝内部地址或格式错误的 URL 是你应该首先排查的原因。进一步阅读状态页 – 概览——状态页是什么、如何组成状态页 – 资源与分组——订阅者可以从中挑选的监控与分组状态页 – 品牌与域名——自定义域名、Logo 以及邮件所链接页面的外观公共 API——以编程方式读取状态页数据。配合数据模型源码 StatusPageSubscriber.ts 与事件类型枚举 StatusPageEventType.ts、StatusPageSubscriberNotificationEventType.ts可以在字段级别核对本文所述的每个开关、默认值与访问控制配置。【免费下载链接】oneuptimeComplete open-source monitoring and observability platform.项目地址: https://gitcode.com/GitHub_Trending/on/oneuptime创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
OneUptime 状态页订阅者与通知机制：五种订阅通道、双重确认与公告计划的全景解析
OneUptime 状态页订阅者与通知机制五种订阅通道、双重确认与公告计划的全景解析【免费下载链接】oneuptimeComplete open-source monitoring and observability platform.项目地址: https://gitcode.com/GitHub_Trending/on/oneuptime本文围绕 OneUptime 状态页的订阅者体系与通知体系展开状态页支持的五种订阅通道及其开启条件、访客订阅页的表单构成、邮箱双重确认double opt-in与退订流程、订阅者可自定义的资源与事件类型范围、通知模板定制以及公告Announcement的创建向导、时间窗口计划规则与 SSRF 安全防护。读完后你可以完整配置一个可运营的状态页订阅与通知方案并能从数据模型层面理解每个开关字段的实际作用。状态页订阅者与公告两条互补的信息通道状态页是用户主动来访问的页面而订阅者是希望不用来也能收到的那批人——他们一次性留下邮箱、电话、Slack Webhook 或 HTTP 端点之后状态更新会主动推送给他们。公告是另一半任务。监控可以告诉访客checkout 正在返回 500 错误但监控无法告诉他们周六要迁移数据库某个第三方供应商今天状态不佳或者他们昨天看的那起事件已经彻底关闭了。公告是覆盖这些检查项无法感知之事的自由文本通道且发布到同一份订阅者列表上。本文同时覆盖这两个主题五种订阅通道、访客如何订阅、订阅者可以自选哪些内容、双重确认与退订的完整流程以及公告的撰写、计划与模板化保存。五种订阅通道与开启条件一个状态页支持五种订阅通道每种通道在状态页中都有自己独立的配置项。进入状态页 → 你的页面 → 订阅者 → 订阅设置可以看到五个开关通道字段名默认状态邮箱订阅者enableEmailSubscribers开启SMS 订阅者enableSmsSubscribers关闭Slack 订阅者enableSlackSubscribers关闭Microsoft Teams 订阅者enableMicrosoftTeamsSubscribers关闭Webhook 订阅者enableWebhookSubscribers关闭从源码结构看这些字段定义在状态页数据模型 StatusPage.ts 上并在 StatusPageService.ts 等服务层被消费与文档描述的邮箱默认开、其余默认关一致。仓库中还存在一条专门删除早期总开关列enableSubscribers的数据库迁移 RemoveDeprecatedEnableSubscribersFromStatusPage迁移注释说明该旧字段早已被显示订阅页 按通道开关的方案取代superseded byshowSubscriberPageOnStatusPage the per-channelenableEmailSubscribers/enableSmsSubscribers/enableSlackSubscribersflags这也印证了当前多通道开关的设计是最终形态。每个通道还会在状态页的侧边菜单订阅者下拥有独立的列表页邮箱订阅者、SMS 订阅者、Slack 订阅者、MS Teams 订阅者和Webhook 订阅者。你可以在这些列表中查看谁已注册、手动添加订阅者或在某个订阅者条目上留下internalNote内部备注。仅开启一个开关是不够的。状态页导航栏中的订阅入口只有在显示订阅页面showSubscriberPageOnStatusPage打开、并且至少一个通道被启用时才会出现。如果你开启了邮箱订阅但关闭了显示订阅页面访客将没有任何路径到达订阅表单。同样的五个开关还会出现在高级设置页的订阅设置卡片中与显示订阅页面并排展示——底层是相同的字段。建议固定在专用的订阅设置页操作因为订阅配置的其他部分都集中在那里。访客在订阅页上看到什么订阅页Abonner有一个子菜单每个已启用的通道对应一个标签页——邮箱、SMS、Slack、MS Teams、Webhooks分别对应路由/subscribe/email、/subscribe/sms、/subscribe/slack、/subscribe/microsoft-teams和/subscribe/webhooks。每个标签页只索要它需要的信息邮箱——标题通过邮箱订阅一个字段你的邮箱占位符为abonnentfirma.dk。SMS——标题通过 SMS 订阅一个字段你的电话号码占位符为4512345678。Slack——标题通过 Slack 订阅包含Slack 工作区名称用于校验和Slack 入站 Webhook URL占位符https://hooks.slack.com/services/...。MS Teams——标题通过 Microsoft Teams 订阅包含Microsoft Teams 工作区名称和Microsoft Teams 入站 Webhook URL占位符https://outlook.office.com/webhook/...。Webhooks——标题通过 Webhook 订阅一个字段Webhook URL。每次状态页事件发生时都会向该地址发送 JSONPOST请求。提交按钮叫订阅注册成功后页面显示你已订阅Du er blevet tilmeldt.。页面还分为新建订阅和管理已有订阅两个区域已经订阅过的用户可以回到自己的设置而无需翻找旧邮件。从数据模型看这些表单字段一一对应订阅者实体 StatusPageSubscriber.ts 中的列subscriberEmail邮箱、subscriberPhone电话、subscriberWebhookWebhook、slackIncomingWebhookUrlslackWorkspaceNameSlack、microsoftTeamsIncomingWebhookUrlmicrosoftTeamsWorkspaceNameTeams。其中 Slack 与 Teams 的 Webhook URL 列被标记为仅创建可见、不可读取read: []从访问控制配置看这是一项防止公开页泄露入站 Webhook 地址的安全设计。允许订阅者自选资源与事件类型默认情况下订阅者收到页面上的全部内容。高级订阅者设置卡片中的两个开关会改变这一点允许订阅者选择资源allowSubscribersToChooseResources——默认关闭。开启后订阅表单会出现订阅所有资源复选框取消勾选后显示选择要订阅的资源让访客只挑选部分资源。允许订阅者选择事件类型allowSubscribersToChooseEventTypes——默认关闭。同样的形式一个订阅所有事件类型复选框取消后显示选择要订阅的事件类型。事件类型共三种Incident事件、Announcement公告、Scheduled Event计划事件。这与源码枚举 StatusPageEventType.ts 完全一致enum StatusPageEventType { Incident Incident, Announcement Announcement, ScheduledEvent Scheduled Event, }选择结果最终落在订阅者记录上对应 StatusPageSubscriber.ts 中的以下字段字段默认值含义isSubscribedToAllResourcestrue是否订阅全部资源isSubscribedToAllEventTypestrue是否订阅全部事件类型statusPageResourcesSubscribed to Resources—多对多关联到具体的状态页资源statusPageEventTypesSubscribed to Event Types[]订阅的事件类型列表JSON 列适用场景一个覆盖多个产品的页面。只使用你 API 的客户端并不想收到营销站点抖动时的每一条消息——与其让他们干脆退订不如让他们自己裁剪订阅范围。同一张卡片里还包含订阅者时区设置。邮箱双重确认Double Opt-In邮箱订阅者必须经过确认。当一个以邮箱地址创建的订阅者还不是已确认状态时系统会将isSubscriptionConfirmed是否已确认订阅强制置为false并生成一个六位数字的订阅确认令牌Subscription Confirmation Token。OneUptime 随后发送形如{statusPageUrl}/confirm-subscription/{statusPageSubscriberId}?verification-token{token}的确认链接。访客打开后进入确认订阅页面成功后显示订阅已确认Abonnement bekræftet。在数据模型中这两个字段都有明确定义isSubscriptionConfirmed 默认false而 subscriptionConfirmationToken 为可空短文本列且与确认标志一样被限制为不可通过读接口暴露。SMS、Slack、Microsoft Teams 和 Webhook 订阅者跳过这一步——它们在创建时即把isSubscriptionConfirmed设为true。未确认即静默。拉取通知收件人列表的查询会按isUnsubscribed: false且isSubscriptionConfirmed: true过滤。一个从未点击确认链接的邮箱地址会一直留在邮箱订阅者列表中但收不到任何消息。如果有人坚称自己已订阅却什么都没收到先检查这一列。不存在关闭邮箱确认的开关——它对所有通过状态页注册的人无条件生效。而另一个独立的字段sendYouHaveSubscribedMessage是否发送你已订阅消息默认true见 StatusPageSubscriber.ts控制的是订阅者被确认之后发送的那封你已订阅通知邮件。管理订阅与退订每封发给订阅者的邮件都带有形如{statusPageUrl}/update-subscription/{statusPageSubscriberId}的退订链接。该页面名为更新订阅会告诉访客可以在此修改设置或取消订阅。页面包含当前允许的资源与事件类型选择器一个退订复选框说明为从所有资源退订它写入isUnsubscribed已退订默认false一个名为更新订阅的按钮保存成功后显示你的更改已保存。如果访客弄丢了链接可以在订阅页的管理已有订阅区域点击发送管理链接。OneUptime 会回复说明管理邮件已发出如果没收到请检查垃圾邮件文件夹。支撑这一切的后端端点为POST .../subscribe/:statusPageId、POST .../manage-subscription/:statusPageId、POST .../get-subscription/:statusPageId/:subscriberId与PUT .../update-subscription/:statusPageId/:subscriberId。退订是翻转一个标志而不是删除记录因此该条目会一直保留在通道列表中并标记为已退订——将来需要解释为什么某个地址不再收到消息时这条历史仍在。订阅者会收到什么通知订阅者会收到上述三种事件类型的通知但每种来源都有独立的开关避免误发。公告通知公告本身带有是否通知状态页订阅者shouldStatusPageSubscribersBeNotified字段在创建表单中显示为通知状态页订阅者复选框默认开启。如果公告在**受影响监控可选**中指定了监控则通知范围限定为这些监控的订阅者留空则通知所有订阅者。计划维护事件计划维护事件Scheduled Maintenance拥有自己的一组订阅者字段是否在事件创建时通知状态页订阅者、是否在事件状态变为进行中时通知、是否在事件状态变为结束时通知以及事件前的订阅者通知和下一次事件前通知时间两个提前量配置。事件上的状态页字段决定它出现在哪些页面上而是否应在状态页显示决定它是否可见。从源码结构看通知事件粒度比三种业务事件类型更细StatusPageSubscriberNotificationEventType.ts 枚举列出了事件创建、状态变更、备注创建、复盘发布等独立事件如SubscriberIncidentCreated、SubscriberIncidentStateChanged、SubscriberScheduledMaintenanceStateChanged还包括订阅生命周期事件确认、订阅、管理与周期性报表事件供模板按事件类型分别配置文案。事件IncidentIncident是第三种事件类型。一个事件凭什么会出现在状态页上——它涉及哪些资源、哪些状态会保持它可见——参见 OneUptime 文档中事件状态与严重级别一章。状态页侧边菜单中的通知日志部分{id}/notification-logs是排查这个页面实际发送了什么时的入口。通知模板定制订阅设置中的通知模板卡片展示该状态页当前使用的模板列为模板名称、事件类型和通知方式——你可以按事件类型、按通道分别定制文案而不是对所有消息使用同一套话术。项目级模板位于上一层级状态页 → 设置 → 订阅模板与公告模板并列。邮箱页脚、自定义 SMTP 与 Twilio订阅设置上还有三张卡片控制订阅者消息如何离开你的项目邮箱页脚设置——启用自定义邮箱页脚文本和订阅者邮件通知页脚文本为订阅者邮件加上你自己的页脚自定义 SMTP——自定义 SMTP 配置让订阅者邮件走你自己的邮件服务器而非默认服务器Twilio 配置——Twilio 配置SMS 订阅者使用的 Twilio 账号。如果你有邮箱订阅者值得尽早配置自定义 SMTP来自自己域名的邮件被过滤的概率更低深夜两点读到邮件的客户也更可能信任它。公告Announcement的创建公告是项目级别的一条记录模型StatusPageAnnouncement可以发布到一个或多个状态页可选地限定到特定监控并带有显示时间窗口。创建入口在状态页 → 更多 → 公告或在单个状态页侧边菜单的公告中。创建表单是一个四步向导基本信息——公告标题必填至少两个字符、描述Markdown可选、附件与公告一起放在状态页上的文件状态页——在此状态页显示公告必填的多选列表一条公告可以同时命中多个页面受影响资源——受影响监控可选不选则所有订阅者都会收到通知时间与设置——开始显示公告的时间必填默认为现在、停止显示公告的时间可选、通知状态页订阅者默认开启。访客在/announcements阅读公告页面分为当前公告与历史公告两个区域每条都标注发布于时间戳。当前生效的公告同时悬挂在概览页顶部。如果没有任何内容可显示页面会显示没有公告并注明尚未发布任何内容。附件通过GET {statusPageCrudPath}/status-page-announcement/attachment/:statusPageId/:announcementId/:fileId提供背后是与状态页本身相同的读取校验——私有页面上的附件保持私有。公告计划Plan机制的底层规则显示时间showAnnouncementAt与结束时间endAnnouncementAt控制一切但概览页和公告列表回答的是两个不同的问题这个差异容易让人踩坑概览页当showAnnouncementAt早于当前时间且endAnnouncementAt晚于当前时间或为空时公告显示出来/announcements列表只列出showAnnouncementAt落在显示公告历史天数showAnnouncementHistoryInDays默认 14 天范围内的公告然后在客户端按活跃/历史分组。两个值得在排期时记住的推论没有结束时间的公告永不过期。如果停止显示公告的时间留空它会永远挂在概览页上。所有有时限的内容都应设置结束时间。旧但仍活跃的公告可能从列表中消失。如果公告的显示时间早于showAnnouncementHistoryInDays天之前它会从/announcements列表中消失但仍保留在概览页上。长期运营公告时应调大这个历史窗口。公告是否显示本身由高级设置中的公告设置卡片控制显示公告showAnnouncementsOnStatusPage默认true与显示公告历史天数默认 14。若显示公告关闭公告端点会直接拒绝请求。公告模板如果反复发布同一类公告——每月的维护预告、某个第三方反复出现的服务降级——就提前做成模板。状态页 → 设置 → 公告模板承载模型StatusPageAnnouncementTemplate其表单要求模板名称、模板描述、公告标题、描述、在此状态页显示公告、受影响监控可选和通知订阅者让发布范围与是否通知这两个决定一次做出而不是每次重新判断。Webhook 订阅者与 SSRF 防护Webhook 订阅者在每次状态页事件发生时收到一个 JSONPOST请求因此把状态页更新导入你自己的系统聊天机器人、内部仪表盘、工单系统是最简单的方式。由于订阅是公开页面上的公开操作OneUptime 会对目标地址做防护普通Webhook URL在接受前会被校验私有地址、回环地址、链路本地地址与云元数据地址都会被拒绝无法把一个订阅指向 OneUptime 安装所在网络内部的地址Slack 入站 Webhook URL必须以https://hooks.slack.com/services/开头。如果一个 Webhook 订阅在注册时被拒绝内部地址或格式错误的 URL 是你应该首先排查的原因。进一步阅读状态页 – 概览——状态页是什么、如何组成状态页 – 资源与分组——订阅者可以从中挑选的监控与分组状态页 – 品牌与域名——自定义域名、Logo 以及邮件所链接页面的外观公共 API——以编程方式读取状态页数据。配合数据模型源码 StatusPageSubscriber.ts 与事件类型枚举 StatusPageEventType.ts、StatusPageSubscriberNotificationEventType.ts可以在字段级别核对本文所述的每个开关、默认值与访问控制配置。【免费下载链接】oneuptimeComplete open-source monitoring and observability platform.项目地址: https://gitcode.com/GitHub_Trending/on/oneuptime创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
