告警进钉钉/企业微信:群晖 Webhook 通知接入实操

告警的最后一公里

NAS 的告警能力其实不弱:硬盘 SMART 异常、RAID 降级、卷容量不足、备份失败都会触发事件。问题出在最后一公里——告警发到某个不常打开的邮箱,等于没发。IT 人员盯的往往是钉钉、企业微信,把告警推进群聊,才是响应率最高的通道。DSM 的 Webhook 通知(控制面板 > 通知设置 > Webhook)就是干这个的。

自定义 Webhook 配置流程

内置提供商有 Synology Chat、Microsoft Teams、LINE 和短信服务,钉钉、企业微信走"自定义"通道:

  1. 单击添加,提供商选自定义
  2. 选择规则——规则决定哪些事件走这个渠道,可新建规则只挑硬盘、存储、备份类关键事件,避免群里刷屏;
  3. 填提供商名称(便于区分),修改主题——主题会附加到通知消息的开头,这个细节后面有用;
  4. 填入 Webhook URL,HTTP 方法选 POST,Content-Type 选 application/json
  5. 编辑 HTTP 主体:模板中的 @@TEXT@@ 占位符会被替换成实际事件消息,照抄下面的模板即可,也可按机器人 API 文档调整字段;
  6. 需要 API 文档要求的标头就单击添加标头补上,保存后单击发送测试消息验证。

两个机器人模板

钉钉群机器人:群设置 > 智能群助手 > 添加机器人 > 自定义。安全设置建议选"自定义关键词"——加签需要动态计算签名,静态模板实现不了,关键词最省事。URL 填 https://oapi.dingtalk.com/robot/send?access_token=你的token,HTTP 主体填:

{"msgtype":"text","text":{"content":"@@TEXT@@"}}

消息内容必须包含安全关键词,把 DSM 里的主题设成含关键词的字样(如"群晖告警"),主题附着在消息开头,校验自然通过。

企业微信群机器人:群右键添加群机器人,URL 填 https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=你的key,HTTP 主体同样用上面的模板。

与邮件通知的组合策略

Webhook 和邮件通知不冲突,建议分层组合:IM 群负责即时感知,邮件负责留档与转发跟进;通知规则分别圈选事件范围——关键硬件事件两路都发,一般性事件只走邮件。事件消息文本可在通知设置 > 事件里编辑,把默认消息改成"设备名 + 部位 + 动作"的格式,群里一眼看懂;通知语言在控制面板 > 区域选项 > 语言里设置。

小结

告警进群的价值在于把"事后翻日志"变成"当场就响应"。配一条自定义 Webhook 用好 @@TEXT@@ 模板,再按事件分级搭配邮件,NAS 的风吹草动就再也不会漏掉了。


如需企业存储告警体系与运维自动化方案,欢迎联系贵州诚鑫致达科技。