Fivetran 告警集成

通过 Fivetran 的 Webhook，将连接（connection）的同步结果和连接测试结果同步到 Flashduty On-call。每个连接对应两类告警：同步告警和连接测试告警。同步失败时触发告警，下一次同步成功时告警恢复；连接测试失败时触发告警，连接测试通过时告警恢复。

在 Fivetran 中配置

Fivetran 的 Webhook 通过 Webhook REST API 创建，使用 Fivetran API Key 和 API Secret 进行 Basic 认证。Webhook 分为账户级（覆盖账户下所有连接）和分组级（只覆盖某个 Group 下的连接）两种。

创建 Webhook

将 <推送地址> 替换为 Flashduty 集成的完整推送地址（包含 integration_key），<API_KEY>:<API_SECRET> 替换为 Fivetran 的 API 凭据。账户级 Webhook：

curl -X POST https://api.fivetran.com/v1/webhooks/account \
  -u '<API_KEY>:<API_SECRET>' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "<推送地址>",
    "events": ["sync_end", "connection_failure", "connection_successful"],
    "active": true
  }'

只覆盖某个 Group 时，改用 POST https://api.fivetran.com/v1/webhooks/group/<groupId>，请求体相同。Fivetran 要求 Webhook 地址为 HTTPS。创建（或激活）Webhook 时，Fivetran 会先向该地址发送一次测试请求（event 为 test_event），返回非 2xx 状态码则创建失败。

选择事件

Fivetran 事件	在 Flashduty 中的效果
`sync_end`	同步结束：失败时触发同步告警，成功时恢复
`connection_failure`	连接测试失败，触发连接测试告警
`connection_successful`	连接测试通过，恢复连接测试告警

需要同时订阅 sync_end 和 connection_successful，否则告警不会自动恢复。sync_start、转换（transformation）以及 create_connector、pause_connector 等管理类事件 Flashduty 会返回成功但不创建告警，无需订阅。

status 事件已被 Fivetran 标记为弃用，不要订阅。

验证生命周期

在 Fivetran 中让一个连接同步失败（例如暂时撤销数据源凭据后手动触发同步），确认 Flashduty 收到活动告警；恢复凭据并再次同步成功后，确认原告警恢复。Fivetran 的 Test a Webhook（POST /v1/webhooks/{webhookId}/test，请求体 {"event": "sync_end"}）以及创建、激活 Webhook 时的测试请求，都会发送一个只含 event、created、connector_type、connector_id、destination_group_id 的虚拟事件，其中 connector_id 为 _connector_1，connector_type 为 _connector_type，destination_group_id 为 _destination_1。三个值同时匹配时，Flashduty 打开一条独立的 Info 告警（不会影响真实连接的告警，请手动关闭）；任一值不同则按真实事件处理。

Alert Key

Flashduty 使用连接 ID（Webhook 中的 connector_id）加事件类别（同步、连接测试）作为 Alert Key。Fivetran 文档说明 connector_id 是「发送 Webhook 的连接的 ID」，同一连接的每次同步和连接测试都携带相同的值。同步和连接测试分属两个 Alert Key，因此一次成功的同步不会关闭尚未修复的连接测试告警。每次同步的 sync_id、失败原因和时间的变化都不会改变 Alert Key。缺少 connector_id 的同步或连接测试事件会被拒绝。

状态和告警等级

事件	`data.status`	状态	Flashduty 等级
`sync_end`	`FAILURE`	触发	Critical
`sync_end`	`FAILURE_WITH_TASK`（需要用户处理的错误）	触发	Warning
`sync_end`	`RESCHEDULED`，`isRoutine` 不为 `true`	触发	Warning
`sync_end`	`RESCHEDULED`，`isRoutine` 为 `true`（预期内的重新调度）	不处理	-
`sync_end`	`SUCCESSFUL`	恢复	Info
`sync_end`	`CANCELED` 或其他值	不处理	-
`connection_failure`	-	触发	Critical
`connection_successful`	-	恢复	Info

被忽略的投递，Flashduty 返回成功但不创建告警，也不会关闭现有告警。每次 sync_end 都是一次独立投递，没有进度更新事件：触发后的告警保持活动，直到同一连接的下一次 SUCCESSFUL 同步。如果连接被暂停或删除，已触发的告警不会自动恢复，请在 Flashduty 中手动关闭，或在协作空间中为告警配置超时自动关闭。

标签	来源
`connector_id`	连接 ID，参与 Alert Key
`connector_name`	连接名称，同时作为 `check`
`connector_type`	连接器类型，如 `postgres`
`destination_group_id`	目标 Group ID
`sync_id`	本次同步 ID
`sync_status`	`sync_end` 的 `data.status`
`sync_type`	`HISTORICAL` 或 `INCREMENTAL`
`task_type`	失败或重新调度对应的错误类型（如 `reconnect`）
`test_name`	连接测试失败的测试项名称
`event`	本次推送的事件名

告警描述取自失败原因（data.reason）或连接测试消息（data.message）。

排查问题

创建 Webhook 时 Fivetran 返回 400：确认地址为 HTTPS 且 Flashduty 可访问；Fivetran 在创建和激活时都会先发送一次测试请求，需返回 2xx。Flashduty 对该测试请求返回 200，并按上文打开一条独立的 Info 告警
告警没有恢复：确认 Webhook 订阅了 sync_end 和 connection_successful；预期内的重新调度和 CANCELED 不会产生恢复事件
Webhook 被停用：Fivetran 对持续三天以上只返回非 2xx 的 Webhook 会自动停用，修复地址后通过 API 以 "active": true 重新启用
同一事件收到多次：Fivetran 在投递失败时最多重试五次（24 小时内），相同 Alert Key 的事件会合并

Fivetran 可在创建 Webhook 时指定 secret 对请求体做 HMAC-SHA256 签名，Flashduty 不要求也不校验签名。更多字段含义请参阅 Fivetran Webhooks 和 Fivetran Logs。

快速开始

产品对比

协作空间

故障管理

故障复盘

状态页

分析看板

集成配置

配置中心

高级功能

集成中心

最佳实践

在 Flashduty On-call

使用专属集成

使用共享集成

在 Fivetran 中配置

Alert Key

状态和告警等级

标签

排查问题

​在 Flashduty On-call

​使用专属集成

​使用共享集成

​在 Fivetran 中配置

​Alert Key

​状态和告警等级

​标签

​排查问题

在 Flashduty On-call

使用专属集成

使用共享集成

在 Fivetran 中配置

Alert Key

状态和告警等级

标签

排查问题