跳到主要内容

对外通道

把报告、故障和巡检结果推送到飞书、钉钉、企业微信、Teams、Slack 或邮件:投递目标、邮件服务器、私有化 IM 地址白名单、投递记录。失败自动重试,放弃的可以重投。所有版本可用。

对外通道是网关向外发送消息的出口,位于 平台体检 页的标签中,所有版本可用。修改配置需要管理员角色。

经这里发出的消息有:

  • 定时运维报告,发给绑定了该周期的目标。
  • 新故障:严重度不低于目标告警阈值的新故障,发给该目标。
  • 故障调查的推送结论和告警收敛的升级,由分析员或管理员手动推送。
  • 巡检报告,发给任务中选择的目标。

发往外部的内容按当前的字段脱敏档位处理。

对外通道

添加投递目标

前提条件

  • 管理员角色。
  • 发送邮件时,已配置邮件服务器,见下文。
  • IM 部署在内网时,已把它的地址加入白名单,见下文。

步骤

  1. 在 投递目标 标签中选择 新增目标。
  2. 选择 渠道:飞书、钉钉、企业微信、Teams、Slack 或邮件,输入 名称。
  3. 输入群机器人或 Incoming Webhook 的 webhook URL。飞书和钉钉的机器人开启了签名校验时,输入 签名密钥(secret)。邮件渠道改为输入 收件人,以逗号、分号或换行分隔。
  4. 在 绑定周期 中选择接收哪几种报告:日报、周报、月报。
  5. 选择 告警阈值:提示、低、中、高或严重,默认为高。严重度不低于该阈值的新故障推送给这个目标。
  6. 确认 启用该目标 已选中,保存。
  7. 选择该目标的 测试发送,确认消息送达。

webhook URL 和签名密钥都加密保存在网关中,保存后不再显示。编辑目标时,webhook 一栏只显示主机名(「已设置(主机名),留空不改」),签名密钥一栏留空即保留原值;不再需要签名时,选中 清除已设置的密钥(改为无签名)。升级前以明文保存的旧记录,在下一次保存对外通道的任意设置时自动加密。

网关重装后旧密文无法解开,目标标记为 密钥失效,重新填写即可。

删除目标后,它立即停止接收报告和告警,历史投递记录保留。

设置推送排期

投递目标 标签顶部的 推送排期 决定定时报告何时生成并推送。

步骤

  1. 在 推送周期 中选择日报、周报、月报。
  2. 选择 发送时刻(小时),输入 时区,例如 Asia/Shanghai。
  3. 选择 保存排期。

保存后立即生效:日报每天、周报每周一、月报每月 1 日在该时刻生成,再推送给绑定了该周期的目标。没有选择任何周期时,按网关环境变量 RST_REPORT_SCHEDULE 执行,见运维报告。定时报告需要专业版或企业版许可。

配置邮件服务器

邮件服务器全局一份,所有邮件目标共用。

步骤

  1. 在 邮件服务器 标签中输入 服务器地址,选择 加密方式。端口随加密方式变化,手动改过的端口不变。
  2. 输入 用户名 和 密码(应用专用密码或授权码)。服务器不要求认证时,用户名留空。
  3. 输入 发件地址 和 发件人名称,保存。
  4. 在 投递目标 中建一个邮件目标,用它的 测试发送 验证。

保存时只校验格式,能否发出要以测试发送为准。没有配置邮件服务器时,邮件目标持续投递失败,原因只在投递记录中可见。

添加私有化 IM 地址

默认每个渠道只推送到它的官方域名:

渠道官方域名
飞书open.feishu.cn、open.larksuite.com
钉钉oapi.dingtalk.com
企业微信qyapi.weixin.qq.com
Slackhooks.slack.com
Teams*.webhook.office.com、outlook.office.com、outlook.office365.com、*.logic.azure.com、*.logic.azure.us

私有化部署的飞书、企业微信等需要把地址加入白名单。

步骤

  1. 在 私有化 IM 地址 标签中找到对应渠道。
  2. 每行输入一个主机名、IP 或网段,例如 im.corp.local 或 10.20.0.0/24。
  3. 选择 保存地址白名单。

发送时网关解析域名,逐个检查解析到的地址:内网地址只有其 IP 或网段写进了白名单才放行。云元数据地址(例如 169.254.0.0/16)无论如何配置都禁止访问。

重投失败的消息

投递记录 标签列出每条消息的类型、渠道、目标、状态、尝试次数和最后错误。

状态含义
排队中等待发送
发送中正在投递
已送达发送成功
待重试发送失败,按退避间隔自动重试,间隔从 30 秒起逐次加倍
已放弃尝试 6 次仍失败,或遇到不可重试的错误

步骤

  1. 在 投递记录 中按状态筛选 已放弃。
  2. 按 最后错误 修好配置后,选择 重投。

重投需要分析员或管理员角色。

审计转发

审计转发 标签设置调用审计的开关,以及向 syslog 或 webhook 的转发,和上面的投递目标无关。转发到外部 SIEM 是企业版功能。

本页内容