Tactical RMM 告警集成

通过 Tactical RMM（自托管的开源 RMM）告警模板中的 Webhook 动作，将代理离线（Agent overdue）、检查（Check）和任务（Task）失败告警同步到 Flashduty On-call。每条 Tactical RMM 告警对应一条 Flashduty 告警：失败时创建，Tactical RMM 判定恢复时自动恢复。 Tactical RMM 没有固定的 Webhook 报文格式，请求体由您在 Webhook 中编写。本页给出需要粘贴的 JSON 模板，Flashduty 按该模板的字段解析。

在 Tactical RMM 中配置

需要创建两个 Webhook（失败一个、恢复一个），再把它们绑定到告警模板。两个 Webhook 的 URL 都是 Flashduty 推送地址，请求体只有 status 不同。

在 Tactical RMM 中创建“失败”Webhook

操作路径：Tactical RMM › Settings › Global Settings › Web Hooks › Add Web Hook请使用 Web Hooks 标签页，不是 URL Actions。

字段	填写内容	必填
URL Pattern	`{integration_url}`	必填
请求方法	POST	必填
Request Headers	见下方	必填
Request Body	见下方，`status` 为 `firing`	必填

Request Headers：

{ "Content-Type": "application/json" }

Request Body：

{
  "status": "firing",
  "alert_id": "{{alert.id}}",
  "alert_type": "{{alert.alert_type}}",
  "severity": "{{alert.severity}}",
  "message": "{{alert.message}}",
  "hostname": "{{agent.hostname}}",
  "agent_id": "{{agent.agent_id}}",
  "client": "{{agent.site.client.name}}",
  "site": "{{agent.site.name}}"
}

在 Tactical RMM 中创建“恢复”Webhook

操作路径：Tactical RMM › Settings › Global Settings › Web Hooks › Add Web Hook

字段	填写内容	必填
URL Pattern	`{integration_url}`	必填
请求方法	POST	必填
Request Headers	与上一步相同	必填
Request Body	与上一步完全一致，只把第一行改为 `"status": "resolved"`	必填

没有“恢复”Webhook 时，Flashduty 中的告警不会自动恢复。

在 Tactical RMM 中把 Webhook 绑定到告警模板

操作路径：Tactical RMM › Settings › Alerts Manager

字段	填写内容	必填
告警模板	新建或编辑需要值班处理的模板	必填
Alert Failure Settings	选择 Send a Web Hook，在 Failure Web Hook 中选“失败”Webhook	必填
Alert Resolved Settings	选择 Send a Web Hook，在 Resolved Web Hook 中选“恢复”Webhook	必填
代理、检查、任务设置	开启需要的告警，并把模板应用到对应的客户、站点或策略	必填

Tactical RMM 默认只对 Error 级别（如代理离线）和 Warning 级别的告警执行 Webhook，Info 级别的告警默认不发送。需要 Info 时，在 Settings › Global Settings › General 的 Receive notifications on 中勾选 Informational Alerts。

保存并验证

操作路径：Tactical RMM › Settings › Global Settings › Web Hooks › Test

在 Webhook 编辑页点击 Test，测试对象类型选 None（不选择代理、站点或客户）。Flashduty 会创建一条 Info 级别的测试告警，标题为 Tactical RMM test notification，它不会自动恢复，验证后请手动关闭。Tactical RMM 的文档说明测试模式下 {{alert.XXX}} 变量不可用；选择了测试对象时变量可能被替换成其他值，Flashduty 会因 alert_type 无效返回参数错误。因此 Test 只能证明地址可达，请用真实告警验证
让一个告警真实触发（例如停止一台测试代理），确认 Flashduty 收到活动告警
告警恢复后，确认 Flashduty 中对应的告警恢复

事件类型

请求体	在 Flashduty 中的效果
`status` 为 `firing`	触发告警
`status` 为 `resolved`	恢复告警
Test 按钮（`alert_id` 和 `alert_type` 仍是未替换的 `{{alert.id}}`、`{{alert.alert_type}}`）	创建一条独立的 Info 告警，不会恢复

Alert Key

Flashduty 使用 alert_id（即 {{alert.id}}，Tactical RMM 中这条告警记录的编号）计算 Alert Key。同一条告警的失败和恢复 Webhook 渲染自同一条记录，编号相同。同一对象在恢复后再次失败会产生新的告警记录，因此在 Flashduty 中是一条新告警。严重程度、消息、主机名变化不会改变 Alert Key，缺少 alert_id 的请求会被拒绝。一个 Flashduty 集成对应一个 Tactical RMM 实例。多个 Tactical RMM 实例的告警编号可能重复，请为每个实例创建各自的集成。

状态和告警等级

Tactical RMM `severity`	Flashduty 等级
`error`	Critical
`warning`	Warning
`info`	Info
其他或为空	Warning

status 为 resolved 时告警恢复，保留最后一次的告警等级。

标签	来源
`check` / `alert_type`	告警类型（`availability`、`check`、`task`、`custom`）
`resource` / `host`	代理主机名（`hostname`）
`alert_id`	Tactical RMM 告警编号
`severity`	Tactical RMM 原始等级
`agent_id`	代理 ID
`client` / `site`	代理所属客户和站点

排查问题

Flashduty 返回参数错误：错误信息会指出问题字段。常见原因是请求体缺少 alert_id，或 alert_type 不是 availability、check、task、custom 之一（例如用 Test 按钮时选择了测试对象）
告警没有恢复：确认已配置“恢复”Webhook 并绑定到告警模板的 Resolved Web Hook，且其 status 为 resolved；可在 Tactical RMM 的告警详情中查看动作的返回结果
Flashduty 没有收到任何推送：确认告警模板已应用到对应的代理，且告警等级没有被 Info/Warning 通知开关过滤
请求体不是合法 JSON：{{alert.message}} 的内容含有双引号时，Tactical RMM 渲染出的 JSON 会失效，此时 Flashduty 会拒绝该请求。可从模板中删除 message 行，Flashduty 会用告警类型和主机名生成标题
测试告警没有关闭：Test 按钮的推送不会恢复，需手动关闭

更多变量请参阅 Tactical RMM 告警文档和 Webhook 文档。

快速开始

产品对比

协作空间

故障管理

故障复盘

状态页

分析看板

集成配置

配置中心

高级功能

集成中心

最佳实践

在 Flashduty On-call

使用专属集成

使用共享集成

在 Tactical RMM 中配置

事件类型

Alert Key

状态和告警等级

标签

排查问题