Skip to content

docs: 新增通知配置页 - #2

Merged
stqfdyr merged 2 commits into
mainfrom
feat/notify
Sep 16, 2026
Merged

stqfdyr merged 2 commits into
mainfrom
feat/notify

Conversation

@stqfdyr

@stqfdyr stqfdyr commented Sep 15, 2026 •

Copy link
Copy Markdown
Collaborator

概要

配合 monitor-probe/monitor#10 的通知功能。

  • 配置分组新增「通知」页:通知哪些事、防刷屏规则、Telegram 与 Webhook 的配置、自定义内容(模板与占位符)、Discord / Slack / 企业微信 / 钉钉 / 飞书 / Bark / ntfy / Gotify 的请求体写法、凭证不回读、收不到通知的排查
  • 首页「不做的」与设计哲学里的「通知与告警」改为「负载告警」,首页「做的」加上通知
  • 架构页的面板接口补上 POST /api/notify/test

需要在 monitor#10 合并发版后再合并,避免文档先于功能上线。

测试

  • npm run build(预渲染 16 个路由)、npm run lint
  • 浏览器打开 /config/notify:侧边栏入口、目录锚点(含「自定义内容」)、表格与代码块渲染正常,无报错

更新:钉钉、飞书的关键词与三家拒收回 200

  • 企业微信、钉钉、飞书拒收消息时 HTTP 状态仍是 200,错误码只在响应体里,hub 按状态码判断,发送测试会显示已发送。用无效 token 实测三家均返回 200(errcode 300005 / 93000,code 19001)。常见服务一节加警告,排查一节注明这三家要看群里是否收到

  • 钉钉原先建议的关键词「节点」「通知」只出现在部分消息里:测试消息含「通知」能过,单台节点的离线、恢复不含两者会被拒收。改为只设一个固定关键词并写在模板开头,钉钉、飞书示例模板带上 【探针】

  • 发送测试用的是已保存的配置,配置一节改为先保存再测试

  • {{time}} 改为「通知产生的时间」,离线通知比断开晚一个宽限期

  • npm run build、npm run lint,浏览器确认新增警告框与 #常见服务的写法 锚点渲染正常

- 配置分组新增「通知」:事件与规则、Telegram 与 Webhook 配置、自定义内容、
  常见服务的请求体写法、凭证不回读、收不到通知的排查
- 首页与设计哲学里「不做通知与告警」改为「不做负载告警」
- 架构页补上 POST /api/notify/test
企业微信、钉钉、飞书拒收消息时 HTTP 状态仍是 200,错误码只在响应体里,
hub 按状态码判断,发送测试会显示已发送。实测三家对无效 token 均返回 200。

钉钉此前建议的关键词「节点」「通知」只出现在部分消息里:测试消息含「通知」
能过,单台节点的离线、恢复不含两者会被拒收。改为只设一个固定关键词并写在
模板开头,两家的示例模板带上它。

另外:发送测试用的是已保存的配置,配置一节改为先保存再测试;{{time}} 是
通知产生的时间而非事件发生的时间。
@stqfdyr
stqfdyr merged commit f2b9675 into main Sep 16, 2026
@stqfdyr
stqfdyr deleted the feat/notify branch September 16, 2026 14:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant