跳转到主要内容
在 Flashduty On-call 生成唯一的邮件地址,通过邮件的方式将告警的发生与恢复同步到 Flashduty On-call。

创建邮件集成

您可通过以下 2 种方式,获取一个邮件地址,任选其一即可。

使用专属集成

如果您只需将告警发往一个协作空间,选择此方式,配置更简单。
  1. 进入 Flashduty 控制台,选择 协作空间,打开一个协作空间
  2. 选择 配置 → 集成数据 → 专属集成,点击 新增集成
  3. 选择 邮件 Email 集成,点击 保存,生成卡片。
  4. 点击生成的卡片,可以查看到 邮件地址,复制备用,完成。

使用共享集成

如果您需要根据告警事件的 Payload 将告警路由到不同协作空间,选择此方式。
  1. 进入 Flashduty 控制台,选择 集成中心 → 告警事件
  2. 选择 邮件 Email 集成:
    • 集成名称:为当前集成定义一个名称。
    • 收件地址:为邮件设定一个方便记忆的前缀,需要保证在账户下唯一。
  3. 配置默认路由并选择协作空间;创建后可在 路由 中增加更多规则
  4. 保存后复制 邮件地址 备用。

配置邮件集成

1

在 Flashduty 中保存集成并复制邮件地址

操作路径:Flashduty › 集成中心 › 告警事件 › 邮件 Email › 接收 › 邮件怎么变成告警 › 收件地址系统默认生成一个唯一的邮件前缀,您可以修改:前缀不能包含大写字母:系统按收件地址原样(区分大小写)查找集成,部分发件系统会把收件地址转成小写,带大写字母的前缀会收不到邮件。地址在 保存 后才生效:保存前(或集成停用时)发到该地址的邮件会被拒收,发件方收到 553 退信。保存后复制完整的邮件地址。新建集成的问题 1 默认选择 标题完全相同就合并,收到真实邮件后再按第 4 步调整。已有集成如果保存时没有设置推送模式,按 每封都是新告警 处理。
2

在发件系统中把该地址加为告警收件人

操作路径:发件系统的告警通知设置(菜单因系统而异)在监控系统、云服务或脚本的告警通知中,把上一步的邮件地址加为收件人。如果该系统在 Flashduty 有专用集成(例如 Prometheus、Zabbix、Grafana),优先使用专用集成:专用集成可以识别告警等级和恢复状态,邮件集成的告警等级固定为 Warning。
3

从发件系统发送一封测试邮件

操作路径:发件系统的告警通知设置中的测试入口(没有测试入口时,等待一封真实告警邮件)尽量发送一封与真实告警格式相同的邮件,下一步要在它的标题上划选。邮件到达后,它会出现在 用一封邮件试试 面板的 邮件来源 › 收到的邮件 中,集成显示 最新事件时间。
4

在 Flashduty 中按真实邮件回答两个问题

操作路径:Flashduty › 集成中心 › 告警事件在右侧集成列表中点开您的邮件集成(类型为 邮件 Email),进入 接收 页签,在 邮件怎么变成告警 卡片的 简单配置 方式里回答下面两个问题。问题 1:同一个故障的多封邮件,怎么归到一起?选择 按标题里的一段识别 后:右栏 用一封邮件试试 面板的 邮件来源 有三种,都可以用来试运行一封邮件:收到的邮件(集成收到的邮件,被丢弃的标为「已丢弃」)、上传 .eml(从邮箱导出的原始邮件,不超过 5 MB,结果与真实收到的邮件一致)、粘贴(填写邮件的主题、正文和发件人)。上传 .eml 和 粘贴 在保存集成之前就能用,不必先等一封真实邮件;导出原始邮件:Gmail「⋮ → 下载邮件」、Outlook「另存为」、Apple Mail「文件 → 存储为 → 原始邮件源」、QQ 邮箱 / Foxmail「导出 .eml」。从邮箱复制的是渲染后的正文,不是原始 HTML,所以按 邮件内容 写的条件以 收到的邮件 或 上传 .eml 的结果为准。
  1. 在 邮件来源 中选上一步收到的那封邮件
  2. 用鼠标在邮件标题中划出能代表故障的那一段,例如主机名加检查项 web-01 disk。不要包含 PROBLEM、RESOLVED 这类状态词和每次都会变化的数值
  3. 系统生成一个只含一个捕获组的正则,例如对 PROBLEM: web-01 disk usage 93% 划选 web-01 disk 得到 : (.+?) usage,并确认它从触发邮件和恢复邮件中取到相同的内容。生成的正则显示在 生成正则 后面,需要时点击 改正则 手动调整
问题 2:怎么认出「恢复」邮件?填写关键词时注意:
  • 区分大小写:按恢复邮件标题里的原样填写,Resolved 不会匹配 RESOLVED。系统识别出 Zabbix、Nagios、Grafana、【告警】、is down 这几类标题时,会按原文的大小写预填关键词,例如 Grafana 的 [RESOLVED] 预填为 RESOLVED
  • 不能包含 * ? . + ( ) [ ] { } | ^ $ \:关键词按 *关键词* 保存为标题匹配条件,这些符号会改变匹配含义,例如 [RESOLVED] 会匹配几乎所有标题
其他邮件:上面的规则认不出的邮件,选择 生成 Warning 告警 或 丢弃。丢弃的邮件不生成告警,但仍算作已收到:它会出现在 收到的邮件 和接入清单中,并标为「已丢弃」。点击 保存。
5

在 Flashduty 中核对触发和恢复是否关联

操作路径:Flashduty › 集成中心 › 告警事件在右侧集成列表中点开您的邮件集成(类型为 邮件 Email),进入 接收 页签。右栏 用一封邮件试试 面板的下方是 对一对恢复邮件(问题 1 选了 按标题里的一段识别 时显示)。上面那封邮件作为触发邮件,在 选一封恢复邮件 中选择或粘贴一封恢复邮件。系统按页面上尚未保存的配置分别处理两封邮件:
  • 两封得到同一个 Alert Key:恢复邮件会关闭这条告警,配置完成。
  • Key 不同,或恢复邮件没有命中关闭规则:页面显示原因和两封邮件各自取到的内容,回到问题 1、问题 2 调整划选范围、正则或关键词。
这封邮件会变成 显示这封邮件的处理结果:生成告警、关闭告警或丢弃,以及依据(命中第几条规则或「其他邮件」)、标题、Alert Key 和标签。规则命中但正则没有取到内容时,页面提示 Alert Key 改用邮件标题生成。

规则如何生效

问题 1 和问题 2 的回答保存为一条 触发 规则和一条 关闭 规则: 邮件怎么变成告警 卡片右上角的 配置方式 可以切到 规则(完整),直接编辑底层规则(规则类型、过滤条件、Alert Key 提取字段和正则)。已有集成的规则原样显示在这里;规则超出简单配置能表达的范围时(例如多条触发规则、按邮件内容的条件、从内容取 Key),简单配置 不可选,鼠标悬停会提示「这套规则超出了简单配置能表达的范围……」,只能在 规则(完整) 里编辑,在简单配置里回答两个问题也不会改写它们。
  • 关闭规则先于触发规则匹配;同类规则按配置的顺序匹配,命中第一条为止。
  • Alert Key 正则须为合法的 RE2 正则,可写成 /…/ 的形式,保存时校验,非法的表达式会被拦截并提示「请输入合法的正则表达式」。正则还必须至少有一个捕获组:没有括号时同样保存不了,提示「需要用括号标出要取的部分,现在没有括号。」,能推断出改法时还会给出「改成 …」的写法,点 套用 直接采用。至少需要一条触发规则。
  • Alert Key 由正则捕获组的内容生成,多个捕获组用 , 连接。正则捕获不到内容时,系统使用邮件标题生成 Alert Key,告警不会因为配置错误而丢失;这条兜底针对写了括号但某封邮件没匹配上的情况,没有括号的正则现在保存不了。
  • Alert Key 可以从邮件标题或邮件正文中提取。
  • 没有规则命中时,按 其他邮件 的选择生成告警(Alert Key 由邮件标题生成)或丢弃。

为什么不能用 /(.*)/ 提取 Alert Key

/(.*)/ 捕获整个标题。触发邮件 PROBLEM: web-01 disk usage 93% 和恢复邮件 RESOLVED: web-01 disk usage 71% 的标题不同,得到的 Alert Key 也不同,恢复邮件找不到对应的告警,告警永远不会被关闭。 正则只应捕获代表故障本身的部分。例如对上面两封邮件使用:
两封邮件都捕获到 web-01 disk,Alert Key 相同。再设置关闭规则「标题包含 RESOLVED」,恢复邮件就会关闭触发邮件生成的告警。

无事件检测

操作路径:Flashduty › 集成中心 › 告警事件 在右侧集成列表中点开您的邮件集成(类型为 邮件 Email),进入 接收,找到 无事件检测 卡片。 无事件检测 卡片在指定时间内未收到有效事件时,生成一条 Warning 告警。开关位于卡片标题行右侧,默认关闭;关闭时卡片只有一行,不显示其他选项。 开启后显示以下选项:

注意事项

  1. 如果邮件消息体大于 5MB,系统会直接拒绝接收。
  2. 如果邮件文字内容长度超过 128 KiB,系统会进行截断,并在故障详情中增加标签提示:
  3. 如果邮件中包含附件,系统会直接丢弃附件,并在故障详情中增加标签提示:
  4. 邮件触发的新告警中,标题即邮件标题,描述即邮件内容,发件人在 from 标签中。HTML 邮件的纯文本内容在 body_text 标签中;条件里的 邮件内容 按正文的 HTML 源码匹配(含标签),而从正文提取 Alert Key 时先看纯文本,再看 HTML 源码。
  5. 用于试运行的邮件只保留正文的前 8KB。规则从正文提取 Alert Key 时,如果要找的内容在 8KB 之后,试运行结果可能与实际不同,页面会给出提示。
  6. 如果您修改了账户域名,此邮件地址也会变更,务必记得更新推送地址。

状态和告警等级

邮件集成推送到 Flashduty On-call 的告警等级固定为 Warning。如需按邮件内容设置严重程度,在集成的 告警处理 页签中添加规则,参见告警处理 Pipeline。