flashduty-knowledge-base 1.3.5 → 1.3.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -1
- package/dist/en.d.ts +8 -1
- package/dist/esm/en.js +1570 -375
- package/dist/esm/zh.js +1506 -380
- package/dist/iife/en.js +1428 -233
- package/dist/iife/zh.js +1360 -234
- package/dist/zh.d.ts +8 -1
- package/package.json +1 -1
package/dist/esm/zh.js
CHANGED
|
@@ -81,11 +81,20 @@ POST, Content-Type:"application/json"
|
|
|
81
81
|
|
|
82
82
|
字段|必含|类型|释义
|
|
83
83
|
:-:|:-:|:-:|:---
|
|
84
|
-
| title_rule | 是 | string | 告警标题，不超过\`512\`个字符，超出后将自动截断。<br><br>支持根据告警内容动态生成标题，生成规则请参考 [定制故障标题](https://docs.flashcat.cloud/zh/
|
|
84
|
+
| title_rule | 是 | string | 告警标题，不超过\`512\`个字符，超出后将自动截断。<br><br>支持根据告警内容动态生成标题，生成规则请参考 [定制故障标题](https://docs.flashcat.cloud/zh/on-call/integration/alert-integration/alert-pipelines)。
|
|
85
85
|
| event_status | 是 | string | 告警状态。<br><br>枚举值（\`首字母大写\`）：*Critical*：严重，*Warning*：警告，*Info*：提醒，*Ok*：恢复。<br><br>当指定为Ok时，意味着对告警进行自动恢复。
|
|
86
86
|
| alert_key | 否 | string | 告警标识，用于对已经存在的告警进行更新或自动恢复。<br><br>您可以自定义此值，但不可超过\`255\`个字符。您也可以依赖系统自动生成，该值会在响应中返回。<br><br>如果您上报的是恢复事件，则此值必须存在。
|
|
87
87
|
| description | 否 | string | 告警描述，不超过\`2048\`个字符，超出后将自动截断。
|
|
88
88
|
| labels | 否 | map | 告警标签集合，key 为标签名称，value 为标签值：<br><br>1. 标签的 key 和 value 均为 string 类型，区分大小写。<br>2. 标签的 key 不要超过\`128\`个字符，遵循Prometheus标签命名规范。value 不超过\`2048\`个字符，超出后将自动截断。<br>3. 至多传入\`50\`个标签。\`标签内容参考\`[最佳实践](#最佳实践)。<br><br>示例："resource": "171.26.23.22", "check": "api latency > 500ms"
|
|
89
|
+
| images | 否 | [][image](#image) | 图片数组，可用于前端或飞书和钉钉应用通知的图片展示。系统根据 alt 进行合并覆盖，相同(包括空字符)的alt只保留一条
|
|
90
|
+
|
|
91
|
+
#### image 结构体 <span id="image"></span>
|
|
92
|
+
|
|
93
|
+
字段|必含|类型|释义
|
|
94
|
+
:-:|:-:|:-:|:---
|
|
95
|
+
| alt | 否 | string | 图片的替代文本, 长度限制 128 字符，超长截断。
|
|
96
|
+
| src | 是 | string | 图片来源，值：http/https 开头的图片链接地址 或 [图片上传接口](https://developer.flashcat.cloud/api-344943718)返回的image_key，长度限制 256 字符，超长会被丢弃
|
|
97
|
+
| href | 否 | string | 超链接引用路径，长度限制 256 字符，超长截断
|
|
89
98
|
|
|
90
99
|
</div>
|
|
91
100
|
|
|
@@ -216,10 +225,10 @@ curl -X POST '{api_host}/event/push/alert/standard?integration_key={integration_
|
|
|
216
225
|
3. 新的event可能由于匹配到排除、丢弃、抑制或静默规则，而被丢弃。
|
|
217
226
|
4. 当新的event触发了新告警，则系统会进入第二层降噪检查，判断新告警是否可以被合并到某个活跃的故障中，如果可以，则只会并入已有的故障，而不会产生新故障。
|
|
218
227
|
|
|
219
|
-
更多内容请参考 [告警降噪](https://docs.flashcat.cloud/zh/
|
|
228
|
+
更多内容请参考 [告警降噪](https://docs.flashcat.cloud/zh/on-call/channel/noise-reduction)。
|
|
220
229
|
</details>
|
|
221
230
|
|
|
222
|
-
`,
|
|
231
|
+
`,t=`---
|
|
223
232
|
title: "邮件Email集成"
|
|
224
233
|
description: "在 Flashduty 生成唯一的邮件地址，通过邮件的方式将告警的发生与恢复同步到 Flashduty"
|
|
225
234
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -289,7 +298,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/email-integration-guide"
|
|
|
289
298
|
|
|
290
299
|
配置示例：
|
|
291
300
|
|
|
292
|
-
- 接收所有邮件，当邮件内容中包含 **
|
|
301
|
+
- 接收所有邮件，当邮件内容中包含 **RESOLVED** 字样时，关闭告警，否则触发新告警；
|
|
293
302
|
- Alert Key 从邮件标题中提取，规则为 **/(.\\*)/**。
|
|
294
303
|
|
|
295
304
|
<img src="https://download.flashcat.cloud/flashduty/integration/email/send-mode.png" alt="drawing" width="800"/>
|
|
@@ -318,9 +327,9 @@ attachment_stripped = true
|
|
|
318
327
|
## 严重程度映射关系
|
|
319
328
|
---
|
|
320
329
|
|
|
321
|
-
当前邮件集成推送到 Flashduty 的告警等级均为Warning，但您可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/
|
|
330
|
+
当前邮件集成推送到 Flashduty 的告警等级均为Warning，但您可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/on-call/integration/alert-integration/alert-pipelines) 来自定义严重程度。
|
|
322
331
|
|
|
323
|
-
`,
|
|
332
|
+
`,e=`---
|
|
324
333
|
title: "夜莺/FlahCat集成"
|
|
325
334
|
description: "通过 webhook 的方式将夜莺（Nightingale / n9e）或 Flashcat 告警事件推送到 Flashduty。当告警触发时，向 Flashduty 发送触发事件，当告警恢复时，向 Flashduty 发送恢复事件"
|
|
326
335
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -397,7 +406,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/nightingale-integration-guide"
|
|
|
397
406
|
#### 步骤 1：添加通知媒介
|
|
398
407
|
|
|
399
408
|
1. 登录您的 n9e 控制台，选择 告警管理 > 通知媒介，并点击新增。
|
|
400
|
-
2. 填写媒介名称和标识，选择 **
|
|
409
|
+
2. 填写媒介名称和标识，选择 **Flashduty** 类型，\`URL\` 填写 Flashduty 的 \`推送地址\`。
|
|
401
410
|
3. 点击 **保存** 后，完成。
|
|
402
411
|
|
|
403
412
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/zh/fd/n9e-1.png" />
|
|
@@ -406,7 +415,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/nightingale-integration-guide"
|
|
|
406
415
|
|
|
407
416
|
1. 登录您的 n9e 控制台，选择 告警管理 > 通知规则，并点击新增或编辑已有的告警规则。
|
|
408
417
|
2. 基础信息部分按需配置即可。
|
|
409
|
-
3. 在通知配置中选择上一步添加的 \`
|
|
418
|
+
3. 在通知配置中选择上一步添加的 \`Flashduty\` 通知媒介。
|
|
410
419
|
4. 选择通过此规则生成的告警应发送到的协作空间（协作空间需提前在 [Flashduty](https://console.flashcat.cloud/channel) 中创建），其他按需选择。
|
|
411
420
|
5. 点击 **保存** 后，完成。
|
|
412
421
|
|
|
@@ -415,7 +424,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/nightingale-integration-guide"
|
|
|
415
424
|
#### 步骤 3：告警规则中选择通知规则
|
|
416
425
|
|
|
417
426
|
1. 登录您的 n9e 控制台，选择 告警管理 > 告警规则，并点击新增或编辑已有的告警规则。
|
|
418
|
-
2. 在通知配置中选择上一步添加的 \`
|
|
427
|
+
2. 在通知配置中选择上一步添加的 \`Flashduty\` 通知规则，其他按需选择。
|
|
419
428
|
3. 点击 **保存** 后，完成。
|
|
420
429
|
|
|
421
430
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/zh/fd/n9e-3.png" />
|
|
@@ -907,7 +916,7 @@ media type 必须关联至某个 user 才能发送事件。user 至少拥有对
|
|
|
907
916
|
1. 登录 Zabbix 控制台，选择 \`Users > Users\`，选择 Admin 用户，选择 media，选择 Add，进入编辑窗口：
|
|
908
917
|
|
|
909
918
|
- Type： 选择以上创建的快猫星云 media type
|
|
910
|
-
- Send To：填写
|
|
919
|
+
- Send To：填写 Flashduty
|
|
911
920
|
- 其他配置使用默认配置，保持不变
|
|
912
921
|
|
|
913
922
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/zabbix-3.png" />
|
|
@@ -925,7 +934,7 @@ media type 必须关联至某个 user 才能发送事件。user 至少拥有对
|
|
|
925
934
|
|
|
926
935
|
1. 点击 \`Create action\`，进入 action 编辑页面
|
|
927
936
|
|
|
928
|
-
- Name：填写为“Send To
|
|
937
|
+
- Name：填写为“Send To Flashduty”
|
|
929
938
|
|
|
930
939
|
2. 选择 \`Operations\`，分别添加三种场景的通知发送配置：
|
|
931
940
|
|
|
@@ -1017,7 +1026,7 @@ media type 必须关联至某个 user 才能发送事件。user 至少拥有对
|
|
|
1017
1026
|
|
|
1018
1027
|
1. 点击 \`Create action\`，进入 action 编辑页面
|
|
1019
1028
|
|
|
1020
|
-
- Name：填写为“Send To
|
|
1029
|
+
- Name：填写为“Send To Flashduty”
|
|
1021
1030
|
|
|
1022
1031
|
2. 选择 \`Operations\`，分别添加三种场景的通知发送配置：
|
|
1023
1032
|
|
|
@@ -1063,7 +1072,7 @@ media type 必须关联至某个 user 才能发送事件。user 至少拥有对
|
|
|
1063
1072
|
- \`{ALERT.SUBJECT}\`：告警标题，保持在第一个参数
|
|
1064
1073
|
- \`{ALERT.MESSAGE}\`：告警信息，保持在第二个参数
|
|
1065
1074
|
|
|
1066
|
-
- \`
|
|
1075
|
+
- \`Flashduty webhook 推送请求地址\`，复制集成的推送地址即可，保持在第三个参数
|
|
1067
1076
|
- \`Zabbix 控制台地址\`，直接复制即可（如果您的页面配置了 tomcat/nginx 转发路径，请同时携带），用于生成告警详情页面连接。如果没有空着即可，保持在第四个参数
|
|
1068
1077
|
- \`HTTPProxy\`：如果您的 Zabbix Server 不能直接访问快猫星云服务，可以将该参数设置为一个代理地址。如果没有空着即可，保持在第五个参数
|
|
1069
1078
|
|
|
@@ -1117,7 +1126,7 @@ media type 必须关联至某个 user 才能发送事件。user 至少拥有对
|
|
|
1117
1126
|
|
|
1118
1127
|
1. 点击\`Create action\`，进入 action 编辑页面
|
|
1119
1128
|
|
|
1120
|
-
- Name：填写为“Send To
|
|
1129
|
+
- Name：填写为“Send To Flashduty”
|
|
1121
1130
|
|
|
1122
1131
|
2. 选择 \`Operations\`，分别更新三种场景的通知用户配置：
|
|
1123
1132
|
|
|
@@ -1132,11 +1141,11 @@ media type 必须关联至某个 user 才能发送事件。user 至少拥有对
|
|
|
1132
1141
|
|
|
1133
1142
|
3. 选择 \`Operations\`，分别更新三种场景的通知内容配置：
|
|
1134
1143
|
|
|
1135
|
-
- **在 Default Message 配置项，完整复制以下内容，粘贴在默认内容之后**，
|
|
1144
|
+
- **在 Default Message 配置项，完整复制以下内容，粘贴在默认内容之后**，Flashduty 收到事件后将解析对应文字，找到告警属性信息：
|
|
1136
1145
|
|
|
1137
1146
|
\`\`\`
|
|
1138
1147
|
|
|
1139
|
-
-----
|
|
1148
|
+
-----Flashduty Required Starts-----event_severity={TRIGGER.SEVERITY}||event_name={TRIGGER.NAME}||event_id={EVENT.ID}||event_tags={EVENT.TAGS}||event_ack={EVENT.ACK.STATUS}||event_value={EVENT.VALUE}||trigger_id={TRIGGER.ID}||trigger_desc={TRIGGER.DESCRIPTION}||trigger_expr={TRIGGER.EXPRESSION}||host_group={TRIGGER.HOSTGROUP.NAME}||host_ip={HOST.IP}||host_name={HOST.NAME}||item_name={ITEM.NAME}||item_value={ITEM.VALUE}-----Flashduty Required Ends-----
|
|
1140
1149
|
|
|
1141
1150
|
\`\`\`
|
|
1142
1151
|
|
|
@@ -1230,7 +1239,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/uptime-kuma-integration-guide"
|
|
|
1230
1239
|
**步骤 1：设置通知渠道**
|
|
1231
1240
|
|
|
1232
1241
|
1. 进入 \`Settings -> Notifications\` 页面，单击 Setup 进行编辑，如下图所示；
|
|
1233
|
-
2. \`Notification Type\` 选择 \`
|
|
1242
|
+
2. \`Notification Type\` 选择 \`Flashduty（ Flashduty ）\`；
|
|
1234
1243
|
3. \`Integration Key\` 复制写入集成推送地址中的 integration_key 参数值；
|
|
1235
1244
|
4. \`Severity\` 为严重程度，按需选择；
|
|
1236
1245
|
5. 提交保存
|
|
@@ -1243,7 +1252,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/uptime-kuma-integration-guide"
|
|
|
1243
1252
|
|
|
1244
1253
|
1. 点击 \`Add New Monitor\` 或编辑已有的监控项，按需完成监控配置；
|
|
1245
1254
|
2. 如图，右侧 \`Notifications\` 部分启用上一步创建的通知方式；
|
|
1246
|
-
3. 如需设置标签，可以添加 \`Tags\`，注意仅同时存在 Key/Value 的标签才会推送到
|
|
1255
|
+
3. 如需设置标签，可以添加 \`Tags\`，注意仅同时存在 Key/Value 的标签才会推送到 Flashduty；
|
|
1247
1256
|
4. 提交保存，等待告警触发。
|
|
1248
1257
|
|
|
1249
1258
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/integration/uptime-kuma/monitor.png" />
|
|
@@ -1647,7 +1656,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/aliyun-sls-integration-guide"
|
|
|
1647
1656
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/integration/aliyun-sls/aliyun-sls-update-alert-rule.jpg" />
|
|
1648
1657
|
|
|
1649
1658
|
4. 点击\`确定\`按钮，提交保存
|
|
1650
|
-
5. 针对所有其他规则，重复上述步骤，可以将全部告警推送到
|
|
1659
|
+
5. 针对所有其他规则，重复上述步骤，可以将全部告警推送到 Flashduty
|
|
1651
1660
|
|
|
1652
1661
|
</div>
|
|
1653
1662
|
|
|
@@ -1719,10 +1728,10 @@ url: "https://docs.flashcat.cloud/zh/flashduty/aws-cloudwatch-integration-guide"
|
|
|
1719
1728
|
|
|
1720
1729
|
1. 登录您的 AWS 控制台，检索 \`Simple Notification Service\` 产品，并进入对应产品控制台
|
|
1721
1730
|
2. 进入 \`Topics\` 页面，单击 \`Create topic\` 按钮，开始创建主题
|
|
1722
|
-
3. \`Type\` 选择 \`Standard\`，填写名称为 \`
|
|
1731
|
+
3. \`Type\` 选择 \`Standard\`，填写名称为 \`Flashduty\`
|
|
1723
1732
|
4. 点击 \`Create Topic\` 按钮，完成主题创建
|
|
1724
1733
|
5. 进入 \`Subscriptions\` 页面，单击 \`Create subscription\` 按钮，为主题创建订阅
|
|
1725
|
-
6. \`Topic ARN\` 选择 \`
|
|
1734
|
+
6. \`Topic ARN\` 选择 \`Flashduty\`，\`Protocal\` 选择 \`HTTPS\`，\`Endpoint\` 填写集成的推送地址（当前页面填写集成名称，保存后即可生成地址）
|
|
1726
1735
|
7. 点击 \`Create subscription\` 按钮，完成订阅创建
|
|
1727
1736
|
|
|
1728
1737
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/aws-cloudwatch-subscribe.png" />
|
|
@@ -1730,7 +1739,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/aws-cloudwatch-integration-guide"
|
|
|
1730
1739
|
8. 回到 \`Subscriptions\` 页面，当订阅状态为 \`Confirmed\`，说明订阅地址校验成功，否则请联系 Flashduty
|
|
1731
1740
|
9. 检索 \`CloudWatch\` 产品，并进入对应产品控制台
|
|
1732
1741
|
10. 进入 \`All alrams\` 页面，选择创建或编辑已有的告警策略
|
|
1733
|
-
11. 对于 \`Notification\` 这一步，\`In alarm\`、\`OK\` 和 \`Insufficient data\` 三种状态推送目标 \`SNS topic\` 均选择 \`
|
|
1742
|
+
11. 对于 \`Notification\` 这一步，\`In alarm\`、\`OK\` 和 \`Insufficient data\` 三种状态推送目标 \`SNS topic\` 均选择 \`Flashduty\`，如下图所示：
|
|
1734
1743
|
|
|
1735
1744
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/aws-cloudwatch-alram.png" />
|
|
1736
1745
|
|
|
@@ -1910,7 +1919,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/baidu-bcm-integration-guide"
|
|
|
1910
1919
|
| 通知 | Info | 提醒 |
|
|
1911
1920
|
|
|
1912
1921
|
</div>
|
|
1913
|
-
`,
|
|
1922
|
+
`,g=`---
|
|
1914
1923
|
title: "华为云监控 CES集成"
|
|
1915
1924
|
description: 通过 webhook 的方式同步华为云监控 CES 告警事件到 Flashduty，实现告警事件自动化降噪处理"
|
|
1916
1925
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -1968,7 +1977,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/huawei-ces-integration-guide"
|
|
|
1968
1977
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/huawei-ces-create-notify-obj.png" />
|
|
1969
1978
|
|
|
1970
1979
|
5. 进入 \`告警-告警通知-通知组\` 页面，单击 \`创建通知组\` 按钮
|
|
1971
|
-
6. 组名称填写 \`
|
|
1980
|
+
6. 组名称填写 \`Flashduty\`，通知对象勾选前边创建的 \`flashduty\`
|
|
1972
1981
|
7. 点击 \`确定\` 按钮，完成通知组创建
|
|
1973
1982
|
|
|
1974
1983
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/huawei-ces-create-notify-group.png" />
|
|
@@ -1976,7 +1985,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/huawei-ces-integration-guide"
|
|
|
1976
1985
|
注意，创建通知组时，华为云会发起请求到 Flashduty，验证推送地址，查看通知组的通知对象列表，仅当通知对象状态为 \`已确认\` 时，才会正常推送告警
|
|
1977
1986
|
|
|
1978
1987
|
8. 进入 \`告警-告警规则\` 页面，选择已有的告警规则进行编辑，或者创建新的告警规则，打开 \`告警规则详情\` 页面
|
|
1979
|
-
9. 其中 \`通知组\` 选择 \`
|
|
1988
|
+
9. 其中 \`通知组\` 选择 \`Flashduty\`，触发条件勾选 \`出现告警\` 和 \`恢复正常\`。点击 \`确定\` 按钮，保存修改
|
|
1980
1989
|
|
|
1981
1990
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/huawei-ces-create-alarm.png" />
|
|
1982
1991
|
|
|
@@ -1999,7 +2008,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/huawei-ces-integration-guide"
|
|
|
1999
2008
|
| 提示 | Info | 提醒 |
|
|
2000
2009
|
|
|
2001
2010
|
</div>
|
|
2002
|
-
`,
|
|
2011
|
+
`,m=`---
|
|
2003
2012
|
title: "Influxdata 集成"
|
|
2004
2013
|
description: "通过 webhook 的方式同步 Influxdata 告警事件到 Flashduty，实现告警事件自动化降噪处理"
|
|
2005
2014
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -2062,7 +2071,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/influxdata-integration-guide"
|
|
|
2062
2071
|
#### 步骤1：创建告警通道
|
|
2063
2072
|
1. 登录您的 \`Influxdata\` 控制台，进去 \`Alerts > Notifycation Endpoints\` 页面。
|
|
2064
2073
|
2. 点击 \`Create\` 创建告警通知通道。
|
|
2065
|
-
3. \`Destination\` 选择 \`HTTP\`，\`Name\` 输入 \`
|
|
2074
|
+
3. \`Destination\` 选择 \`HTTP\`，\`Name\` 输入 \`Flashduty\`。
|
|
2066
2075
|
4. \`HTTP Method\` 选择 \`POST\`，\`URL\` 输入集成的推送地址。
|
|
2067
2076
|
|
|
2068
2077
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/influxdb-1.png" />
|
|
@@ -2071,7 +2080,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/influxdata-integration-guide"
|
|
|
2071
2080
|
1. 登录您的 \`Influxdata\` 控制台，进去 \`Alerts > Notifycation Rules\` 页面。
|
|
2072
2081
|
2. 点击 \`Create\` 创建告警通知规则。
|
|
2073
2082
|
3. \`About\` 和 \`Conditions\` 按需配置即可。
|
|
2074
|
-
4. \`Message\` 选择步骤1创建的 \`
|
|
2083
|
+
4. \`Message\` 选择步骤1创建的 \`Flashduty\`。
|
|
2075
2084
|
|
|
2076
2085
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/influxdb-2.png" />
|
|
2077
2086
|
|
|
@@ -2339,7 +2348,7 @@ filter:
|
|
|
2339
2348
|
query_string:
|
|
2340
2349
|
query: "created_at:*"
|
|
2341
2350
|
|
|
2342
|
-
# -------
|
|
2351
|
+
# ------- Flashduty ----------------
|
|
2343
2352
|
alert: pagerduty
|
|
2344
2353
|
pagerduty_service_key: xxx
|
|
2345
2354
|
pagerduty_client_name: wahaha
|
|
@@ -2349,7 +2358,7 @@ pagerduty_v2_payload_component: mysql
|
|
|
2349
2358
|
pagerduty_v2_payload_group: app-stack
|
|
2350
2359
|
pagerduty_v2_payload_severity: error
|
|
2351
2360
|
pagerduty_v2_payload_source: mysql.host.name
|
|
2352
|
-
# -------
|
|
2361
|
+
# ------- Flashduty ----------------
|
|
2353
2362
|
\`\`\`
|
|
2354
2363
|
|
|
2355
2364
|
4. 步骤 4：重启 ElastAlert，等待告警触发
|
|
@@ -2406,7 +2415,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/tencent-bk-integration-guide"
|
|
|
2406
2415
|
---
|
|
2407
2416
|
以下内容已经在\`蓝鲸V6/7版本\`完成验证，V5 及以下版本官方已不再支持，建议您升级。
|
|
2408
2417
|
|
|
2409
|
-
蓝鲸告警策略可以触发\`处理套餐\`，处理套餐可与周边系统打通，来完成复杂功能。我们首先创建一个处理套餐，配置
|
|
2418
|
+
蓝鲸告警策略可以触发\`处理套餐\`，处理套餐可与周边系统打通，来完成复杂功能。我们首先创建一个处理套餐，配置 Flashduty 的回调地址，然后编辑告警策略，关联动作到该处理套餐，实现告警变更自动推送到 Flashduty。具体步骤如下：
|
|
2410
2419
|
|
|
2411
2420
|
#### 步骤 1、创建处理套餐
|
|
2412
2421
|
|
|
@@ -2414,7 +2423,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/tencent-bk-integration-guide"
|
|
|
2414
2423
|
|
|
2415
2424
|
1. 登录您的蓝鲸智云桌面，进入\`监控平台\`；
|
|
2416
2425
|
2. 进入\`配置-处理套餐\`页面，单击\`添加套餐\`按钮，开始创建处理套餐；
|
|
2417
|
-
3. 填写名称为\`Send To
|
|
2426
|
+
3. 填写名称为\`Send To Flashduty\`，套餐类型选择\`HTTP回调\`，推送方式选择\`POST\`，并填写集成的推送地址（保存集成后获得），如下图所示：
|
|
2418
2427
|
|
|
2419
2428
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/integration/tencent-bk/create_package.jpg" />
|
|
2420
2429
|
|
|
@@ -2432,12 +2441,12 @@ url: "https://docs.flashcat.cloud/zh/flashduty/tencent-bk-integration-guide"
|
|
|
2432
2441
|
<div class="md-block">
|
|
2433
2442
|
|
|
2434
2443
|
1. 进入\`配置-告警策略\`页面，选择一个已有的策略进行编辑，或新建一个告警策略；
|
|
2435
|
-
2. 下拉到\`告警处理\`部分，三种场景均选择\`Send To
|
|
2444
|
+
2. 下拉到\`告警处理\`部分，三种场景均选择\`Send To Flashduty\`处理套餐，并关闭\`防御规则\`，如下图：
|
|
2436
2445
|
|
|
2437
2446
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/integration/tencent-bk/update_alert_rule.jpg" />
|
|
2438
2447
|
|
|
2439
2448
|
3. 提交保存，完成；
|
|
2440
|
-
4. 对于其他想要推送到
|
|
2449
|
+
4. 对于其他想要推送到 Flashduty 的告警，重复以上步骤。
|
|
2441
2450
|
|
|
2442
2451
|
</div>
|
|
2443
2452
|
|
|
@@ -2577,7 +2586,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/tencent-cls-integration-guide"
|
|
|
2577
2586
|
"record_group_id": "{{escape .RecordGroupId}}",
|
|
2578
2587
|
"detail_url": "{{escape .DetailUrl}}",
|
|
2579
2588
|
"query_url": "{{escape .QueryUrl}}",
|
|
2580
|
-
"message": {{.Message}},
|
|
2589
|
+
"message": "{{.Message}}",
|
|
2581
2590
|
"query_result": {{.QueryResult}},
|
|
2582
2591
|
"query_log": {{.QueryLog}},
|
|
2583
2592
|
"analysis_result": {{.AnalysisResult}}
|
|
@@ -2727,7 +2736,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/tencent-event-bridge-integration-
|
|
|
2727
2736
|
|
|
2728
2737
|
1. 登录您的腾讯云控制台，选择事件总线产品
|
|
2729
2738
|
2. 进入 事件规则 页面，单击 新建 按钮，开始编辑规则
|
|
2730
|
-
3. 填写名称为
|
|
2739
|
+
3. 填写名称为 Flashduty，如下图所示：
|
|
2731
2740
|
|
|
2732
2741
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/tencent-eb-new-rule.png" />
|
|
2733
2742
|
|
|
@@ -2830,12 +2839,12 @@ url: "https://docs.flashcat.cloud/zh/flashduty/oceanbase-integration-guide"
|
|
|
2830
2839
|
|
|
2831
2840
|
<img alt="drawing" width="600" src="https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/doc/oceanbase-1.png" />
|
|
2832
2841
|
|
|
2833
|
-
5. 配置通道中复制以下脚本内容，同时**请将脚本中的 integration_key 参数补充上
|
|
2842
|
+
5. 配置通道中复制以下脚本内容，同时**请将脚本中的 integration_key 参数补充上 Flashduty 推送地址中的 integration_key 值**。
|
|
2834
2843
|
|
|
2835
2844
|
\`\`\`
|
|
2836
2845
|
#!/usr/bin/env bash
|
|
2837
2846
|
|
|
2838
|
-
function
|
|
2847
|
+
function sendToFlashduty() {
|
|
2839
2848
|
URL="\${address}/event/push/alert/standard?integration_key=\${integration_key}"
|
|
2840
2849
|
curl -s -X POST \${URL} -H 'Content-Type: application/json' -d '{
|
|
2841
2850
|
"event_status": "'\${alert_level}'",
|
|
@@ -2905,7 +2914,7 @@ fi
|
|
|
2905
2914
|
|
|
2906
2915
|
#只有状态是告警中或恢复告警才发通知，屏蔽或抑制的不发通知
|
|
2907
2916
|
if [[ \${statusMd5} == \${active} || \${statusMd5} == \${Inactive} ]];then
|
|
2908
|
-
|
|
2917
|
+
sendToFlashduty
|
|
2909
2918
|
fi
|
|
2910
2919
|
\`\`\`
|
|
2911
2920
|
|
|
@@ -2944,7 +2953,7 @@ OCP告警通知-单条告警
|
|
|
2944
2953
|
<img alt="drawing" width="600" src="https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/doc/oceanbase-2.png" />
|
|
2945
2954
|
|
|
2946
2955
|
3. 推送语言选择 **简体中文**。
|
|
2947
|
-
4. 告警通道选择 **
|
|
2956
|
+
4. 告警通道选择 **Flashduty** 。
|
|
2948
2957
|
5. 开启 **恢复通知**。
|
|
2949
2958
|
6. 提交。
|
|
2950
2959
|
|
|
@@ -2960,22 +2969,7 @@ OCP告警通知-单条告警
|
|
|
2960
2969
|
|OceanBase| Flashduty|状态|
|
|
2961
2970
|
|---|---|---|
|
|
2962
2971
|
|停服|Critical|严重|
|
|
2963
|
-
|严重|
|
|
2964
|
-
|警告|Warning|警告|
|
|
2965
|
-
|注意|Info|提醒|
|
|
2966
|
-
|提醒|Info|提醒|
|
|
2967
|
-
|
|
2968
|
-
</div>
|
|
2969
|
-
|
|
2970
|
-
|
|
2971
|
-
## 状态对照
|
|
2972
|
-
---
|
|
2973
|
-
<div class="md-block">
|
|
2974
|
-
|
|
2975
|
-
|OceanBase| Flashduty|状态|
|
|
2976
|
-
|---|---|---|
|
|
2977
|
-
|停服|Critical|严重|
|
|
2978
|
-
|严重|Warning|严重|
|
|
2972
|
+
|严重|Critical|严重|
|
|
2979
2973
|
|警告|Warning|警告|
|
|
2980
2974
|
|注意|Info|提醒|
|
|
2981
2975
|
|提醒|Info|提醒|
|
|
@@ -3044,7 +3038,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/graylog-integration-guide"
|
|
|
3044
3038
|
|
|
3045
3039
|
<img alt="drawing" width="600" src="https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/doc/graylog-2.png" />
|
|
3046
3040
|
|
|
3047
|
-
6. 输入
|
|
3041
|
+
6. 输入 Flashduty 获取到的 URL (第一次输入需要对 URL 加白)。
|
|
3048
3042
|
|
|
3049
3043
|
<img alt="drawing" width="600" src="https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/doc/graylog-3.png" />
|
|
3050
3044
|
|
|
@@ -3056,11 +3050,11 @@ url: "https://docs.flashcat.cloud/zh/flashduty/graylog-integration-guide"
|
|
|
3056
3050
|
|
|
3057
3051
|
<img alt="drawing" width="600" src="https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/doc/graylog-5.png" />
|
|
3058
3052
|
|
|
3059
|
-
### 步骤2：在告警事件中使用
|
|
3053
|
+
### 步骤2：在告警事件中使用 Flashduty 告警通道
|
|
3060
3054
|
1. 创建或编辑已有的 Event Definition。
|
|
3061
3055
|
2. 此处省略其他告警配置（按业务需求配置告警条件）。
|
|
3062
3056
|
3. 在 Notifications 配置通道。
|
|
3063
|
-
4. Add Notifition 选择
|
|
3057
|
+
4. Add Notifition 选择 Flashduty 通道。
|
|
3064
3058
|
5. 点击 Done。
|
|
3065
3059
|
6. 下一步完成即可。
|
|
3066
3060
|
|
|
@@ -3147,7 +3141,7 @@ rules:
|
|
|
3147
3141
|
tags:
|
|
3148
3142
|
level: Warning
|
|
3149
3143
|
\`\`\`
|
|
3150
|
-
4. 添加
|
|
3144
|
+
4. 添加 Flashduty 的 webhook 地址。
|
|
3151
3145
|
|
|
3152
3146
|
\`\`\`
|
|
3153
3147
|
# 在配置文件底部添加
|
|
@@ -3237,12 +3231,12 @@ Sentry 提供了两类告警机制：Issue Alerts 和 Metric Alerts。Issue Aler
|
|
|
3237
3231
|
|
|
3238
3232
|
## 二、Sentry 告警推送配置
|
|
3239
3233
|
|
|
3240
|
-
### 步骤1：添加
|
|
3234
|
+
### 步骤1：添加 Flashduty Custom Integrations
|
|
3241
3235
|
|
|
3242
3236
|
1. 登录 Sentry 管理控制台。
|
|
3243
3237
|
2. 在左侧导航栏，找到 **Settings => Custom Integrations**。
|
|
3244
3238
|
3. 点击 Create New Integration 并选择 **Internal Integration**。
|
|
3245
|
-
4. 在编辑页面。**Name 处填写
|
|
3239
|
+
4. 在编辑页面。**Name 处填写 Flashduty，WebhookURL 处复制写入集成的推送地址**。
|
|
3246
3240
|
5. 开启 **Alert Rule Action**，参考如下图配置：
|
|
3247
3241
|
|
|
3248
3242
|
<img alt="drawing" width="600" src="https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/doc/sentry-1.png" />
|
|
@@ -3255,11 +3249,11 @@ Sentry 提供了两类告警机制：Issue Alerts 和 Metric Alerts。Issue Aler
|
|
|
3255
3249
|
<img alt="drawing" width="600" src="https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/doc/sentry-2.png" />
|
|
3256
3250
|
|
|
3257
3251
|
**关于 WEBHOOKS 配置的特殊说明：**
|
|
3258
|
-
1. 勾选 **issue** 后
|
|
3252
|
+
1. 勾选 **issue** 后 Flashduty 可以接收 issue 的 resolved 事件，即在 issue 列表中对某个问题进行手动触发 resolved 时，我们会自动恢复 Flashduty 中关联的故障。
|
|
3259
3253
|
2. 不支持 issue 的其他事件，如 create、assigned、archived 和 unresolved。
|
|
3260
|
-
3. 如果同时勾选了 error 和 comment ，
|
|
3254
|
+
3. 如果同时勾选了 error 和 comment ，Flashduty 并不会接收和处理这类事件。
|
|
3261
3255
|
|
|
3262
|
-
### 步骤2：在 Alerts 中使用
|
|
3256
|
+
### 步骤2：在 Alerts 中使用 Flashduty Integration
|
|
3263
3257
|
1. 在左侧导航栏，找到 **Alerts => Create Alert**。
|
|
3264
3258
|
2. 选择要创建的 Alert 类型，如 Issue 。
|
|
3265
3259
|
|
|
@@ -3271,7 +3265,7 @@ Sentry 提供了两类告警机制：Issue Alerts 和 Metric Alerts。Issue Aler
|
|
|
3271
3265
|
|
|
3272
3266
|
<img alt="drawing" width="600" src="https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/doc/sentry-4.png" />
|
|
3273
3267
|
|
|
3274
|
-
5. 通知渠道选择上面添加的 **
|
|
3268
|
+
5. 通知渠道选择上面添加的 **Flashduty**。
|
|
3275
3269
|
|
|
3276
3270
|
|
|
3277
3271
|
<img alt="drawing" width="600" src="https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/doc/sentry-5.png" />
|
|
@@ -3356,7 +3350,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/jiankongbao-integration-guide"
|
|
|
3356
3350
|
|
|
3357
3351
|
<img alt="drawing" width="600" src="https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/doc/jkb-2.png" />
|
|
3358
3352
|
|
|
3359
|
-
4. 自定义名称输入
|
|
3353
|
+
4. 自定义名称输入 Flashduty，回调 URL 输入复制集成的推送地址。
|
|
3360
3354
|
5. 回调方式选择 **POST**，数据格式选择 **JSON**。
|
|
3361
3355
|
6. 勾选**开启 URL 回调**，其他按需选择即可，参考下图配置。
|
|
3362
3356
|
|
|
@@ -3365,10 +3359,10 @@ url: "https://docs.flashcat.cloud/zh/flashduty/jiankongbao-integration-guide"
|
|
|
3365
3359
|
7. 点击保存。
|
|
3366
3360
|
|
|
3367
3361
|
|
|
3368
|
-
### 步骤2：在监控任务使用
|
|
3362
|
+
### 步骤2：在监控任务使用 Flashduty 告警通道
|
|
3369
3363
|
1. 创建或编辑已有的监控任务。
|
|
3370
3364
|
2. 此处省略其他告警配置。
|
|
3371
|
-
3. 在 Webhook 通知处，选择
|
|
3365
|
+
3. 在 Webhook 通知处，选择 Flashduty 通道。
|
|
3372
3366
|
|
|
3373
3367
|
<img alt="drawing" width="600" src="https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/doc/jkb-4.png" />
|
|
3374
3368
|
|
|
@@ -3449,10 +3443,10 @@ url: "https://docs.flashcat.cloud/zh/flashduty/aws-eventbridge-integration-guide
|
|
|
3449
3443
|
|
|
3450
3444
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/aws-eb-3.png" />
|
|
3451
3445
|
|
|
3452
|
-
4. 在 \`Connection details\` 部分中，\`Connection name\` 处填写 \`
|
|
3446
|
+
4. 在 \`Connection details\` 部分中，\`Connection name\` 处填写 \`Flashduty\`。
|
|
3453
3447
|
5. 在 \`Authorization\` 部分中，\`Destination type\` 选择 \`Other\`。
|
|
3454
3448
|
6. \`Authorization type\` 选择 \`API Key\`。
|
|
3455
|
-
7. \`API key name\` 填写 \`
|
|
3449
|
+
7. \`API key name\` 填写 \`Flashduty\`，\`Value\` 填写集成推送地址的 \`integration_key\`。
|
|
3456
3450
|
8. 点击 \`Create\` 保存即可。
|
|
3457
3451
|
|
|
3458
3452
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/aws-eb-4.png" />
|
|
@@ -3463,10 +3457,10 @@ url: "https://docs.flashcat.cloud/zh/flashduty/aws-eventbridge-integration-guide
|
|
|
3463
3457
|
|
|
3464
3458
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/aws-eb-5.png" />
|
|
3465
3459
|
|
|
3466
|
-
2. 在 \`API destination detail\` 编辑界面填写相关信息，\`Name\` 填写 \`
|
|
3460
|
+
2. 在 \`API destination detail\` 编辑界面填写相关信息，\`Name\` 填写 \`Flashduty\` 。
|
|
3467
3461
|
3. \`API destination endpoint\` 填写集成的推送地址（当前页面填写集成名称，保存后即可生成地址）。
|
|
3468
3462
|
4. \`HTTP method\` 选择 \`POST\`。
|
|
3469
|
-
5. \`Connection type\` 选择 \`Use an existing connection\` 并在列表中选择步骤1添加的 \`
|
|
3463
|
+
5. \`Connection type\` 选择 \`Use an existing connection\` 并在列表中选择步骤1添加的 \`Flashduty\` Connection。
|
|
3470
3464
|
6. 点击 \`Create\` 保存即可。
|
|
3471
3465
|
|
|
3472
3466
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/aws-eb-6.png" />
|
|
@@ -3476,7 +3470,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/aws-eventbridge-integration-guide
|
|
|
3476
3470
|
2. 在左侧导航栏选择 \`Buses=>Rules\`，创建或编辑已有的规则。
|
|
3477
3471
|
3. 此处省略其他配置。
|
|
3478
3472
|
4. 在 \`Target types\` 处，选择 \`EventBridge API destination\` 作为目标类型。
|
|
3479
|
-
5. 在 \`API destination\` 中选择 \`Use an existing API destination\`，并在下拉框中选择步骤2创建的 \`
|
|
3473
|
+
5. 在 \`API destination\` 中选择 \`Use an existing API destination\`，并在下拉框中选择步骤2创建的 \`Flashduty\` API destination。
|
|
3480
3474
|
6. \`Next\` 后按需配置，并保存即可。
|
|
3481
3475
|
|
|
3482
3476
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/aws-eb-7.png" />
|
|
@@ -3486,8 +3480,8 @@ url: "https://docs.flashcat.cloud/zh/flashduty/aws-eventbridge-integration-guide
|
|
|
3486
3480
|
|
|
3487
3481
|
<div class="md-block">
|
|
3488
3482
|
|
|
3489
|
-
1. 由于 AWS EventBridge 的事件并没有严重等级，所以推送至
|
|
3490
|
-
2. AWS EventBridge 的事件只有触发，没有恢复，所以
|
|
3483
|
+
1. 由于 AWS EventBridge 的事件并没有严重等级，所以推送至 Flashduty 的事件等级均为 Warning。
|
|
3484
|
+
2. AWS EventBridge 的事件只有触发，没有恢复，所以 Flashduty 接收到的事件也不会自动关联恢复。
|
|
3491
3485
|
|
|
3492
3486
|
</div>
|
|
3493
3487
|
|
|
@@ -3563,7 +3557,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/dynatrace-integration-guide"
|
|
|
3563
3557
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/dyn-3.png" />
|
|
3564
3558
|
|
|
3565
3559
|
5. 在 \`Notification type\` 处，选择 \`Custom Integraion\`。
|
|
3566
|
-
6. \`Display name\` 填写 \`
|
|
3560
|
+
6. \`Display name\` 填写 \`Flashduty\`。
|
|
3567
3561
|
7. \`Webhook URL\` 填写集成的推送地址（当前页面填写集成名称，保存后即可生成地址）。
|
|
3568
3562
|
8. \`Call webhook if problem is closed\` 保持开启状态。
|
|
3569
3563
|
|
|
@@ -3660,14 +3654,14 @@ url: "https://docs.flashcat.cloud/zh/flashduty/huaweilts-integration-guide"
|
|
|
3660
3654
|
|
|
3661
3655
|
## 一、华为云日志服务 LTS 告警推送配置
|
|
3662
3656
|
|
|
3663
|
-
### 步骤1：创建
|
|
3657
|
+
### 步骤1：创建 Flashduty 告警通道
|
|
3664
3658
|
1. 登录您的华为云控制台，检索 \`SMN\` 消息通知服务产品，并进入对应产品控制台。
|
|
3665
3659
|
2. 在左侧导航栏选择 \`主题管理=>主题\`。
|
|
3666
|
-
3. 点击 \`创建主题\`，在编辑页面中的主题名称处输入 \`
|
|
3660
|
+
3. 点击 \`创建主题\`，在编辑页面中的主题名称处输入 \`Flashduty\` 并点击确认。
|
|
3667
3661
|
|
|
3668
3662
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/huawei-lts-1.png" />
|
|
3669
3663
|
|
|
3670
|
-
4. 回到主题列表后，在刚创建的
|
|
3664
|
+
4. 回到主题列表后，在刚创建的 Flashduty 主题中点击 \`添加订阅\`。
|
|
3671
3665
|
|
|
3672
3666
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/huawei-lts-2.png" />
|
|
3673
3667
|
|
|
@@ -3686,14 +3680,14 @@ url: "https://docs.flashcat.cloud/zh/flashduty/huaweilts-integration-guide"
|
|
|
3686
3680
|
|
|
3687
3681
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/huawei-lts-5.png" />
|
|
3688
3682
|
|
|
3689
|
-
3. 在模版编辑页面中，名称填写 **
|
|
3683
|
+
3. 在模版编辑页面中，名称填写 **Flashduty**，消息头语言选择 \`英文\`。
|
|
3690
3684
|
4. 通知类型选择 \`HTTP/HTTPS\`，数据类型选择 \`JSON\`。
|
|
3691
3685
|
5. 点击 \`确认\` 保存。
|
|
3692
3686
|
|
|
3693
3687
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/huawei-lts-6.png" />
|
|
3694
3688
|
|
|
3695
3689
|
6. 回到 \`告警行动规则\` 列表，点击 \`创建\`。
|
|
3696
|
-
7. 规则名称填写 **
|
|
3690
|
+
7. 规则名称填写 **Flashduty** ，主题和消息模版都选择已创建的 **Flashduty** 主题和模版。
|
|
3697
3691
|
|
|
3698
3692
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/huawei-lts-7.png" />
|
|
3699
3693
|
|
|
@@ -3703,7 +3697,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/huaweilts-integration-guide"
|
|
|
3703
3697
|
2. 创建或编辑已有的告警规则。
|
|
3704
3698
|
3. 此处省略其他配置。
|
|
3705
3699
|
4. 在 \`高级设置\` 中，通知场景的 \`告警触发\` 和 \`告警恢复\` 都要勾选上。
|
|
3706
|
-
5. 打开行动规则，并选择 \`步骤2\` 创建的 **
|
|
3700
|
+
5. 打开行动规则，并选择 \`步骤2\` 创建的 **Flashduty** 规则。
|
|
3707
3701
|
6. 语言选择 \`英文\`，完成配置后点击 \`确认\` 保存即可。
|
|
3708
3702
|
|
|
3709
3703
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/huawei-lts-8.png" />
|
|
@@ -3721,7 +3715,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/huaweilts-integration-guide"
|
|
|
3721
3715
|
|Info|Info|提醒|
|
|
3722
3716
|
|
|
3723
3717
|
</div>
|
|
3724
|
-
`,
|
|
3718
|
+
`,P=`---
|
|
3725
3719
|
title: "GoogleCloudMonitoring 告警事件"
|
|
3726
3720
|
description: "通过 webhook 的方式同步 GoogleCloudMonitoring 告警事件到 Flashduty，实现告警事件自动化降噪处理"
|
|
3727
3721
|
date: "2024-07-05T10:00:00+08:00"
|
|
@@ -3784,18 +3778,18 @@ url: "https://docs.flashcat.cloud/zh/flashduty/gcpcm-integration-guide"
|
|
|
3784
3778
|
|
|
3785
3779
|
3. 在 Notification channels 页面找到 \`Webhooks\` 并点击 \`ADD NEW\`。
|
|
3786
3780
|
4. 在 \`Endpoint URL\` 处输入集成的推送地址（当前页面填写集成名称，保存后即可生成地址。
|
|
3787
|
-
5. 在 \`Display Name\` 处输入 **
|
|
3781
|
+
5. 在 \`Display Name\` 处输入 **Flashduty** 。
|
|
3788
3782
|
6. 点击 \`TEST CONNECTION\` 后，点击 \`SAVE\` 保存即可。
|
|
3789
3783
|
|
|
3790
3784
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/google-cm-2.png" />
|
|
3791
3785
|
|
|
3792
|
-
### 步骤2：在告警策略中使用
|
|
3786
|
+
### 步骤2：在告警策略中使用 Flashduty 告警通道
|
|
3793
3787
|
|
|
3794
3788
|
1. 回到 \`Alerting\` 页面。
|
|
3795
3789
|
2. 创建或编辑已有的策略。
|
|
3796
3790
|
3. 此处省略其他策略配置（按业务需求配置告警条件）。
|
|
3797
3791
|
4. 在 \`Notifications and name\` 页面中，将 \`Use notification channel\` 保持开启状态。
|
|
3798
|
-
5. 在 \`Notification channels\` 下拉框中选择 **步骤1** 创建的 **
|
|
3792
|
+
5. 在 \`Notification channels\` 下拉框中选择 **步骤1** 创建的 **Flashduty** 通道，并勾选 \`Notify on incident closure\`。
|
|
3799
3793
|
6. 完成其他配置并保存策略即可。
|
|
3800
3794
|
|
|
3801
3795
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/google-cm-3.png" />
|
|
@@ -3815,7 +3809,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/gcpcm-integration-guide"
|
|
|
3815
3809
|
|No severity|Info|提醒|
|
|
3816
3810
|
|
|
3817
3811
|
</div>
|
|
3818
|
-
`,
|
|
3812
|
+
`,L=`---
|
|
3819
3813
|
title: "Splunk 告警事件"
|
|
3820
3814
|
description: "通过 webhook 的方式同步 Splunk 告警事件到 Flashduty，实现告警事件自动化降噪处理"
|
|
3821
3815
|
date: "2024-08-20T10:00:00+08:00"
|
|
@@ -3954,7 +3948,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/appdynamics-integration-guide"
|
|
|
3954
3948
|
|
|
3955
3949
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/appdyn-1.png" />
|
|
3956
3950
|
|
|
3957
|
-
3. 在模版配置中，\`Name\` 填写 **
|
|
3951
|
+
3. 在模版配置中，\`Name\` 填写 **Flashduty** 。
|
|
3958
3952
|
4. 在 \`Request URL\` 部分，\`Method\` 选择 **POST** ，\`Raw URL\` 填写集成的推送地址（当前页面填写集成名称，保存后即可生成地址）。
|
|
3959
3953
|
|
|
3960
3954
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/appdyn-2.png" />
|
|
@@ -4032,7 +4026,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/appdynamics-integration-guide"
|
|
|
4032
4026
|
|
|
4033
4027
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/appdyn-6.png" />
|
|
4034
4028
|
|
|
4035
|
-
3. 在弹出的 \`Create HTTP Action\` 框中，输入 Name，\`HTTP Request Template\` 选择 \`步骤1\` 创建的 **
|
|
4029
|
+
3. 在弹出的 \`Create HTTP Action\` 框中，输入 Name，\`HTTP Request Template\` 选择 \`步骤1\` 创建的 **Flashduty** 并点击 \`SAVE\`。
|
|
4036
4030
|
|
|
4037
4031
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/appdyn-7.png" />
|
|
4038
4032
|
|
|
@@ -4118,7 +4112,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/solarwinds-integration-guide"
|
|
|
4118
4112
|
|
|
4119
4113
|
**前提说明**
|
|
4120
4114
|
1. SolarWinds 的告警类型有五种（Anomaly、Entity、Event、Log、Metric Group），每种类型对应不同的告警通道，所以需要创建五个告警通道，以便在不同告警类型中使用。
|
|
4121
|
-
2. 在创建 Webhook 通道过程中，其中 Name 字段建议使用： 类型
|
|
4115
|
+
2. 在创建 Webhook 通道过程中，其中 Name 字段建议使用： 类型_Flashduty 组合的形式，例如：Anomaly_Flashduty。
|
|
4122
4116
|
3. 在选择 **Select Custom Body Template Based On The Alert Types** 时，系统会默认生成相应的 **HTTP POST Body**， **生成的模版内容请不要修改**。
|
|
4123
4117
|
|
|
4124
4118
|
**开始创建**
|
|
@@ -4128,7 +4122,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/solarwinds-integration-guide"
|
|
|
4128
4122
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/sw-1.png" />
|
|
4129
4123
|
|
|
4130
4124
|
3. 点击 \`CREATE CONFIGURATION\` 进行创建相应的告警通道。
|
|
4131
|
-
4. 在 \`Method\` 处选择 **POST** ，\`Name\` 处可以根据前提说明中的建议进行命名，例如：
|
|
4125
|
+
4. 在 \`Method\` 处选择 **POST** ，\`Name\` 处可以根据前提说明中的建议进行命名，例如：Anomaly_Flashduty。
|
|
4132
4126
|
5. \`Destination URL\` 填写集成的推送地址（当前页面填写集成名称，保存后即可生成地址）。
|
|
4133
4127
|
6. \`Content Type\` 选择 **application/json**。
|
|
4134
4128
|
7. \`Select Custom Body Template Based On The Alert Types\` 选择需要创建的类型，例如：Anomaly Based Alert。
|
|
@@ -4144,7 +4138,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/solarwinds-integration-guide"
|
|
|
4144
4138
|
1. 在左侧导航栏找到 \`Alerts\`，选择 \`Alert Settings\`。
|
|
4145
4139
|
2. 创建或编辑已有的策略（告警规则按需配置即可，此处省略告警规则的配置）。
|
|
4146
4140
|
3. 在配置策略页面的 \`Actions\` 部分中，\`Services\` 选择 **Webhook** 。
|
|
4147
|
-
4. \`Configuration\` 选择步骤1创建的
|
|
4141
|
+
4. \`Configuration\` 选择步骤1创建的 Anomaly_Flashduty 通道。
|
|
4148
4142
|
5. \`Send an additional notification when the Alert is cleared\` 保持开启状态。
|
|
4149
4143
|
|
|
4150
4144
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/sw-4.png" />
|
|
@@ -4219,14 +4213,14 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-metric-integration-gui
|
|
|
4219
4213
|
|
|
4220
4214
|
## 一、火山引擎云监控告警推送配置
|
|
4221
4215
|
|
|
4222
|
-
### 步骤1：创建
|
|
4216
|
+
### 步骤1：创建 Flashduty 告警通道
|
|
4223
4217
|
1. 登录您的火山引擎控制台，检索 \`云监控\` 产品，并进入对应产品控制台。
|
|
4224
4218
|
2. 在左侧导航栏选择 \`通知组=>回调\`。
|
|
4225
4219
|
3. 点击 \`创建回调地址\`。
|
|
4226
4220
|
|
|
4227
4221
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/ve-m-1.png" />
|
|
4228
4222
|
|
|
4229
|
-
4. 在编辑页面中填写相应的信息，回调地址名称填写 \`
|
|
4223
|
+
4. 在编辑页面中填写相应的信息，回调地址名称填写 \`Flashduty_Metric\`。
|
|
4230
4224
|
5. 回调地址类型选择 \`通用回调地址\`。
|
|
4231
4225
|
6. 回调地址填写**集成的推送地址**（当前页面填写集成名称，保存后即可生成地址）。
|
|
4232
4226
|
7. 点击 \`确认\` 即可完成创建（不支持连通性测试，即使点击测试出现连通性失败，也不会影响告警的接收）。
|
|
@@ -4239,7 +4233,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-metric-integration-gui
|
|
|
4239
4233
|
2. 创建或编辑已有的告警策略（策略请按需配置，此处略过）。
|
|
4240
4234
|
3. 在策略编辑页面中，\`发送聚合策略\` 选择 \`规则和资源\`。
|
|
4241
4235
|
4. \`告警恢复通知\` 保持开启状态。
|
|
4242
|
-
5. 在 \`告警渠道\` 中勾选 \`告警回调\` ，并在告警回调下拉框中选择**步骤1**创建的 \`
|
|
4236
|
+
5. 在 \`告警渠道\` 中勾选 \`告警回调\` ，并在告警回调下拉框中选择**步骤1**创建的 \`Flashduty_Metric\` 通道。
|
|
4243
4237
|
6. 其他配置完成后，点击 \`确认\` 即可完成。
|
|
4244
4238
|
|
|
4245
4239
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/ve-m-6.png" />
|
|
@@ -4255,7 +4249,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-metric-integration-gui
|
|
|
4255
4249
|
|通知|Info|提醒|
|
|
4256
4250
|
|
|
4257
4251
|
</div>
|
|
4258
|
-
|
|
4252
|
+
`,$=`---
|
|
4259
4253
|
title: "火山引擎云监控事件中心告警事件"
|
|
4260
4254
|
description: "通过 webhook 的方式同步火山引擎云监控事件中心告警事件到 Flashduty，实现告警事件自动化降噪处理"
|
|
4261
4255
|
date: "2024-07-05T10:00:00+08:00"
|
|
@@ -4310,14 +4304,14 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-event-integration-guid
|
|
|
4310
4304
|
|
|
4311
4305
|
## 一、火山引擎云监控事件中心告警推送配置
|
|
4312
4306
|
|
|
4313
|
-
### 步骤1：创建
|
|
4307
|
+
### 步骤1：创建 Flashduty 告警通道
|
|
4314
4308
|
1. 登录您的火山引擎控制台，检索 \`云监控\` 产品，并进入对应产品控制台。
|
|
4315
4309
|
2. 在左侧导航栏选择 \`通知组=>回调\`。
|
|
4316
4310
|
3. 点击 \`创建回调地址\`。
|
|
4317
4311
|
|
|
4318
4312
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/ve-m-1.png" />
|
|
4319
4313
|
|
|
4320
|
-
4. 在编辑页面中填写相应的信息，回调地址名称填写 \`
|
|
4314
|
+
4. 在编辑页面中填写相应的信息，回调地址名称填写 \`Flashduty_Event\`。
|
|
4321
4315
|
5. 回调地址类型选择 \`通用回调地址\`。
|
|
4322
4316
|
6. 回调地址填写**集成的推送地址**（当前页面填写集成名称，保存后即可生成地址）。
|
|
4323
4317
|
7. 点击 \`确认\` 即可完成创建（不支持连通性测试，即使点击测试出现连通性失败，也不会影响告警的接收）。
|
|
@@ -4328,7 +4322,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-event-integration-guid
|
|
|
4328
4322
|
|
|
4329
4323
|
1. 在左侧导航栏选择 \`事件中心=>事件规则\`。
|
|
4330
4324
|
2. 创建或编辑已有的事件规则（规则请按需配置，此处略过）。
|
|
4331
|
-
3. 在规则编辑页面中，投递渠道处勾选 \`告警回调\`，并在告警回调下拉框中选择**步骤1**创建的 \`
|
|
4325
|
+
3. 在规则编辑页面中，投递渠道处勾选 \`告警回调\`，并在告警回调下拉框中选择**步骤1**创建的 \`Flashduty_Event\` 通道。
|
|
4332
4326
|
4. 其他配置完成后，点击 \`确认\` 即可完成。
|
|
4333
4327
|
|
|
4334
4328
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/ve-m-3.png" />
|
|
@@ -4344,7 +4338,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-event-integration-guid
|
|
|
4344
4338
|
|通知|Info|提醒|
|
|
4345
4339
|
|
|
4346
4340
|
</div>
|
|
4347
|
-
|
|
4341
|
+
`,M=`---
|
|
4348
4342
|
title: "火山引擎日志服务 TLS 告警事件"
|
|
4349
4343
|
description: "通过 webhook 的方式同步火山引擎日志服务 TLS 告警事件到 Flashduty，实现告警事件自动化降噪处理"
|
|
4350
4344
|
date: "2024-07-05T10:00:00+08:00"
|
|
@@ -4399,14 +4393,14 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-tls-integration-guide"
|
|
|
4399
4393
|
|
|
4400
4394
|
## 一、火山引擎日志服务 TLS 告警推送配置
|
|
4401
4395
|
|
|
4402
|
-
### 步骤1：创建
|
|
4396
|
+
### 步骤1：创建 Flashduty 告警通道
|
|
4403
4397
|
1. 登录您的火山引擎控制台，检索 \`TLS\`日志服务产品，并进入对应产品控制台。
|
|
4404
4398
|
2. 在左侧导航栏选择 \`日志告警=>通知管理\`。
|
|
4405
4399
|
3. 选择 \`webhook 告警集成\`，并点击 \`创建 webhook 告警集成\`。
|
|
4406
4400
|
|
|
4407
4401
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/ve-tls-1.png" />
|
|
4408
4402
|
|
|
4409
|
-
4. 在弹出的编辑框中填写相应的信息，名称填写 \`
|
|
4403
|
+
4. 在弹出的编辑框中填写相应的信息，名称填写 \`Flashduty\`。
|
|
4410
4404
|
5. 类型选择 \`自定义 Webhook\`，请求方法选择 \`POST\`。
|
|
4411
4405
|
6. 请求地址填写**集成的推送地址**（当前页面填写集成名称，保存后即可生成地址）。
|
|
4412
4406
|
7. 请求头保持默认的即可，配置完成点击 \`创建\`。
|
|
@@ -4417,7 +4411,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-tls-integration-guide"
|
|
|
4417
4411
|
|
|
4418
4412
|
1. 回到 \`通知管理\` 页面。
|
|
4419
4413
|
2. 选择 \`内容模版\`，并点击 \`创建内容模版\`。
|
|
4420
|
-
3. 在创建模版页面中填写相关信息，模版名称填写 \`
|
|
4414
|
+
3. 在创建模版页面中填写相关信息，模版名称填写 \`Flashduty\`。
|
|
4421
4415
|
4. 其他类型的通道内容可为空，在 \`自定义Webhook\` 的通知内容处，填写以下模版内容。
|
|
4422
4416
|
|
|
4423
4417
|
\`\`\`
|
|
@@ -4450,7 +4444,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-tls-integration-guide"
|
|
|
4450
4444
|
|
|
4451
4445
|
1. 回到 \`通知管理\` 页面。
|
|
4452
4446
|
2. 选择 \`通知组\`，并点击 \`创建通知组\`。
|
|
4453
|
-
3. 在编辑通知组页面中填写相关信息，通知组名称填写 \`
|
|
4447
|
+
3. 在编辑通知组页面中填写相关信息，通知组名称填写 \`Flashduty\`。
|
|
4454
4448
|
4. 通知规则和其他配置可按需配置（此处略过）。
|
|
4455
4449
|
5. 在通知渠道配置中，接收渠道的 \`自定义webhook\` 保持勾选状态。
|
|
4456
4450
|
6. \`Webhook\` 选择**步骤1**创建的 **FlahDuty** 通道。
|
|
@@ -4465,7 +4459,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-tls-integration-guide"
|
|
|
4465
4459
|
2. 创建或编辑已有的告警策略。
|
|
4466
4460
|
3. 告警规则可按需配置（此处略过）。
|
|
4467
4461
|
4. 在 \`通知组\` 处，点击 \`关联通知组\`。
|
|
4468
|
-
5. 在弹出的选择框中，选择**步骤3**创建的 **
|
|
4462
|
+
5. 在弹出的选择框中，选择**步骤3**创建的 **Flashduty** 通知组，选择好后，点击 \`关联\`。
|
|
4469
4463
|
6. 配置好其他内容后，点击 \`创建/保存\` 即可完成。
|
|
4470
4464
|
|
|
4471
4465
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/ve-tls-5.png" />
|
|
@@ -4600,7 +4594,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/opmanager-integration-guide"
|
|
|
4600
4594
|
|
|
4601
4595
|
10. 选择希望应用此配置文件的设备，使用右箭头将它们移动到选定设备窗口，然后点击下一步。
|
|
4602
4596
|
11. Time Window/Delayed Trigger/Recurring Trigger 可按需配置，然后点击下一步。
|
|
4603
|
-
12. 为该配置文件添加名称 \`
|
|
4597
|
+
12. 为该配置文件添加名称 \`Flashduty\`，然后点击 \`Save\` 保存即可完成配置。
|
|
4604
4598
|
|
|
4605
4599
|
</dev>
|
|
4606
4600
|
|
|
@@ -4616,7 +4610,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/opmanager-integration-guide"
|
|
|
4616
4610
|
| Attention | Info | 提醒 |
|
|
4617
4611
|
|
|
4618
4612
|
</div>
|
|
4619
|
-
`,
|
|
4613
|
+
`,U=`---
|
|
4620
4614
|
title: "Meraki 告警事件"
|
|
4621
4615
|
description: "通过 webhook 的方式同步 Meraki 告警事件到 Flashduty，实现告警事件自动化降噪处理"
|
|
4622
4616
|
date: "2024-07-05T10:00:00+08:00"
|
|
@@ -4673,7 +4667,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/meraki-integration-guide"
|
|
|
4673
4667
|
1. 登录您的 \`Meraki\` 控制台，选择需要配置告警的设备。
|
|
4674
4668
|
2. 在 \`Alerts\` 页面中，按需配置 \`Cellular gateway\` 和其他部分。
|
|
4675
4669
|
3. 在 \`Webhooks\` 处，配置 \`HTTPS receivers\`。
|
|
4676
|
-
4. \`Name\` 填写 \`
|
|
4670
|
+
4. \`Name\` 填写 \`Flashduty\`，\`URL\` 填写**告警集成的推送地址**。
|
|
4677
4671
|
5. \`Shared secret\` 留空，\`Payload template\` 保持默认的 \`Meraki(included)\` 即可。
|
|
4678
4672
|
6. 点击 \`Save\` 保存。
|
|
4679
4673
|
|
|
@@ -4692,7 +4686,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/meraki-integration-guide"
|
|
|
4692
4686
|
| informational | Info | 提醒 |
|
|
4693
4687
|
|
|
4694
4688
|
</div>
|
|
4695
|
-
`,
|
|
4689
|
+
`,W=`---
|
|
4696
4690
|
title: "天翼云告警事件"
|
|
4697
4691
|
description: "通过 webhook 的方式同步天翼云告警事件到 Flashduty，实现告警事件自动化降噪处理"
|
|
4698
4692
|
date: "2024-07-05T10:00:00+08:00"
|
|
@@ -4701,7 +4695,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/statecloud-integration-guide"
|
|
|
4701
4695
|
|
|
4702
4696
|
通过 webhook 的方式同步天翼云监控告警事件到 Flashduty，实现告警事件自动化降噪处理。
|
|
4703
4697
|
|
|
4704
|
-
天翼云[二级节点](#二级节点)的资源监控事件推送，请使用华为云集成，请参考 [华为云告警集成指引](https://docs.flashcat.cloud/zh/
|
|
4698
|
+
天翼云[二级节点](#二级节点)的资源监控事件推送，请使用华为云集成，请参考 [华为云告警集成指引](https://docs.flashcat.cloud/zh/on-call/integration/alert-integration/alert-sources/huawei-ces)。
|
|
4705
4699
|
|
|
4706
4700
|
<div class="hide">
|
|
4707
4701
|
|
|
@@ -4846,7 +4840,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/guance-integration-guide"
|
|
|
4846
4840
|
|
|
4847
4841
|
1. 登录您的 \`观测云\` 控制台，在 \`监控\` 中，选择 \`告警策略管理\` 。
|
|
4848
4842
|
2. 在 \`告警策略\` 页面， 新建或修改告警策略。
|
|
4849
|
-
3. 在告警策略编辑页面的通知配置部分，选择 \`等级\`，\`通知对象\` 选择步骤1中创建的 \`
|
|
4843
|
+
3. 在告警策略编辑页面的通知配置部分，选择 \`等级\`，\`通知对象\` 选择步骤1中创建的 \`Flashduty\`。
|
|
4850
4844
|
4. 其他按需配置，点击 \`保存\` 完成创建。
|
|
4851
4845
|
|
|
4852
4846
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/zh/fd/guance-2.png" />
|
|
@@ -4868,7 +4862,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/guance-integration-guide"
|
|
|
4868
4862
|
| 数据断档 | Info | 提醒 |
|
|
4869
4863
|
|
|
4870
4864
|
</div>
|
|
4871
|
-
`,
|
|
4865
|
+
`,H=`---
|
|
4872
4866
|
title: "zilliz 告警事件"
|
|
4873
4867
|
description: "通过 webhook 的方式同步 zilliz 告警事件到 Flashduty，实现告警事件自动化降噪处理"
|
|
4874
4868
|
date: "2024-07-05T10:00:00+08:00"
|
|
@@ -4943,7 +4937,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/zilliz-integration-guide"
|
|
|
4943
4937
|
|
|
4944
4938
|
</div>
|
|
4945
4939
|
|
|
4946
|
-
`,
|
|
4940
|
+
`,O=`---
|
|
4947
4941
|
title: "华为云 APM 告警事件"
|
|
4948
4942
|
description: "通过 webhook 的方式同步华为云 APM 告警事件到 Flashduty，实现告警事件自动化降噪处理"
|
|
4949
4943
|
date: "2024-07-05T10:00:00+08:00"
|
|
@@ -4998,14 +4992,14 @@ url: "https://docs.flashcat.cloud/zh/flashduty/huawei-apm-integration-guide"
|
|
|
4998
4992
|
|
|
4999
4993
|
## 一、华为云 APM 告警推送配置
|
|
5000
4994
|
|
|
5001
|
-
### 创建
|
|
4995
|
+
### 创建 Flashduty 告警通道
|
|
5002
4996
|
1. 登录您的华为云控制台，检索 \`SMN\` 消息通知服务产品，并进入对应产品控制台。
|
|
5003
4997
|
2. 在左侧导航栏选择 \`主题管理=>主题\`。
|
|
5004
|
-
3. 点击 \`创建主题\`，在编辑页面中的主题名称处输入 \`
|
|
4998
|
+
3. 点击 \`创建主题\`，在编辑页面中的主题名称处输入 \`Flashduty\` 并点击确认。
|
|
5005
4999
|
|
|
5006
5000
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/huawei-lts-1.png" />
|
|
5007
5001
|
|
|
5008
|
-
4. 回到主题列表后，在刚创建的
|
|
5002
|
+
4. 回到主题列表后，在刚创建的 Flashduty 主题中点击 \`添加订阅\`。
|
|
5009
5003
|
|
|
5010
5004
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/huawei-lts-2.png" />
|
|
5011
5005
|
|
|
@@ -5021,7 +5015,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/huawei-apm-integration-guide"
|
|
|
5021
5015
|
|
|
5022
5016
|
#### 步骤1：添加通知配置
|
|
5023
5017
|
1. 登录您的 \`华为云 APM\` 控制台，在 \`应用监控=>指标\` 中，点击 \`通知配置\`。
|
|
5024
|
-
2. 选择对应的区域后，点击 \`新增\`，在主题处选择已创建的 \`
|
|
5018
|
+
2. 选择对应的区域后，点击 \`新增\`，在主题处选择已创建的 \`Flashduty\` 主题。
|
|
5025
5019
|
3. 点击 \`确认\` 完成配置。
|
|
5026
5020
|
|
|
5027
5021
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/zh/hw/hw-apm-1.png" />
|
|
@@ -5031,7 +5025,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/huawei-apm-integration-guide"
|
|
|
5031
5025
|
2. 选择 \`告警策略\`，点击 \`新增自定义告警策略\` 或编辑已有的告警策略。
|
|
5032
5026
|
3. 在 \`告警策略\` 编辑页面中，告警指标、告警条件等请按业务需要进行配置。
|
|
5033
5027
|
4. \`告警内容\` 中在引用变量时，建议以K:V的格式进行配置，便于后续告警事件的解析，比如 host:\${hostInfo}。
|
|
5034
|
-
5. \`通知对象\` 中选择已创建的 \`
|
|
5028
|
+
5. \`通知对象\` 中选择已创建的 \`Flashduty\` 通知渠道。
|
|
5035
5029
|
6. 点击 \`确认\` 完成配置。
|
|
5036
5030
|
|
|
5037
5031
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/zh/hw/hw-apm-2.png" />
|
|
@@ -5051,7 +5045,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/huawei-apm-integration-guide"
|
|
|
5051
5045
|
|
|
5052
5046
|
</div>
|
|
5053
5047
|
|
|
5054
|
-
`,
|
|
5048
|
+
`,j=`---
|
|
5055
5049
|
title: "zstack 告警事件"
|
|
5056
5050
|
description: "通过 webhook 的方式同步 zstack 告警事件到 Flashduty，实现告警事件自动化降噪处理"
|
|
5057
5051
|
date: "2024-07-05T10:00:00+08:00"
|
|
@@ -5140,7 +5134,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/zstack-integration-guide"
|
|
|
5140
5134
|
|
|
5141
5135
|
</div>
|
|
5142
5136
|
|
|
5143
|
-
`,
|
|
5137
|
+
`,q=`---
|
|
5144
5138
|
title: "Keep 告警集成指引"
|
|
5145
5139
|
description: "通过 Keep 的 Provider 将告警事件推送到 Flashduty，实现告警事件自动化降噪处理。"
|
|
5146
5140
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -5221,7 +5215,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/keep-alert-integration-guide"
|
|
|
5221
5215
|
|
|
5222
5216
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/en/fd/keep-2.png" />
|
|
5223
5217
|
|
|
5224
|
-
`,
|
|
5218
|
+
`,V=`---
|
|
5225
5219
|
title: "ElastAlert2 告警集成指引"
|
|
5226
5220
|
description: "通过 ElastAlert2 的 Provider 将告警事件推送到 Flashduty，实现告警事件自动化降噪处理。"
|
|
5227
5221
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -5272,7 +5266,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/elastalert2-alert-integration-gui
|
|
|
5272
5266
|
---
|
|
5273
5267
|
|
|
5274
5268
|
### 配置 ElastAlert 2 告警
|
|
5275
|
-
遵循 [ElastAlert
|
|
5269
|
+
遵循 [ElastAlert Flashduty](https://elastalert2.readthedocs.io/en/latest/alerts.html#flashduty) 推送配置文档
|
|
5276
5270
|
|
|
5277
5271
|
1. 创建或编辑告警规则文件，例如 \`rules/elastalert2_alert.yaml\`。
|
|
5278
5272
|
2. 在 \`alert\` 字段中填写 \`flashduty\` 告警类型。
|
|
@@ -5324,7 +5318,7 @@ filter:
|
|
|
5324
5318
|
query_string:
|
|
5325
5319
|
query: "created_at:*"
|
|
5326
5320
|
|
|
5327
|
-
# -------
|
|
5321
|
+
# ------- Flashduty ----------------
|
|
5328
5322
|
alert: flashduty
|
|
5329
5323
|
flashduty_integration_key: "xxxx"
|
|
5330
5324
|
flashduty_title: "elastalert2 告警"
|
|
@@ -5339,10 +5333,10 @@ flashduty_group: "group1"
|
|
|
5339
5333
|
flashduty_cluster: "bj"
|
|
5340
5334
|
flashduty_app: "app1 "
|
|
5341
5335
|
flashduty_env: "dev"
|
|
5342
|
-
# -------
|
|
5336
|
+
# ------- Flashduty ----------------
|
|
5343
5337
|
\`\`\`
|
|
5344
5338
|
|
|
5345
|
-
5.重启 ElastAlert，等待告警触发。`,
|
|
5339
|
+
5.重启 ElastAlert，等待告警触发。`,B=`---
|
|
5346
5340
|
title: "钉钉告警集成"
|
|
5347
5341
|
description: "在 Flashduty 生成唯一的钉钉机器人地址，通过钉钉的方式将告警的发生与恢复同步到 Flashduty"
|
|
5348
5342
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -5423,7 +5417,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/dingtalk-alert-integration-guide"
|
|
|
5423
5417
|
## 严重程度映射关系
|
|
5424
5418
|
---
|
|
5425
5419
|
|
|
5426
|
-
当前钉钉告警集成推送到 Flashduty 的严重程度均为Warning，但您可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/
|
|
5420
|
+
当前钉钉告警集成推送到 Flashduty 的严重程度均为Warning，但您可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/on-call/integration/alert-integration/alert-pipelines) 来自定义严重程度。
|
|
5427
5421
|
|
|
5428
5422
|
`,G=`---
|
|
5429
5423
|
title: "飞书告警集成"
|
|
@@ -5506,9 +5500,9 @@ url: "https://docs.flashcat.cloud/zh/flashduty/feishu-alert-integration-guide"
|
|
|
5506
5500
|
## 严重程度映射关系
|
|
5507
5501
|
---
|
|
5508
5502
|
|
|
5509
|
-
当前飞书告警集成推送到 Flashduty 的严重程度均为 Warning，但您可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/
|
|
5503
|
+
当前飞书告警集成推送到 Flashduty 的严重程度均为 Warning，但您可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/on-call/integration/alert-integration/alert-pipelines) 来自定义严重程度。
|
|
5510
5504
|
|
|
5511
|
-
`,
|
|
5505
|
+
`,K=`---
|
|
5512
5506
|
title: "火山引擎云拨测告警事件"
|
|
5513
5507
|
description: "通过 webhook 的方式同步 火山引擎云拨测的告警事件到 Flashduty，实现告警事件自动化降噪处理"
|
|
5514
5508
|
date: "2024-07-05T10:00:00+08:00"
|
|
@@ -5595,7 +5589,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-detect-integration-gui
|
|
|
5595
5589
|
|
|
5596
5590
|
</div>
|
|
5597
5591
|
|
|
5598
|
-
`,
|
|
5592
|
+
`,J=`---
|
|
5599
5593
|
title: "Monit 告警集成"
|
|
5600
5594
|
description: "Flashduty Monit 告警集成，Monit 服务通过此集成上报告警"
|
|
5601
5595
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -5633,7 +5627,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/rum-alert-integration-guide"
|
|
|
5633
5627
|
|
|
5634
5628
|
|
|
5635
5629
|
|
|
5636
|
-
更多内容，请您参考 [RUM Issue 告警](https://docs.flashcat.cloud/zh/flashduty/rum/issue-alerting)。`,
|
|
5630
|
+
更多内容，请您参考 [RUM Issue 告警](https://docs.flashcat.cloud/zh/flashduty/rum/issue-alerting)。`,X=`---
|
|
5637
5631
|
title: "Cloudflare 告警事件"
|
|
5638
5632
|
description: "通过 webhook 的方式同步 Cloudflare 告警事件到 Flashduty，实现告警事件自动化降噪处理"
|
|
5639
5633
|
date: "2024-07-05T10:00:00+08:00"
|
|
@@ -5699,11 +5693,11 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-detect-integration-gui
|
|
|
5699
5693
|
|
|
5700
5694
|
<div class="md-block">
|
|
5701
5695
|
|
|
5702
|
-
当前 Cloudflare 集成推送到 Flashduty 的告警等级均为 Warning，但您可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/
|
|
5696
|
+
当前 Cloudflare 集成推送到 Flashduty 的告警等级均为 Warning，但您可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/on-call/integration/alert-integration/alert-pipelines) 来自定义严重程度。
|
|
5703
5697
|
|
|
5704
5698
|
</div>
|
|
5705
5699
|
|
|
5706
|
-
`,
|
|
5700
|
+
`,Y=`---
|
|
5707
5701
|
title: "企微告警集成"
|
|
5708
5702
|
description: "在 Flashduty 生成唯一的企微机器人地址，通过企微的方式将告警的发生与恢复同步到 Flashduty"
|
|
5709
5703
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -5778,196 +5772,866 @@ url: "https://docs.flashcat.cloud/zh/flashduty/wecom-alert-integration-guide"
|
|
|
5778
5772
|
|
|
5779
5773
|
### 注意事项
|
|
5780
5774
|
- 企微告警集成地址仅支持接收 Text、Markdown 消息类型，其他消息无法接收。
|
|
5781
|
-
- Flashduty 会生成默认告警标题： “企微机器人告警”，如果您需要更改标题，可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/
|
|
5775
|
+
- Flashduty 会生成默认告警标题： “企微机器人告警”，如果您需要更改标题，可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/on-call/integration/alert-integration/alert-pipelines) 来自定义标题。
|
|
5782
5776
|
|
|
5783
5777
|
## 严重程度映射关系
|
|
5784
5778
|
---
|
|
5785
5779
|
|
|
5786
|
-
当前企微告警集成推送到 Flashduty 的严重程度均为Warning，但您可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/
|
|
5787
|
-
title: "
|
|
5788
|
-
description: "
|
|
5780
|
+
当前企微告警集成推送到 Flashduty 的严重程度均为Warning，但您可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/on-call/integration/alert-integration/alert-pipelines) 来自定义严重程度。`,Q=`---
|
|
5781
|
+
title: "Harbor 告警集成"
|
|
5782
|
+
description: "通过 webhook 的方式同步 Harbor 的告警事件到 Flashduty，实现告警事件自动化降噪处理"
|
|
5789
5783
|
date: "2025-05-19T10:00:00+08:00"
|
|
5790
|
-
url: "https://docs.flashcat.cloud/zh/flashduty/
|
|
5784
|
+
url: "https://docs.flashcat.cloud/zh/flashduty/harboe-integration-guide"
|
|
5791
5785
|
---
|
|
5792
5786
|
|
|
5793
|
-
|
|
5787
|
+
通过 webhook 的方式同步 Harbor 的告警事件到 Flashduty，实现告警事件自动化降噪处理。
|
|
5794
5788
|
|
|
5795
|
-
|
|
5796
|
-
Flashduty 已经适配部分常用工单、部署系统的 webhook 协议，对于这些系统您应该首先使用对应的集成，更加简单方便。本集成提供了一个标准的 HTTP 接口，需要允许您开发适配。好处是您可以与任何部署系统集成。
|
|
5797
|
-
:::
|
|
5789
|
+
<div class="hide">
|
|
5798
5790
|
|
|
5799
|
-
##
|
|
5791
|
+
## 在 Flashduty
|
|
5800
5792
|
---
|
|
5801
5793
|
|
|
5802
|
-
###
|
|
5803
|
-
|
|
5804
|
-
1. 进入 Flashduty 控制台，选择 **集成中心=>变更事件**，进入集成选择页面。
|
|
5805
|
-
2. 选择 **自定义事件** 集成：
|
|
5806
|
-
- **集成名称**：为当前集成定义一个名称。
|
|
5807
|
-
3. 点击 **保存** 后，复制当前页面的新生成的 **推送地址** 备用。
|
|
5808
|
-
4. 完成。
|
|
5809
|
-
|
|
5810
|
-
|
|
5811
|
-
## 实现协议
|
|
5812
|
-
---
|
|
5813
|
-
|
|
5814
|
-
请您参照 [开发文档](https://developer.flashcat.cloud/zh/flashduty/event-api/change-event) 完成协议开发。
|
|
5794
|
+
### 创建 Harbor 告警集成
|
|
5815
5795
|
|
|
5816
|
-
|
|
5817
|
-
---
|
|
5796
|
+
您可通过以下2种方式，获取一个企微机器人告警集成地址，任选其一即可。
|
|
5818
5797
|
|
|
5819
|
-
|
|
5820
|
-
1. 变更的应用范围，如 host，cluster 等
|
|
5821
|
-
1. 变更的归属信息，如 team，owner 等
|
|
5798
|
+
#### 使用专属集成
|
|
5822
5799
|
|
|
5823
|
-
|
|
5824
|
-
---
|
|
5800
|
+
当您不需要将告警事件路由到不同的协作空间，优先选择此方式，更简单。
|
|
5825
5801
|
|
|
5826
5802
|
<details>
|
|
5827
|
-
<summary
|
|
5828
|
-
|
|
5829
|
-
#### 在 Flashduty
|
|
5803
|
+
<summary>展开</summary>
|
|
5830
5804
|
|
|
5831
|
-
1.
|
|
5805
|
+
1. 进入 Flashduty 控制台，选择 **协作空间**，进入某个空间的详情页面
|
|
5806
|
+
2. 选择 **集成数据** tab，点击 **添加一个集成**，进入添加集成页面
|
|
5807
|
+
3. 选择 **Harbor** 集成，点击 **保存**，生成卡片。
|
|
5808
|
+
4. 点击生成的卡片，可以查看到 **Harbor 告警集成地址**，复制备用，完成。
|
|
5809
|
+
|
|
5810
|
+
</details>
|
|
5832
5811
|
|
|
5833
|
-
|
|
5812
|
+
#### 使用共享集成
|
|
5834
5813
|
|
|
5835
|
-
|
|
5836
|
-
2. 确认您的服务可以访问外网 api.flashcat.cloud 域名。如果不可以，您首先需要为 server 开通外网，或单独针对 Flashduty 的域名开通外网访问。
|
|
5837
|
-
3. 打印 Flashduty 服务的响应结果，查看是否有明确信息。
|
|
5814
|
+
当您需要根据告警事件的 Payload 信息，将告警路由到不同的协作空间，优先选择此方式。
|
|
5838
5815
|
|
|
5839
|
-
|
|
5816
|
+
<details>
|
|
5817
|
+
<summary>展开</summary>
|
|
5818
|
+
|
|
5819
|
+
1. 进入 Flashduty 控制台，选择 **集成中心=>告警事件**，进入集成选择页面。
|
|
5820
|
+
2. 选择 **Harbor** 集成：
|
|
5821
|
+
- **集成名称**：为当前集成定义一个名称。
|
|
5822
|
+
- **推送模式**：选择企微告警在何种情况下触发或恢复告警。
|
|
5823
|
+
3. 复制当前页面的 **Harbor 告警集成地址** 备用。
|
|
5824
|
+
4. 配置默认路由，并选择对应的协作空间（集成创建后可以前往 \`路由\` 进行更多路由规则的配置）。
|
|
5825
|
+
5. 完成。
|
|
5840
5826
|
|
|
5841
5827
|
</details>
|
|
5842
5828
|
|
|
5843
|
-
|
|
5844
|
-
title: "Jira 事件集成指引"
|
|
5845
|
-
description: "通过 webhook 的方式同步 Jira Issue 事件到 Flashduty，实现变更事件收集。"
|
|
5846
|
-
date: "2025-05-19T10:00:00+08:00"
|
|
5847
|
-
url: "https://docs.flashcat.cloud/zh/flashduty/jira-integration-guide"
|
|
5829
|
+
## 在 Harbor
|
|
5848
5830
|
---
|
|
5831
|
+
</div>
|
|
5849
5832
|
|
|
5850
|
-
通过 webhook 的方式同步 Jira Issue 事件到 Flashduty，实现变更事件收集。
|
|
5851
5833
|
|
|
5852
|
-
|
|
5853
|
-
---
|
|
5834
|
+
### 配置 Webhook 通道
|
|
5854
5835
|
|
|
5855
|
-
|
|
5836
|
+
1. 使用至少具有项目管理员权限的帐户登录 Harbor 界面。
|
|
5837
|
+
2. 转到\`项目\`，选择一个项目，然后选择 \`Webhook\`。
|
|
5838
|
+
3. 选择通知类型 \`HTTP\`，以便 webhook 将发送到 HTTP 端点。
|
|
5839
|
+
4. 当选择 HTTP 通知类型时，选择有效负载格式为 \`Default 或 CloudEvents\`。
|
|
5840
|
+
5. 选择您要\`订阅的事件\`。
|
|
5841
|
+
6. \`Endpoint URL\` 输入告警集成的<span class='integration_url'>推送地址</span>。
|
|
5842
|
+
7. 单击 添加 以创建 webhook。
|
|
5856
5843
|
|
|
5857
|
-
|
|
5858
|
-
|
|
5844
|
+
## 严重程度映射关系
|
|
5845
|
+
---
|
|
5859
5846
|
|
|
5860
|
-
|
|
5847
|
+
当前 Harbor 告警集成推送到 Flashduty 的严重程度均为 Warning，但您可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/on-call/integration/alert-integration/alert-pipelines) 来自定义严重程度。`,nn=`---
|
|
5848
|
+
title: "火山引擎 RTC 告警集成"
|
|
5849
|
+
description: "通过 webhook 的方式同步火山引擎 RTC 的告警事件到 Flashduty，实现告警事件自动化降噪处理"
|
|
5850
|
+
date: "2025-05-19T10:00:00+08:00"
|
|
5851
|
+
url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-rtc-integration-guide"
|
|
5861
5852
|
---
|
|
5862
5853
|
|
|
5863
|
-
|
|
5854
|
+
通过 webhook 的方式同步火山引擎 RTC 的告警事件到 Flashduty，实现告警事件自动化降噪处理。
|
|
5864
5855
|
|
|
5865
|
-
|
|
5856
|
+
<div class="hide">
|
|
5857
|
+
|
|
5858
|
+
## 在 Flashduty
|
|
5866
5859
|
---
|
|
5867
5860
|
|
|
5868
|
-
###
|
|
5861
|
+
### 创建火山引擎 RTC 告警集成
|
|
5869
5862
|
|
|
5870
|
-
|
|
5871
|
-
2. 选择 **Jira** 集成：
|
|
5872
|
-
- **集成名称**：为当前集成定义一个名称。
|
|
5873
|
-
3. 点击 **保存** 后，复制当前页面的新生成的 **推送地址** 备用。
|
|
5874
|
-
4. 完成。
|
|
5863
|
+
您可通过以下2种方式，获取一个企微机器人告警集成地址，任选其一即可。
|
|
5875
5864
|
|
|
5876
|
-
|
|
5865
|
+
#### 使用专属集成
|
|
5877
5866
|
|
|
5878
|
-
|
|
5867
|
+
当您不需要将告警事件路由到不同的协作空间，优先选择此方式，更简单。
|
|
5879
5868
|
|
|
5880
|
-
|
|
5881
|
-
|
|
5882
|
-
|
|
5883
|
-
|
|
5884
|
-
|
|
5869
|
+
<details>
|
|
5870
|
+
<summary>展开</summary>
|
|
5871
|
+
|
|
5872
|
+
1. 进入 Flashduty 控制台，选择 **协作空间**，进入某个空间的详情页面
|
|
5873
|
+
2. 选择 **集成数据** tab，点击 **添加一个集成**，进入添加集成页面
|
|
5874
|
+
3. 选择 **火山引擎 RTC** 集成，点击 **保存**，生成卡片。
|
|
5875
|
+
4. 点击生成的卡片，可以查看到 **火山引擎 RTC 告警集成地址**，复制备用，完成。
|
|
5876
|
+
|
|
5877
|
+
</details>
|
|
5885
5878
|
|
|
5886
|
-
|
|
5879
|
+
#### 使用共享集成
|
|
5887
5880
|
|
|
5888
|
-
|
|
5881
|
+
当您需要根据告警事件的 Payload 信息，将告警路由到不同的协作空间，优先选择此方式。
|
|
5889
5882
|
|
|
5890
|
-
|
|
5883
|
+
<details>
|
|
5884
|
+
<summary>展开</summary>
|
|
5885
|
+
|
|
5886
|
+
1. 进入 Flashduty 控制台，选择 **集成中心=>告警事件**，进入集成选择页面。
|
|
5887
|
+
2. 选择 **火山引擎 RTC** 集成：
|
|
5888
|
+
- **集成名称**：为当前集成定义一个名称。
|
|
5889
|
+
- **推送模式**：选择企微告警在何种情况下触发或恢复告警。
|
|
5890
|
+
3. 复制当前页面的 **火山引擎 RTC 告警集成地址** 备用。
|
|
5891
|
+
4. 配置默认路由，并选择对应的协作空间（集成创建后可以前往 \`路由\` 进行更多路由规则的配置）。
|
|
5892
|
+
5. 完成。
|
|
5893
|
+
|
|
5894
|
+
</details>
|
|
5891
5895
|
|
|
5892
|
-
##
|
|
5896
|
+
## 在火山引擎
|
|
5893
5897
|
---
|
|
5898
|
+
</div>
|
|
5894
5899
|
|
|
5895
|
-
<div class="md-block">
|
|
5896
|
-
|
|
5897
|
-
Flashduty 默认提取 webhook payload 中 status.name 信息，并按照下边的映射关系进行状态转换：
|
|
5898
5900
|
|
|
5899
|
-
|
|
5900
|
-
| ----------- | ---------- | ------------------ |
|
|
5901
|
-
| planned | planned | 已提单 |
|
|
5902
|
-
| to do | planned | 已提单 |
|
|
5903
|
-
| ready | ready | 即将（或计划）开始 |
|
|
5904
|
-
| processing | processing | 进行中 |
|
|
5905
|
-
| open | processing | 进行中 |
|
|
5906
|
-
| reopen | processing | 进行中 |
|
|
5907
|
-
| in progress | processing | 进行中 |
|
|
5908
|
-
| canceled | canceled | 已取消（或回滚） |
|
|
5909
|
-
| aborted | canceled | 已取消（或回滚） |
|
|
5910
|
-
| done | done | 已完成 |
|
|
5911
|
-
| resolved | done | 已完成 |
|
|
5912
|
-
| closed | done | 已完成 |
|
|
5901
|
+
### 配置告警规则
|
|
5913
5902
|
|
|
5914
|
-
|
|
5903
|
+
1. 登录您的火山引擎控制台，检索 \`实时音视频\` 产品，并进入对应产品控制台。
|
|
5904
|
+
2. 在左侧菜单中选择 \`监控台->告警通知\`，并转到 \`告警规则\` 页面。
|
|
5905
|
+
3. 创建或编辑告警规则，在规则页面中勾选 \`告警回调\` 并输入告警集成的<span class='integration_url'>推送地址</span>。
|
|
5906
|
+
4. 其他选项按需配置。
|
|
5907
|
+
5. 点击 \`确定\` 完成配置。
|
|
5915
5908
|
|
|
5916
|
-
|
|
5917
|
-
|
|
5918
|
-
|
|
5919
|
-
|
|
5909
|
+
|
|
5910
|
+
|
|
5911
|
+
## 严重程度映射关系
|
|
5912
|
+
---
|
|
5913
|
+
|火山引擎RTC| Flashduty|状态|
|
|
5914
|
+
|---|---|---|
|
|
5915
|
+
|严重|Critical|严重|
|
|
5916
|
+
|警告|Warning|警告|
|
|
5917
|
+
|通知|Info|提醒|
|
|
5918
|
+
|
|
5919
|
+
您可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/on-call/integration/alert-integration/alert-pipelines) 来自定义严重程度。`,tn=`---
|
|
5920
|
+
title: "Ucloud CloudWatch 告警集成"
|
|
5921
|
+
description: "通过 webhook 的方式同步 Ucloud CloudWatch 的告警事件到 Flashduty，实现告警事件自动化降噪处理"
|
|
5920
5922
|
date: "2025-05-19T10:00:00+08:00"
|
|
5921
|
-
url: "https://docs.flashcat.cloud/zh/flashduty/
|
|
5923
|
+
url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-rtc-integration-guide"
|
|
5922
5924
|
---
|
|
5923
|
-
通过集成飞书自建应用，您可以在飞书端内接收和响应告警。
|
|
5924
5925
|
|
|
5925
|
-
|
|
5926
|
+
通过 webhook 的方式同步 Ucloud CloudWatch 的告警事件到 Flashduty，实现告警事件自动化降噪处理。
|
|
5926
5927
|
|
|
5927
|
-
|
|
5928
|
-
---
|
|
5929
|
-
<Video src="https://download.flashcat.cloud/flashduty/video/feishu.mp4"></Video>
|
|
5930
|
-
</div>
|
|
5928
|
+
<div class="hide">
|
|
5931
5929
|
|
|
5932
|
-
##
|
|
5930
|
+
## 在 Flashduty
|
|
5933
5931
|
---
|
|
5934
5932
|
|
|
5935
|
-
###
|
|
5933
|
+
### 创建 Ucloud CloudWatch 告警集成
|
|
5936
5934
|
|
|
5937
|
-
|
|
5935
|
+
您可通过以下2种方式，获取一个企微机器人告警集成地址，任选其一即可。
|
|
5938
5936
|
|
|
5939
|
-
|
|
5937
|
+
#### 使用专属集成
|
|
5940
5938
|
|
|
5941
|
-
|
|
5939
|
+
当您不需要将告警事件路由到不同的协作空间，优先选择此方式，更简单。
|
|
5942
5940
|
|
|
5943
|
-
|
|
5941
|
+
<details>
|
|
5942
|
+
<summary>展开</summary>
|
|
5943
|
+
|
|
5944
|
+
1. 进入 Flashduty 控制台，选择 **协作空间**，进入某个空间的详情页面
|
|
5945
|
+
2. 选择 **集成数据** tab，点击 **添加一个集成**，进入添加集成页面
|
|
5946
|
+
3. 选择 **Ucloud CloudWatch** 集成，点击 **保存**，生成卡片。
|
|
5947
|
+
4. 点击生成的卡片，可以查看到 **火山引擎 RTC 告警集成地址**，复制备用，完成。
|
|
5948
|
+
|
|
5949
|
+
</details>
|
|
5944
5950
|
|
|
5945
|
-
|
|
5951
|
+
#### 使用共享集成
|
|
5946
5952
|
|
|
5953
|
+
当您需要根据告警事件的 Payload 信息，将告警路由到不同的协作空间，优先选择此方式。
|
|
5947
5954
|
|
|
5948
|
-
|
|
5955
|
+
<details>
|
|
5956
|
+
<summary>展开</summary>
|
|
5957
|
+
|
|
5958
|
+
1. 进入 Flashduty 控制台，选择 **集成中心=>告警事件**，进入集成选择页面。
|
|
5959
|
+
2. 选择 **Ucloud CloudWatch** 集成：
|
|
5960
|
+
- **集成名称**：为当前集成定义一个名称。
|
|
5961
|
+
- **推送模式**：选择企微告警在何种情况下触发或恢复告警。
|
|
5962
|
+
3. 复制当前页面的 **Ucloud CloudWatch 告警集成地址** 备用。
|
|
5963
|
+
4. 配置默认路由，并选择对应的协作空间（集成创建后可以前往 \`路由\` 进行更多路由规则的配置）。
|
|
5964
|
+
5. 完成。
|
|
5965
|
+
|
|
5966
|
+
</details>
|
|
5949
5967
|
|
|
5950
|
-
|
|
5968
|
+
## 在 Ucloud
|
|
5969
|
+
---
|
|
5970
|
+
</div>
|
|
5951
5971
|
|
|
5952
|
-
前往 开发配置 → 事件与回调 → **加密策略** 页面，生成并复制 \`Encrypt Key\`（推荐启用，更安全）和 \`Verification Token\` 备用。
|
|
5953
5972
|
|
|
5954
|
-
|
|
5973
|
+
### 步骤1：配置通知模版
|
|
5955
5974
|
|
|
5956
|
-
|
|
5957
|
-
|
|
5975
|
+
1. 登录您的 Ucloud 控制台，检索 \`CloudWatch\` 产品，并进入对应产品控制台。
|
|
5976
|
+
2. 在菜单中选择 \`通知管理\`，并转到 \`通知模版\` 页面。
|
|
5977
|
+
3. 创建或编辑通知模版，在模版页面中勾选 \`接口回调\`。
|
|
5978
|
+
4. **回调语言**选择 \`英文\`，输入框中输入告警集成的<span class='integration_url'>推送地址</span>。
|
|
5979
|
+
5. 模版名称输入 \`Flashduty\` 或其他。
|
|
5980
|
+
6. 其他选项按需配置。
|
|
5981
|
+
7. 点击 \`提交\` 完成配置。
|
|
5958
5982
|
|
|
5959
|
-
|
|
5983
|
+
|
|
5960
5984
|
|
|
5961
|
-
|
|
5985
|
+
### 步骤2：配置告警策略
|
|
5986
|
+
1. 登录您的 Ucloud 控制台，检索 \`CloudWatch\` 产品，并进入对应产品控制台。
|
|
5987
|
+
2. 在菜单中选择 \`告警管理\`，并转到 \`告警策略\` 页面。
|
|
5988
|
+
3. 新建或编辑告警策略，找到策略配置页面的**通知设置**，选择**步骤1** 创建的通知模版。
|
|
5989
|
+
4. 其他选项按需配置。
|
|
5990
|
+
5. 点击 \`提交\` 完成配置。
|
|
5962
5991
|
|
|
5963
|
-
|
|
5964
5992
|
|
|
5965
|
-
##
|
|
5993
|
+
## 严重程度映射关系
|
|
5994
|
+
---
|
|
5995
|
+
当前 Ucloud CloudWatch 告警集成推送到 Flashduty 的严重程度均为 Warning，但您可以通过[告警处理 Pipeline](/zh/on-call/integration/alert-integration/alert-pipelines) 来自定义严重程度。`,en=`---
|
|
5996
|
+
title: "Nagios 告警集成"
|
|
5997
|
+
description: "通过 webhook 的方式同步 Nagios 告警事件到 Flashduty，实现告警事件自动化降噪处理"
|
|
5998
|
+
date: "2025-05-19T10:00:00+08:00"
|
|
5999
|
+
url: "https://docs.flashcat.cloud/zh/flashduty/nagios-integration-guide"
|
|
5966
6000
|
---
|
|
5967
6001
|
|
|
5968
|
-
|
|
6002
|
+
通过 webhook 的方式同步 Nagios 告警事件到 Flashduty，实现告警事件自动化降噪处理。
|
|
5969
6003
|
|
|
5970
|
-
|
|
6004
|
+
<div class="hide">
|
|
6005
|
+
|
|
6006
|
+
## 在 Flashduty
|
|
6007
|
+
---
|
|
6008
|
+
您可通过以下2种方式，获取一个集成推送地址，任选其一即可。
|
|
6009
|
+
|
|
6010
|
+
### 使用专属集成
|
|
6011
|
+
|
|
6012
|
+
当您不需要将告警事件路由到不同的协作空间，优先选择此方式，更简单。
|
|
6013
|
+
|
|
6014
|
+
<details>
|
|
6015
|
+
<summary>展开</summary>
|
|
6016
|
+
|
|
6017
|
+
1. 进入 Flashduty 控制台，选择 **协作空间**，进入某个空间的详情页面
|
|
6018
|
+
2. 选择 **集成数据** tab，点击 **添加一个集成**，进入添加集成页面
|
|
6019
|
+
3. 选择 **Nagios** 集成，点击 **保存**，生成卡片。
|
|
6020
|
+
4. 点击生成的卡片，可以查看到 **推送地址**，复制备用，完成。
|
|
6021
|
+
|
|
6022
|
+
|
|
6023
|
+
</details>
|
|
6024
|
+
|
|
6025
|
+
### 使用共享集成
|
|
6026
|
+
|
|
6027
|
+
当您需要根据告警事件的 Payload 信息，将告警路由到不同的协作空间，优先选择此方式。
|
|
6028
|
+
|
|
6029
|
+
<details>
|
|
6030
|
+
<summary>展开</summary>
|
|
6031
|
+
|
|
6032
|
+
1. 进入 Flashduty 控制台，选择 **集成中心=>告警事件**，进入集成选择页面。
|
|
6033
|
+
2. 选择 **Nagios** 集成：
|
|
6034
|
+
- **集成名称**：为当前集成定义一个名称。
|
|
6035
|
+
3. 配置默认路由，并选择对应的协作空间（集成创建后可以前往 \`路由\` 进行更多路由规则的配置）。
|
|
6036
|
+
4. 点击 **保存** 后，复制当前页面的新生成的 **推送地址** 备用。
|
|
6037
|
+
5. 完成。
|
|
6038
|
+
|
|
6039
|
+
</details>
|
|
6040
|
+
|
|
6041
|
+
</div>
|
|
6042
|
+
|
|
6043
|
+
## 在 Nagios
|
|
6044
|
+
---
|
|
6045
|
+
|
|
6046
|
+
不同的系统和安装方式，Nagios 的安装路径可能不同，请根据实际情况调整以下配置中的路径。
|
|
6047
|
+
|
|
6048
|
+
### 步骤 1：下载通知脚本
|
|
6049
|
+
|
|
6050
|
+
<div class="md-block">
|
|
6051
|
+
|
|
6052
|
+
登录 Nagios Server 所在服务器，下载通知脚本到 Nagios 插件目录：
|
|
6053
|
+
|
|
6054
|
+
- **Debian/Ubuntu 系统**（通常为 \`/usr/lib/nagios/plugins/\`）：
|
|
6055
|
+
|
|
6056
|
+
\`\`\`bash
|
|
6057
|
+
cd /usr/lib/nagios/plugins/
|
|
6058
|
+
wget --header="Referer: https://console.flashcat.cloud" https://download.flashcat.cloud/flashduty/integration/nagios/send_to_flashduty.sh
|
|
6059
|
+
chmod +x send_to_flashduty.sh
|
|
6060
|
+
\`\`\`
|
|
6061
|
+
|
|
6062
|
+
- **RHEL/CentOS 系统**（通常为 \`/usr/lib64/nagios/plugins/\`）：
|
|
6063
|
+
|
|
6064
|
+
\`\`\`bash
|
|
6065
|
+
cd /usr/lib64/nagios/plugins/
|
|
6066
|
+
wget --header="Referer: https://console.flashcat.cloud" https://download.flashcat.cloud/flashduty/integration/nagios/send_to_flashduty.sh
|
|
6067
|
+
chmod +x send_to_flashduty.sh
|
|
6068
|
+
\`\`\`
|
|
6069
|
+
|
|
6070
|
+
- **源码安装**（通常为 \`/usr/local/nagios/libexec/\`）：
|
|
6071
|
+
|
|
6072
|
+
\`\`\`bash
|
|
6073
|
+
cd /usr/local/nagios/libexec/
|
|
6074
|
+
wget --header="Referer: https://console.flashcat.cloud" https://download.flashcat.cloud/flashduty/integration/nagios/send_to_flashduty.sh
|
|
6075
|
+
chmod +x send_to_flashduty.sh
|
|
6076
|
+
\`\`\`
|
|
6077
|
+
|
|
6078
|
+
#### 注意： 脚本中使用了 \`curl\` 命令，请确保 Nagios Server 上已安装 curl。
|
|
6079
|
+
|
|
6080
|
+
</div>
|
|
6081
|
+
|
|
6082
|
+
### 步骤 2：创建 Flashduty 配置文件
|
|
6083
|
+
|
|
6084
|
+
<div class="md-block">
|
|
6085
|
+
|
|
6086
|
+
下载 Flashduty 配置文件到 Nagios 配置目录：
|
|
6087
|
+
|
|
6088
|
+
- **Debian/Ubuntu 系统**（通常为 \`/etc/nagios3/conf.d/\`）：
|
|
6089
|
+
|
|
6090
|
+
\`\`\`bash
|
|
6091
|
+
cd /etc/nagios3/conf.d/
|
|
6092
|
+
wget --header="Referer: https://console.flashcat.cloud" https://download.flashcat.cloud/flashduty/integration/nagios/flashduty.cfg
|
|
6093
|
+
\`\`\`
|
|
6094
|
+
|
|
6095
|
+
- **RHEL/CentOS 系统**（通常为 \`/etc/nagios/objects/\`）：
|
|
6096
|
+
|
|
6097
|
+
\`\`\`bash
|
|
6098
|
+
cd /etc/nagios/objects/
|
|
6099
|
+
wget --header="Referer: https://console.flashcat.cloud" https://download.flashcat.cloud/flashduty/integration/nagios/flashduty.cfg
|
|
6100
|
+
\`\`\`
|
|
6101
|
+
|
|
6102
|
+
- **源码安装**（通常为 \`/usr/local/nagios/etc/objects/\`）：
|
|
6103
|
+
|
|
6104
|
+
\`\`\`bash
|
|
6105
|
+
cd /usr/local/nagios/etc/objects/
|
|
6106
|
+
wget --header="Referer: https://console.flashcat.cloud" https://download.flashcat.cloud/flashduty/integration/nagios/flashduty.cfg
|
|
6107
|
+
\`\`\`
|
|
6108
|
+
|
|
6109
|
+
</div>
|
|
6110
|
+
|
|
6111
|
+
### 步骤 3：修改配置文件
|
|
6112
|
+
|
|
6113
|
+
<div class="md-block">
|
|
6114
|
+
|
|
6115
|
+
编辑下载的 \`flashduty.cfg\` 文件，修改以下内容：
|
|
6116
|
+
|
|
6117
|
+
1. 将 \`pager\` 字段的值替换为您在 Flashduty 控制台获取的集成推送地址
|
|
6118
|
+
2. 根据您的 Nagios 安装路径，修改 \`command_line\` 中脚本的路径
|
|
6119
|
+
|
|
6120
|
+
配置文件内容示例：
|
|
6121
|
+
|
|
6122
|
+
\`\`\`
|
|
6123
|
+
define contact {
|
|
6124
|
+
contact_name Flashduty
|
|
6125
|
+
alias Flashduty Alert Receiver
|
|
6126
|
+
service_notification_commands notify-service-by-Flashduty
|
|
6127
|
+
host_notification_commands notify-host-by-Flashduty
|
|
6128
|
+
service_notification_options w,u,c,r
|
|
6129
|
+
host_notification_options d,u,r
|
|
6130
|
+
service_notification_period 24x7
|
|
6131
|
+
host_notification_period 24x7
|
|
6132
|
+
pager <YOUR_FLASHDUTY_PUSH_URL>
|
|
6133
|
+
}
|
|
6134
|
+
|
|
6135
|
+
|
|
6136
|
+
define command {
|
|
6137
|
+
command_name notify-host-by-Flashduty
|
|
6138
|
+
command_line <NAGIOS_PLUGIN_PATH>/send_to_flashduty.sh type=HOST WEBHOOK_URL="$CONTACTPAGER$" hostname="$HOSTNAME$" state="$HOSTSTATE$" output="$HOSTOUTPUT$" notification_type="$NOTIFICATIONTYPE$" time="$LONGDATETIME$" host_address="$HOSTADDRESS$" host_alias="$HOSTALIAS$" check_command="$HOSTCHECKCOMMAND$"
|
|
6139
|
+
}
|
|
6140
|
+
|
|
6141
|
+
define command {
|
|
6142
|
+
command_name notify-service-by-Flashduty
|
|
6143
|
+
command_line <NAGIOS_PLUGIN_PATH>/send_to_flashduty.sh type=SERVICE WEBHOOK_URL="$CONTACTPAGER$" hostname="$HOSTNAME$" state="$SERVICESTATE$" output="$SERVICEOUTPUT$" notification_type="$NOTIFICATIONTYPE$" time="$LONGDATETIME$" host_address="$HOSTADDRESS$" service_desc="$SERVICEDESC$" host_alias="$HOSTALIAS$" max_attempts="$MAXSERVICEATTEMPTS$"
|
|
6144
|
+
}
|
|
6145
|
+
\`\`\`
|
|
6146
|
+
|
|
6147
|
+
参数说明：
|
|
6148
|
+
- \`pager\`：Flashduty 推送地址，即您在 Flashduty 控制台获取的集成推送地址
|
|
6149
|
+
- \`<NAGIOS_PLUGIN_PATH>\`：需要替换为实际的脚本路径，如 \`/usr/local/nagios/libexec\`
|
|
6150
|
+
- \`service_notification_options\`：服务告警通知选项，w=警告，u=未知，c=严重，r=恢复
|
|
6151
|
+
- \`host_notification_options\`：主机告警通知选项，d=宕机，u=不可达，r=恢复
|
|
6152
|
+
|
|
6153
|
+
|
|
6154
|
+
**如需在告警中携带更多信息，可以在 \`command_line\` 末尾按照 \`key=value\` 格式追加参数，例如：\`environment="production" region="$_HOSTREGION$"\`。这些参数将作为标签（labels）推送到 Flashduty。**
|
|
6155
|
+
|
|
6156
|
+
</div>
|
|
6157
|
+
|
|
6158
|
+
### 步骤 4：引入配置文件
|
|
6159
|
+
|
|
6160
|
+
<div class="md-block">
|
|
6161
|
+
|
|
6162
|
+
如果您使用的是 **RHEL/CentOS 系统** 或 **源码安装**，需要在 Nagios 主配置文件中引入 Flashduty 配置文件。
|
|
6163
|
+
|
|
6164
|
+
- **RHEL/CentOS 系统**：编辑 \`/etc/nagios/nagios.cfg\`，添加：
|
|
6165
|
+
|
|
6166
|
+
\`\`\`
|
|
6167
|
+
cfg_file=/etc/nagios/objects/flashduty.cfg
|
|
6168
|
+
\`\`\`
|
|
6169
|
+
|
|
6170
|
+
- **源码安装**：编辑 \`/usr/local/nagios/etc/nagios.cfg\`，添加：
|
|
6171
|
+
|
|
6172
|
+
\`\`\`
|
|
6173
|
+
cfg_file=/usr/local/nagios/etc/objects/flashduty.cfg
|
|
6174
|
+
\`\`\`
|
|
6175
|
+
|
|
6176
|
+
:::tips
|
|
6177
|
+
Debian/Ubuntu 系统通常会自动加载 \`/etc/nagios3/conf.d/\` 目录下的所有配置文件，无需手动引入。
|
|
6178
|
+
:::
|
|
6179
|
+
|
|
6180
|
+
</div>
|
|
6181
|
+
|
|
6182
|
+
### 步骤 5：将 Flashduty 添加到联系人组
|
|
6183
|
+
|
|
6184
|
+
<div class="md-block">
|
|
6185
|
+
|
|
6186
|
+
编辑联系人配置文件，将 Flashduty 联系人添加到 \`admins\` 联系人组（或您使用的其他联系人组）：
|
|
6187
|
+
|
|
6188
|
+
- **Debian/Ubuntu 系统**：编辑 \`/etc/nagios3/conf.d/contacts_nagios2.cfg\`
|
|
6189
|
+
- **RHEL/CentOS 系统**：编辑 \`/etc/nagios/objects/contacts.cfg\`
|
|
6190
|
+
- **源码安装**：编辑 \`/usr/local/nagios/etc/objects/contacts.cfg\`
|
|
6191
|
+
|
|
6192
|
+
找到联系人组定义，将 Flashduty 添加到成员列表：
|
|
6193
|
+
|
|
6194
|
+
\`\`\`
|
|
6195
|
+
define contactgroup {
|
|
6196
|
+
contactgroup_name admins
|
|
6197
|
+
alias Nagios Administrators
|
|
6198
|
+
members nagiosadmin,Flashduty
|
|
6199
|
+
}
|
|
6200
|
+
\`\`\`
|
|
6201
|
+
|
|
6202
|
+
</div>
|
|
6203
|
+
|
|
6204
|
+
### 步骤 6：验证配置并重启服务
|
|
6205
|
+
|
|
6206
|
+
<div class="md-block">
|
|
6207
|
+
|
|
6208
|
+
1. 验证 Nagios 配置文件：
|
|
6209
|
+
|
|
6210
|
+
- **Debian/Ubuntu 系统**：
|
|
6211
|
+
|
|
6212
|
+
\`\`\`bash
|
|
6213
|
+
/usr/sbin/nagios3 -v /etc/nagios3/nagios.cfg
|
|
6214
|
+
\`\`\`
|
|
6215
|
+
|
|
6216
|
+
- **RHEL/CentOS 系统**：
|
|
6217
|
+
|
|
6218
|
+
\`\`\`bash
|
|
6219
|
+
/usr/sbin/nagios -v /etc/nagios/nagios.cfg
|
|
6220
|
+
\`\`\`
|
|
6221
|
+
|
|
6222
|
+
- **源码安装**：
|
|
6223
|
+
|
|
6224
|
+
\`\`\`bash
|
|
6225
|
+
/usr/local/nagios/bin/nagios -v /usr/local/nagios/etc/nagios.cfg
|
|
6226
|
+
\`\`\`
|
|
6227
|
+
|
|
6228
|
+
2. 如果验证通过，重启 Nagios 服务：
|
|
6229
|
+
|
|
6230
|
+
\`\`\`bash
|
|
6231
|
+
# Debian/Ubuntu
|
|
6232
|
+
systemctl restart nagios3
|
|
6233
|
+
# 或
|
|
6234
|
+
service nagios3 restart
|
|
6235
|
+
|
|
6236
|
+
# RHEL/CentOS/源码安装
|
|
6237
|
+
systemctl restart nagios
|
|
6238
|
+
# 或
|
|
6239
|
+
service nagios restart
|
|
6240
|
+
\`\`\`
|
|
6241
|
+
|
|
6242
|
+
3. 完成配置后，当 Nagios 检测到告警时，将自动推送到 Flashduty
|
|
6243
|
+
|
|
6244
|
+
</div>
|
|
6245
|
+
|
|
6246
|
+
## 状态对照
|
|
6247
|
+
---
|
|
6248
|
+
<div class="md-block">
|
|
6249
|
+
|
|
6250
|
+
Nagios 到 Flashduty 告警等级映射关系：
|
|
6251
|
+
|
|
6252
|
+
| Nagios | Flashduty | 状态 |
|
|
6253
|
+
| --------------- | --------- | ---- |
|
|
6254
|
+
| CRITICAL | Critical | 严重 |
|
|
6255
|
+
| DOWN | Critical | 严重 |
|
|
6256
|
+
| UNREACHABLE | Critical | 严重 |
|
|
6257
|
+
| WARNING | Warning | 警告 |
|
|
6258
|
+
| OK | Ok | 恢复 |
|
|
6259
|
+
| UP | Ok | 恢复 |
|
|
6260
|
+
| UNKNOWN | Info | 提醒 |
|
|
6261
|
+
|
|
6262
|
+
</div>
|
|
6263
|
+
`,an=`---
|
|
6264
|
+
title: "京东云监控告警集成"
|
|
6265
|
+
description: "通过 webhook 的方式同步京东云监控告警事件到 Flashduty，实现告警事件自动化降噪处理"
|
|
6266
|
+
date: "2025-05-19T10:00:00+08:00"
|
|
6267
|
+
url: "https://docs.flashcat.cloud/zh/flashduty/jdcloud-integration-guide"
|
|
6268
|
+
---
|
|
6269
|
+
|
|
6270
|
+
通过 webhook 的方式同步京东云监控告警事件到 Flashduty，实现告警事件自动化降噪处理。
|
|
6271
|
+
|
|
6272
|
+
<div class="hide">
|
|
6273
|
+
|
|
6274
|
+
## 在 Flashduty
|
|
6275
|
+
---
|
|
6276
|
+
您可通过以下2种方式，获取一个集成推送地址，任选其一即可。
|
|
6277
|
+
|
|
6278
|
+
### 使用专属集成
|
|
6279
|
+
|
|
6280
|
+
当您不需要将告警事件路由到不同的协作空间，优先选择此方式，更简单。
|
|
6281
|
+
|
|
6282
|
+
<details>
|
|
6283
|
+
<summary>展开</summary>
|
|
6284
|
+
|
|
6285
|
+
1. 进入 Flashduty 控制台，选择 **协作空间**，进入某个空间的详情页面
|
|
6286
|
+
2. 选择 **集成数据** tab，点击 **添加一个集成**，进入添加集成页面
|
|
6287
|
+
3. 选择 **京东云监控** 集成，点击 **保存**，生成卡片。
|
|
6288
|
+
4. 点击生成的卡片，可以查看到 **推送地址**，复制备用，完成。
|
|
6289
|
+
|
|
6290
|
+
|
|
6291
|
+
</details>
|
|
6292
|
+
|
|
6293
|
+
### 使用共享集成
|
|
6294
|
+
|
|
6295
|
+
当您需要根据告警事件的 Payload 信息，将告警路由到不同的协作空间，优先选择此方式。
|
|
6296
|
+
|
|
6297
|
+
<details>
|
|
6298
|
+
<summary>展开</summary>
|
|
6299
|
+
|
|
6300
|
+
1. 进入 Flashduty 控制台，选择 **集成中心=>告警事件**，进入集成选择页面。
|
|
6301
|
+
2. 选择 **京东云监控** 集成：
|
|
6302
|
+
- **集成名称**：为当前集成定义一个名称。
|
|
6303
|
+
3. 配置默认路由，并选择对应的协作空间（集成创建后可以前往 \`路由\` 进行更多路由规则的配置）。
|
|
6304
|
+
4. 点击 **保存** 后，复制当前页面的新生成的 **推送地址** 备用。
|
|
6305
|
+
5. 完成。
|
|
6306
|
+
|
|
6307
|
+
</details>
|
|
6308
|
+
|
|
6309
|
+
</div>
|
|
6310
|
+
|
|
6311
|
+
## 在京东云
|
|
6312
|
+
---
|
|
6313
|
+
|
|
6314
|
+
一、在京东云监控配置告警推送
|
|
6315
|
+
|
|
6316
|
+
### 步骤 1：创建通知模版
|
|
6317
|
+
1. 登录您的京东云控制台，检索 \`云监控\` 产品，并进入对应产品控制台。
|
|
6318
|
+
2. 在左侧菜单中选择 \`告警管理->通知模版\`，选择创建或编辑通知模版。
|
|
6319
|
+
3. 在页面中勾选 \`告警回调\`， \`URL\`中输入告警集成的<span class='integration_url'>推送地址</span>。
|
|
6320
|
+
4. \`POST\` 编辑框中输入以下模版内容。
|
|
6321
|
+
\`\`\`
|
|
6322
|
+
{
|
|
6323
|
+
"resource_id": "\${resourceId}",
|
|
6324
|
+
"request_id": "\${requestId}",
|
|
6325
|
+
"metric": "\${metric}",
|
|
6326
|
+
"current_value": "\${currentValue}",
|
|
6327
|
+
"times": "\${times}",
|
|
6328
|
+
"tags": "\${tags}",
|
|
6329
|
+
"alert_time": "\${alertTime}",
|
|
6330
|
+
"region": "\${region}",
|
|
6331
|
+
"threshold": "\${threshold}",
|
|
6332
|
+
"service_code": "\${serviceCode}",
|
|
6333
|
+
"as_group_id": "\${asGroupId}",
|
|
6334
|
+
"unhealthy_instance": "\${unhealthyInstance}",
|
|
6335
|
+
"rule_policy_id": "\${rulePolicyId}",
|
|
6336
|
+
"service_code_en": "\${serviceCodeEN}",
|
|
6337
|
+
"service_code_cn": "\${serviceCodeCN}",
|
|
6338
|
+
"level": "\${level}",
|
|
6339
|
+
"resource_name": "\${resourceName}",
|
|
6340
|
+
"ip_address": "\${ipAddress}",
|
|
6341
|
+
"status": "\${status}"
|
|
6342
|
+
}
|
|
6343
|
+
|
|
6344
|
+
\`\`\`
|
|
6345
|
+
5. 其他选项按需配置。
|
|
6346
|
+
6. 点击 \`保存\` 完成配置。
|
|
6347
|
+
|
|
6348
|
+
### 步骤 2：配置告警规则
|
|
6349
|
+
1. 登录您的京东云控制台，检索 \`云监控\` 产品，并进入对应产品控制台。
|
|
6350
|
+
2. 在左侧菜单中选择 \`告警管理->全部告警规则\`，选择创建或编辑告警规则。
|
|
6351
|
+
3. 在规则编辑页面中的 \`通知策略\` 处选择 \`使用模版\` 且模版选择**步骤1**创建的模版。
|
|
6352
|
+
4. 其他选项按需配置。
|
|
6353
|
+
5. 点击 \`保存\` 完成配置。
|
|
6354
|
+
|
|
6355
|
+
## 二、状态对照
|
|
6356
|
+
---
|
|
6357
|
+
<div class="md-block">
|
|
6358
|
+
|
|
6359
|
+
京东云监控 到 Flashduty 告警等级映射关系：
|
|
6360
|
+
|
|
6361
|
+
| 京东云监控 | Flashduty | 状态 |
|
|
6362
|
+
| --------------- | --------- | ---- |
|
|
6363
|
+
| 紧急 | Critical | 紧急 |
|
|
6364
|
+
| 严重 | Warning | 警告 |
|
|
6365
|
+
| 一般 | Info | 提醒 |
|
|
6366
|
+
|
|
6367
|
+
</div>
|
|
6368
|
+
`,sn=`---
|
|
6369
|
+
title: "阿里云监控 Prometheus"
|
|
6370
|
+
description: "通过 webhook 的方式同步阿里云监控 Prometheus 告警事件到 Flashduty，实现告警事件自动化降噪处理"
|
|
6371
|
+
date: "2025-05-19T10:00:00+08:00"
|
|
6372
|
+
url: "https://docs.flashcat.cloud/zh/flashduty/jdcloud-integration-guide"
|
|
6373
|
+
---
|
|
6374
|
+
|
|
6375
|
+
通过 webhook 的方式同步阿里云监控 Prometheus 告警事件到 Flashduty，实现告警事件自动化降噪处理。
|
|
6376
|
+
|
|
6377
|
+
<div class="hide">
|
|
6378
|
+
|
|
6379
|
+
## 在 Flashduty
|
|
6380
|
+
---
|
|
6381
|
+
您可通过以下2种方式，获取一个集成推送地址，任选其一即可。
|
|
6382
|
+
|
|
6383
|
+
### 使用专属集成
|
|
6384
|
+
|
|
6385
|
+
当您不需要将告警事件路由到不同的协作空间，优先选择此方式，更简单。
|
|
6386
|
+
|
|
6387
|
+
<details>
|
|
6388
|
+
<summary>展开</summary>
|
|
6389
|
+
|
|
6390
|
+
1. 进入 Flashduty 控制台，选择 **协作空间**，进入某个空间的详情页面
|
|
6391
|
+
2. 选择 **集成数据** tab，点击 **添加一个集成**，进入添加集成页面
|
|
6392
|
+
3. 选择 **阿里云监控 Prometheus** 集成，点击 **保存**，生成卡片。
|
|
6393
|
+
4. 点击生成的卡片，可以查看到 **推送地址**，复制备用，完成。
|
|
6394
|
+
|
|
6395
|
+
|
|
6396
|
+
</details>
|
|
6397
|
+
|
|
6398
|
+
### 使用共享集成
|
|
6399
|
+
|
|
6400
|
+
当您需要根据告警事件的 Payload 信息，将告警路由到不同的协作空间，优先选择此方式。
|
|
6401
|
+
|
|
6402
|
+
<details>
|
|
6403
|
+
<summary>展开</summary>
|
|
6404
|
+
|
|
6405
|
+
1. 进入 Flashduty 控制台，选择 **集成中心=>告警事件**，进入集成选择页面。
|
|
6406
|
+
2. 选择 **阿里云监控 Prometheus** 集成：
|
|
6407
|
+
- **集成名称**：为当前集成定义一个名称。
|
|
6408
|
+
3. 配置默认路由，并选择对应的协作空间（集成创建后可以前往 \`路由\` 进行更多路由规则的配置）。
|
|
6409
|
+
4. 点击 **保存** 后，复制当前页面的新生成的 **推送地址** 备用。
|
|
6410
|
+
5. 完成。
|
|
6411
|
+
|
|
6412
|
+
</details>
|
|
6413
|
+
|
|
6414
|
+
</div>
|
|
6415
|
+
|
|
6416
|
+
## 在阿里云
|
|
6417
|
+
---
|
|
6418
|
+
|
|
6419
|
+
一、在阿里云监控配置告警推送
|
|
6420
|
+
|
|
6421
|
+
### 步骤 1：创建自定义 Webhook
|
|
6422
|
+
1. 登录您的阿里云控制台，检索 \`云监控\` 产品，并进入对应产品控制台。
|
|
6423
|
+
2. 在左侧菜单中选择 \`Prometheus 监控->通知对象\`，选择创建或编辑\`自定义 Webhook\`。
|
|
6424
|
+
3. 在编辑页面中，名称和标识符填写 \`Flashduty\`， \`URL\`中输入告警集成的<span class='integration_url'>推送地址</span>。
|
|
6425
|
+
4. \`Headers\` 中的 **Header Key** 填写 **Content-Type**，**Header Value** 填写 **application/json**。
|
|
6426
|
+
5. \`Method\` 选择 **POST**，\`数据格式\` 选择 **JSON**。
|
|
6427
|
+
6. 点击 \`确定\` 完成配置。
|
|
6428
|
+
|
|
6429
|
+
### 步骤 2：配置报警规则
|
|
6430
|
+
1. 登录您的阿里云控制台，检索 \`云监控\` 产品，并进入对应产品控制台。
|
|
6431
|
+
2. 在左侧菜单中选择 \`Prometheus 监控->报警规则\`，选择创建或编辑告警规则。
|
|
6432
|
+
3. 在规则编辑页面中的 \`通知模式\` 处选择 \`极简模式\` 。
|
|
6433
|
+
4. \`通知对象\` 选择**步骤1**创建的自定义 Webhook。
|
|
6434
|
+
5. 点击 \`确定\` 完成配置。
|
|
6435
|
+
|
|
6436
|
+
## 二、状态对照
|
|
6437
|
+
---
|
|
6438
|
+
<div class="md-block">
|
|
6439
|
+
|
|
6440
|
+
阿里云 Prometheus 监控到 Flashduty 告警等级映射关系：
|
|
6441
|
+
|
|
6442
|
+
| 阿里云监控 | Flashduty | 状态 |
|
|
6443
|
+
| --------------- | --------- | ---- |
|
|
6444
|
+
| 紧急 | Critical | 紧急 |
|
|
6445
|
+
| 错误 | Critical | 紧急 |
|
|
6446
|
+
| 警告 | Warning | 警告 |
|
|
6447
|
+
| 普通 | Info | 提醒 |
|
|
6448
|
+
|
|
6449
|
+
</div>
|
|
6450
|
+
`,dn=`---
|
|
6451
|
+
title: "自定义变更事件集成指引"
|
|
6452
|
+
description: "通过标准协议推送自有系统变更事件到 Flashduty，大部分故障由变更导致，变更和告警事件联动有助于快速定位故障原因。"
|
|
6453
|
+
date: "2025-05-19T10:00:00+08:00"
|
|
6454
|
+
url: "https://docs.flashcat.cloud/zh/flashduty/custom-change-integration-guide"
|
|
6455
|
+
---
|
|
6456
|
+
|
|
6457
|
+
通过标准协议推送自有系统变更事件到 Flashduty，大部分故障由变更导致，变更和告警事件联动有助于快速定位故障原因。
|
|
6458
|
+
|
|
6459
|
+
:::tips
|
|
6460
|
+
Flashduty 已经适配部分常用工单、部署系统的 webhook 协议，对于这些系统您应该首先使用对应的集成，更加简单方便。本集成提供了一个标准的 HTTP 接口，需要允许您开发适配。好处是您可以与任何部署系统集成。
|
|
6461
|
+
:::
|
|
6462
|
+
|
|
6463
|
+
## 操作步骤
|
|
6464
|
+
---
|
|
6465
|
+
|
|
6466
|
+
### 在 Flashduty
|
|
6467
|
+
|
|
6468
|
+
1. 进入 Flashduty 控制台，选择 **集成中心=>变更事件**，进入集成选择页面。
|
|
6469
|
+
2. 选择 **自定义事件** 集成：
|
|
6470
|
+
- **集成名称**：为当前集成定义一个名称。
|
|
6471
|
+
3. 点击 **保存** 后，复制当前页面的新生成的 **推送地址** 备用。
|
|
6472
|
+
4. 完成。
|
|
6473
|
+
|
|
6474
|
+
|
|
6475
|
+
## 实现协议
|
|
6476
|
+
---
|
|
6477
|
+
|
|
6478
|
+
请您参照 [开发文档](https://developer.flashcat.cloud/zh/flashduty/event-api/change-event) 完成协议开发。
|
|
6479
|
+
|
|
6480
|
+
## 最佳实践
|
|
6481
|
+
---
|
|
6482
|
+
|
|
6483
|
+
标签是事件的描述，应尽量丰富标签内容，比如：
|
|
6484
|
+
1. 变更的应用范围，如 host，cluster 等
|
|
6485
|
+
1. 变更的归属信息，如 team，owner 等
|
|
6486
|
+
|
|
6487
|
+
## 常见问题
|
|
6488
|
+
---
|
|
6489
|
+
|
|
6490
|
+
<details>
|
|
6491
|
+
<summary>为什么在Flashduty没有收到变更？</summary>
|
|
6492
|
+
|
|
6493
|
+
#### 在 Flashduty
|
|
6494
|
+
|
|
6495
|
+
1. 查看集成是否展示了 **最新事件时间**？如果没有，代表Flashduty没有收到推送，直接优先排查夜莺部分。
|
|
6496
|
+
|
|
6497
|
+
#### 在您的系统
|
|
6498
|
+
|
|
6499
|
+
1. 确认您请求的地址，和集成详情中的地址完全一致。
|
|
6500
|
+
2. 确认您的服务可以访问外网 api.flashcat.cloud 域名。如果不可以，您首先需要为 server 开通外网，或单独针对 Flashduty 的域名开通外网访问。
|
|
6501
|
+
3. 打印 Flashduty 服务的响应结果，查看是否有明确信息。
|
|
6502
|
+
|
|
6503
|
+
如果以上步骤执行之后，仍然没有查询到问题根因，请 **携带请求响应中的 request_id** 联系我们。
|
|
6504
|
+
|
|
6505
|
+
</details>
|
|
6506
|
+
|
|
6507
|
+
`,ln=`---
|
|
6508
|
+
title: "Jira 事件集成指引"
|
|
6509
|
+
description: "通过 webhook 的方式同步 Jira Issue 事件到 Flashduty，实现变更事件收集。"
|
|
6510
|
+
date: "2025-05-19T10:00:00+08:00"
|
|
6511
|
+
url: "https://docs.flashcat.cloud/zh/flashduty/jira-integration-guide"
|
|
6512
|
+
---
|
|
6513
|
+
|
|
6514
|
+
通过 webhook 的方式同步 Jira Issue 事件到 Flashduty，实现变更事件收集。
|
|
6515
|
+
|
|
6516
|
+
## 使用限制
|
|
6517
|
+
---
|
|
6518
|
+
|
|
6519
|
+
### 在 Jira
|
|
6520
|
+
|
|
6521
|
+
- 您必须拥有修改 **Settings=>System=>Webhooks** 的权限。
|
|
6522
|
+
- （如果是私有化部署）您的Jira server 必须能够访问域名 api.flascat.cloud。
|
|
6523
|
+
|
|
6524
|
+
## 支持版本
|
|
6525
|
+
---
|
|
6526
|
+
|
|
6527
|
+
本文适配 **Jira Cloud 和 私有化** 版本。
|
|
6528
|
+
|
|
6529
|
+
## 操作步骤
|
|
6530
|
+
---
|
|
6531
|
+
|
|
6532
|
+
### 在 Flashduty
|
|
6533
|
+
|
|
6534
|
+
1. 进入 Flashduty 控制台，选择 **集成中心=>变更事件**，进入集成选择页面。
|
|
6535
|
+
2. 选择 **Jira** 集成：
|
|
6536
|
+
- **集成名称**：为当前集成定义一个名称。
|
|
6537
|
+
3. 点击 **保存** 后，复制当前页面的新生成的 **推送地址** 备用。
|
|
6538
|
+
4. 完成。
|
|
6539
|
+
|
|
6540
|
+
### 在 Jira
|
|
6541
|
+
|
|
6542
|
+
<div class="md-block">
|
|
6543
|
+
|
|
6544
|
+
1. 登录您的 Jira
|
|
6545
|
+
2. 进入 **Settings=>System=>Webhooks** 页面，点击 Create 按钮
|
|
6546
|
+
3. 填写回调地址为当前集成对应的推送地址，并勾选 Issue Created/Updated/Deleted 三种类型事件
|
|
6547
|
+
4. 可选择填写 JQL 来进一步缩小（如特定的 Projects ）要同步的事件范围
|
|
6548
|
+
5. 点击 Save 按钮，提交配置
|
|
6549
|
+
|
|
6550
|
+
<img alt="drawing" src="http://download.flashcat.cloud/jira-webhook.png" />
|
|
6551
|
+
|
|
6552
|
+
5. 完成
|
|
6553
|
+
|
|
6554
|
+
</div>
|
|
6555
|
+
|
|
6556
|
+
## 状态映射
|
|
6557
|
+
---
|
|
6558
|
+
|
|
6559
|
+
<div class="md-block">
|
|
6560
|
+
|
|
6561
|
+
Flashduty 默认提取 webhook payload 中 status.name 信息，并按照下边的映射关系进行状态转换：
|
|
6562
|
+
|
|
6563
|
+
| Jira | Flashduty | 状态 |
|
|
6564
|
+
| ----------- | ---------- | ------------------ |
|
|
6565
|
+
| planned | planned | 已提单 |
|
|
6566
|
+
| to do | planned | 已提单 |
|
|
6567
|
+
| ready | ready | 即将（或计划）开始 |
|
|
6568
|
+
| processing | processing | 进行中 |
|
|
6569
|
+
| open | processing | 进行中 |
|
|
6570
|
+
| reopen | processing | 进行中 |
|
|
6571
|
+
| in progress | processing | 进行中 |
|
|
6572
|
+
| canceled | canceled | 已取消（或回滚） |
|
|
6573
|
+
| aborted | canceled | 已取消（或回滚） |
|
|
6574
|
+
| done | done | 已完成 |
|
|
6575
|
+
| resolved | done | 已完成 |
|
|
6576
|
+
| closed | done | 已完成 |
|
|
6577
|
+
|
|
6578
|
+
如您希望变更此映射关系，请联系 Flashduty。
|
|
6579
|
+
|
|
6580
|
+
</div>
|
|
6581
|
+
`,on=`---
|
|
6582
|
+
title: "飞书集成"
|
|
6583
|
+
description: "通过集成飞书自建应用，您可以在飞书端内接收和响应告警。"
|
|
6584
|
+
date: "2025-05-19T10:00:00+08:00"
|
|
6585
|
+
url: "https://docs.flashcat.cloud/zh/flashduty/lark-integration-guide"
|
|
6586
|
+
---
|
|
6587
|
+
通过集成飞书自建应用，您可以在飞书端内接收和响应告警。
|
|
6588
|
+
|
|
6589
|
+
<div class="hide">
|
|
6590
|
+
|
|
6591
|
+
## 视频介绍
|
|
6592
|
+
---
|
|
6593
|
+
<Video src="https://download.flashcat.cloud/flashduty/video/feishu.mp4"></Video>
|
|
6594
|
+
</div>
|
|
6595
|
+
|
|
6596
|
+
## 一、创建飞书应用
|
|
6597
|
+
---
|
|
6598
|
+
|
|
6599
|
+
### 1. 创建自建应用
|
|
6600
|
+
|
|
6601
|
+
访问 [飞书开发者后台](https://open.feishu.cn/app)，创建企业内自建应用。应用图标可使用 [Flashduty 官方 icon](https://download.flashcat.cloud/flashcat_logo_circular.png)。
|
|
6602
|
+
|
|
6603
|
+
详见飞书开发文档 [创建企业自建应用](https://open.feishu.cn/document/uYjL24iN/uMTMuMTMuMTM/development-guide/step1#132c1aac)。
|
|
6604
|
+
|
|
6605
|
+
|
|
6606
|
+
|
|
6607
|
+
### 2. 复制凭证信息
|
|
6608
|
+
|
|
6609
|
+
前往 **凭证与基础信息** 页面，复制 \`App ID\` 和 \`App Secret\` 备用。
|
|
6610
|
+
|
|
6611
|
+
|
|
6612
|
+
|
|
6613
|
+
|
|
6614
|
+
### 3. 复制事件回调的 Token 信息
|
|
6615
|
+
|
|
6616
|
+
前往 开发配置 → 事件与回调 → **加密策略** 页面，生成并复制 \`Encrypt Key\`（推荐启用，更安全）和 \`Verification Token\` 备用。
|
|
6617
|
+
|
|
6618
|
+
|
|
6619
|
+
|
|
6620
|
+
## 二、添加飞书集成
|
|
6621
|
+
---
|
|
6622
|
+
|
|
6623
|
+
回到 Flashduty **集成中心** 页面，选择 即时消息 → **飞书**，在表单中填入 \`名称\` 以及上一步复制的 \`App ID\`、\`App Secret\`、\`Verification Token\` 和 \`Encrypt Key\` 后，点击 **保存** 完成创建。
|
|
6624
|
+
|
|
6625
|
+
创建成功后，您将在列表中看到已添加的飞书集成。点击其名称进入详情页面，即可查看 **网页配置** 地址、**重定向 URL** 和 **消息卡片请求网址**，这些信息将在后续步骤中使用。
|
|
6626
|
+
|
|
6627
|
+
|
|
6628
|
+
|
|
6629
|
+
## 三、配置飞书应用
|
|
6630
|
+
---
|
|
6631
|
+
|
|
6632
|
+
### 1. 开通并配置应用能力
|
|
6633
|
+
|
|
6634
|
+
1. 回到飞书开发者后台，进入刚才创建的飞书应用，进入 添加应用能力 → **按能力添加** 页面，同时开通 **网页应用** 和 **机器人** 能力。
|
|
5971
6635
|
|
|
5972
6636
|
|
|
5973
6637
|
|
|
@@ -6003,7 +6667,8 @@ url: "https://docs.flashcat.cloud/zh/flashduty/lark-integration-guide"
|
|
|
6003
6667
|
|
|
6004
6668
|
- \`im:chat\`：获取与更新群组信息
|
|
6005
6669
|
- \`im:message\`：获取与发送单聊、群组消息
|
|
6006
|
-
- \`contact:user.id:readonly\`：通过手机号或邮箱获取用户 ID
|
|
6670
|
+
- \`contact:user.id:readonly\`：通过手机号或邮箱获取用户 ID
|
|
6671
|
+
- \`im:message.group_msg\`：读取群聊历史消息（AI 生成复盘报告需要读取作战室聊天记录） <span id="war-room-scope"></span>
|
|
6007
6672
|
|
|
6008
6673
|
|
|
6009
6674
|
|
|
@@ -6067,7 +6732,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/lark-integration-guide"
|
|
|
6067
6732
|
5. **为什么作战室功能未按预期工作？**
|
|
6068
6733
|
- 请再次检查是否为应用配置了作战室功能[所需权限](#war-room-scope)。
|
|
6069
6734
|
- 请参考 Flashduty [作战室介绍文档](https://docs.flashcat.cloud/zh/flashduty/war-room) 的 **常见问题** 部分。
|
|
6070
|
-
`,
|
|
6735
|
+
`,rn=`---
|
|
6071
6736
|
title: "钉钉集成"
|
|
6072
6737
|
description: "通过集成钉钉自建应用，实现在钉钉端内接收和响应告警的能力"
|
|
6073
6738
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -6300,7 +6965,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/dingtalk-integration-guide"
|
|
|
6300
6965
|
| 专属版 | 550 万次 | 60 | 每月 1 日 |
|
|
6301
6966
|
|
|
6302
6967
|
> 超出 API 调用量限制后，钉钉应用将无法正常推送消息。建议合理使用通知渠道。详见 [钉钉官方文档](https://open.dingtalk.com/document/orgapp/descriptions-about-adjusting-limit-and-frequency-of-api-calls?spm=ding_open_doc.document.0.0.6f6b21d9WtkxJI)。
|
|
6303
|
-
`,
|
|
6968
|
+
`,cn=`---
|
|
6304
6969
|
title: "企业微信 WeCom 集成"
|
|
6305
6970
|
description: "通过集成企业微信第三方应用，实现在企业微信端接收和响应告警的能力"
|
|
6306
6971
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -6347,7 +7012,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/wecom-integration-guide"
|
|
|
6347
7012
|
|
|
6348
7013
|
4. 访问 [企业微信管理后台](https://work.weixin.qq.com/wework_admin/frame#apps)，进入 **我的企业** 页面，获取 \`企业 ID\`。
|
|
6349
7014
|
|
|
6350
|
-
|
|
7015
|
+
|
|
6351
7016
|
|
|
6352
7017
|
5. 返回 Flashduty 集成配置页面，填写上一步获取的 \`企业 ID\`，点击 **保存** 完成集成。
|
|
6353
7018
|
|
|
@@ -6375,13 +7040,13 @@ url: "https://docs.flashcat.cloud/zh/flashduty/wecom-integration-guide"
|
|
|
6375
7040
|
|
|
6376
7041
|
6. 在应用详情页，获取 \`Secret\`，并将其填写至 Flashduty 集成配置页面。
|
|
6377
7042
|
|
|
6378
|
-
7. 在应用详情页，进入 **网页授权及 JS-SDK** 页面，点击
|
|
7043
|
+
7. 在应用详情页，进入 **网页授权及 JS-SDK** 页面，点击 **设置可信域名**，并按要求配置。
|
|
6379
7044
|
|
|
6380
7045
|
> 可信域名需要指向 Flashduty 的后端地址 \`{api_host}\`（可通过 CNAME 或代理转发实现）。
|
|
6381
7046
|
>
|
|
6382
7047
|
> 关于可信域名的要求，详见企业微信官方文档 [《企业内部开发配置域名指引》](https://open.work.weixin.qq.com/wwopen/common/readDocument/40754)。
|
|
6383
7048
|
|
|
6384
|
-
|
|
6385
7050
|
|
|
6386
7051
|
返回 Flashduty 集成配置页面，填写该域名，并完成验证。
|
|
6387
7052
|
|
|
@@ -6393,11 +7058,21 @@ url: "https://docs.flashcat.cloud/zh/flashduty/wecom-integration-guide"
|
|
|
6393
7058
|
|
|
6394
7059
|
9. 复制 Flashduty 集成详情页中的 \`回调地址\`，返回企业微信刚才的 **接收消息** 页面。在 **API 接收** 设置中，填入该 \`回调地址\` 以及上一步保存的 \`Token\` 和 \`EncodingAESKey\`，然后点击 **保存**。
|
|
6395
7060
|
|
|
6396
|
-
|
|
7061
|
+
|
|
7062
|
+
|
|
7063
|
+
10. 配置**前端可信域名**
|
|
6397
7064
|
|
|
6398
|
-
|
|
7065
|
+
> 可信域名需要指向 Flashduty 的前端地址 \`console.flashcat.cloud\`（可通过 CNAME 或代理转发实现）。
|
|
7066
|
+
>
|
|
7067
|
+
> 关于可信域名的要求，详见企业微信官方文档 [《企业内部开发配置域名指引》](https://open.work.weixin.qq.com/wwopen/common/readDocument/40754)。
|
|
6399
7068
|
|
|
6400
|
-
|
|
7069
|
+
前端可信域名校验通过后将生成的**主页地址**配置到企微应用的**工作台应用主页**
|
|
7070
|
+
|
|
7071
|
+
|
|
7072
|
+
|
|
7073
|
+
11. 配置**可信 IP 地址**：\`47.93.12.134\`
|
|
7074
|
+
|
|
7075
|
+
|
|
6401
7076
|
|
|
6402
7077
|
## 三、配置作战室
|
|
6403
7078
|
|
|
@@ -6440,7 +7115,8 @@ url: "https://docs.flashcat.cloud/zh/flashduty/wecom-integration-guide"
|
|
|
6440
7115
|
- 请联系 Flashduty 客服或您的专属技术支持，为您购买并开通许可。
|
|
6441
7116
|
8. **为什么作战室功能未按预期工作？**
|
|
6442
7117
|
- 请参考 Flashduty [作战室介绍文档](https://docs.flashcat.cloud/zh/flashduty/war-room) 的 **常见问题** 部分。
|
|
6443
|
-
|
|
7118
|
+
9. **为什么在企微工作台打开应用后提示“redirect_uri需使用应用可信域名”？**
|
|
7119
|
+
- 请确认**应用主页**的url中的\`redirect_uri\`参数中的域名是否完成企业微信要求的域名归属认证，详见企业微信官方文档 [《企业内部开发配置域名指引》](https://open.work.weixin.qq.com/wwopen/common/readDocument/40754)。`,un=`---
|
|
6444
7120
|
title: "Slack 集成"
|
|
6445
7121
|
description: "通过集成 Slack 第三方应用，您可以在 Slack 内接收和响应告警。"
|
|
6446
7122
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -6464,6 +7140,8 @@ url: "https://docs.flashcat.cloud/zh/flashduty/slack-integration-guide"
|
|
|
6464
7140
|
|
|
6465
7141
|
完成先前步骤后，在 Flashduty 集成配置页面的 **增强功能** 模块，勾选 **开启作战室** 即可启用该功能，无需额外配置。
|
|
6466
7142
|
|
|
7143
|
+
若需启用 AI 生成复盘报告（读取作战室聊天记录），应用需要额外的 \`channels:history\` 权限。对于已授权的 Slack 集成，您需要手动重新授权以获取该权限。
|
|
7144
|
+
|
|
6467
7145
|
## 二、常见问题
|
|
6468
7146
|
|
|
6469
7147
|
---
|
|
@@ -6495,7 +7173,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/slack-integration-guide"
|
|
|
6495
7173
|
9. **为什么作战室功能未按预期工作？**
|
|
6496
7174
|
- 对于之前授权的 Slack IM 集成，需要您在 Flashduty 集成配置页中对 Slack 手动进行重新授权，以使应用获得作战室功能所需的额外权限。
|
|
6497
7175
|
- 请参考 Flashduty [作战室介绍文档](https://docs.flashcat.cloud/zh/flashduty/war-room) 的 **常见问题** 部分。
|
|
6498
|
-
`,
|
|
7176
|
+
`,hn=`---
|
|
6499
7177
|
title: "Microsoft Teams 集成"
|
|
6500
7178
|
description: "通过集成 Microsoft Teams 第三方应用，您可以在 Microsoft Teams 内接收和响应告警。"
|
|
6501
7179
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -6513,10 +7191,10 @@ Microsoft Teams 集成现处于 Beta 阶段，在关联前您需要先完成以
|
|
|
6513
7191
|
:::
|
|
6514
7192
|
|
|
6515
7193
|
### 1. 下载应用
|
|
6516
|
-
将 [
|
|
7194
|
+
将 [FlashdutyBot-v1.0.3.zip](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/docs/FlashdutyBot-v1.0.3.zip) 下载到本地。
|
|
6517
7195
|
|
|
6518
7196
|
### 2. 安装应用
|
|
6519
|
-
进入 Microsoft Teams，导航至 +Apps → Manage your apps → Upload an app → **Upload an app to your org's app catalog**，然后上传应用包 \`
|
|
7197
|
+
进入 Microsoft Teams，导航至 +Apps → Manage your apps → Upload an app → **Upload an app to your org's app catalog**，然后上传应用包 \`FlashdutyBot.zip\`。
|
|
6520
7198
|
|
|
6521
7199
|
|
|
6522
7200
|
|
|
@@ -6613,7 +7291,7 @@ Microsoft Teams 集成现处于 Beta 阶段，在关联前您需要先完成以
|
|
|
6613
7291
|
3. **如何取消已关联的团队和用户？**
|
|
6614
7292
|
- 暂不支持此功能。
|
|
6615
7293
|
|
|
6616
|
-
`,
|
|
7294
|
+
`,pn=`配置告警 Webhook，当告警发生特定操作（如触发、关闭）时，系统通过 HTTP 回调您配置的地址。回调内容将包含告警最新关键信息，您可以与自研工具进行集成。
|
|
6617
7295
|
|
|
6618
7296
|
<span id="EventTypes"></span>
|
|
6619
7297
|
|
|
@@ -6724,7 +7402,7 @@ curl -X POST 'https://example.com/alert/webhook?a=a' \\
|
|
|
6724
7402
|
"data_source_name":"阿里云 SLS",
|
|
6725
7403
|
"data_source_ref_id":"",
|
|
6726
7404
|
"data_source_type":"aliyun-sls.alert",
|
|
6727
|
-
"description":"测试发送到
|
|
7405
|
+
"description":"测试发送到Flashduty告警触发",
|
|
6728
7406
|
"end_time":0,
|
|
6729
7407
|
"event_cnt":1,
|
|
6730
7408
|
"incident":{
|
|
@@ -6736,7 +7414,7 @@ curl -X POST 'https://example.com/alert/webhook?a=a' \\
|
|
|
6736
7414
|
"alert_type":"sls_alert",
|
|
6737
7415
|
"alert_url":"https://sls.console.aliyun.com/lognext/project/sls-api-testing/alert/alert-1683548531-071659",
|
|
6738
7416
|
"aliuid":"1082109605037616",
|
|
6739
|
-
"check":"测试发送到
|
|
7417
|
+
"check":"测试发送到Flashduty",
|
|
6740
7418
|
"fire_results":"{\\"_col0\\":\\"true\\"}",
|
|
6741
7419
|
"fire_results_count":"1",
|
|
6742
7420
|
"project":"sls-api-testing",
|
|
@@ -6748,7 +7426,7 @@ curl -X POST 'https://example.com/alert/webhook?a=a' \\
|
|
|
6748
7426
|
"last_time":1683809153,
|
|
6749
7427
|
"progress":"Triggered",
|
|
6750
7428
|
"start_time":1683766013,
|
|
6751
|
-
"title":"测试发送到
|
|
7429
|
+
"title":"测试发送到Flashduty告警触发",
|
|
6752
7430
|
"title_rule":"$resource::$check",
|
|
6753
7431
|
"updated_at":1683809170
|
|
6754
7432
|
},
|
|
@@ -6767,11 +7445,14 @@ curl -X POST 'https://example.com/alert/webhook?a=a' \\
|
|
|
6767
7445
|
|
|
6768
7446
|
1. **服务是否有响应超时时间？**
|
|
6769
7447
|
|
|
6770
|
-
- 服务需要在
|
|
7448
|
+
- 服务需要在 2 秒内返回响应，超过 2 秒则认为响应失败
|
|
6771
7449
|
|
|
6772
7450
|
2. **推送失败后是否会持续推送？**
|
|
6773
7451
|
|
|
6774
|
-
|
|
7452
|
+
针对特定的网络错误，会进行重试，最多重试1次:
|
|
7453
|
+
- context deadline exceeded (排除 awaiting headers)
|
|
7454
|
+
- i/o timeout
|
|
7455
|
+
- eof
|
|
6775
7456
|
|
|
6776
7457
|
3. **如何保证推送顺序？**
|
|
6777
7458
|
|
|
@@ -6781,7 +7462,7 @@ curl -X POST 'https://example.com/alert/webhook?a=a' \\
|
|
|
6781
7462
|
4. **推送来源可信 IP 白名单？**
|
|
6782
7463
|
- {ip_whitelist}
|
|
6783
7464
|
- 未来可能会更新，请定期查验
|
|
6784
|
-
`,
|
|
7465
|
+
`,gn=`配置故障 Webhook，当故障发生特定操作（如触发、关闭）时，系统通过 HTTP 回调您配置的地址。回调内容将包含故障最新关键信息，您可以与自研工具进行集成。
|
|
6785
7466
|
|
|
6786
7467
|
<span id="EventTypes"></span>
|
|
6787
7468
|
|
|
@@ -6976,11 +7657,14 @@ curl -X POST 'https://example.com/incident/webhook?a=a' \\
|
|
|
6976
7657
|
|
|
6977
7658
|
1. **服务是否有响应超时时间？**
|
|
6978
7659
|
|
|
6979
|
-
- 服务需要在
|
|
7660
|
+
- 服务需要在 2 秒内返回响应，超过 2 秒则认为响应失败
|
|
6980
7661
|
|
|
6981
7662
|
2. **推送失败后是否会持续推送？**
|
|
6982
7663
|
|
|
6983
|
-
|
|
7664
|
+
针对特定的网络错误，会进行重试，最多重试1次:
|
|
7665
|
+
- context deadline exceeded (排除 awaiting headers)
|
|
7666
|
+
- i/o timeout
|
|
7667
|
+
- eof
|
|
6984
7668
|
|
|
6985
7669
|
3. **如何保证推送顺序？**
|
|
6986
7670
|
|
|
@@ -6989,11 +7673,11 @@ curl -X POST 'https://example.com/incident/webhook?a=a' \\
|
|
|
6989
7673
|
|
|
6990
7674
|
4. **推送来源可信 IP 白名单？**
|
|
6991
7675
|
- {ip_whitelist}
|
|
6992
|
-
- 未来可能会更新，请定期查验`,
|
|
7676
|
+
- 未来可能会更新，请定期查验`,mn=`配置故障 自定义操作，允许您在故障排查期间，快速调用外部接口，实现故障自愈、信息丰富等任何自定义操作。
|
|
6993
7677
|
|
|
6994
7678
|
## 一、创建操作
|
|
6995
7679
|
|
|
6996
|
-
1. 登录
|
|
7680
|
+
1. 登录 Flashduty 控制台，进入【集成中心-Webhook】
|
|
6997
7681
|
2. 点击添加 自定义操作 集成
|
|
6998
7682
|
3. 配置 操作名称，此名称将以按钮的形式体现在故障详情中
|
|
6999
7683
|
4. 配置 协作空间，可以配置多个，但每个协作空间至多添加三个 自定义操作
|
|
@@ -7229,7 +7913,7 @@ curl -X POST 'https://example.com/incident/action?a=a' \\
|
|
|
7229
7913
|
|
|
7230
7914
|
### 信息丰富
|
|
7231
7915
|
|
|
7232
|
-
当故障发生时，回调您的服务，根据告警详情调取 Tracing、Logging、拓扑等信息，主动调用
|
|
7916
|
+
当故障发生时，回调您的服务，根据告警详情调取 Tracing、Logging、拓扑等信息，主动调用 Flashduty Open API 来更新故障信息，比如增加标签或设定自定义字段，辅助排障。
|
|
7233
7917
|
|
|
7234
7918
|
### 回滚变更
|
|
7235
7919
|
|
|
@@ -7243,12 +7927,18 @@ curl -X POST 'https://example.com/incident/action?a=a' \\
|
|
|
7243
7927
|
|
|
7244
7928
|
1. **服务是否有响应超时时间？**
|
|
7245
7929
|
|
|
7246
|
-
- 服务需要在
|
|
7930
|
+
- 服务需要在 2 秒内返回响应，超过 2 秒则认为响应失败
|
|
7931
|
+
|
|
7932
|
+
2. **推送失败后是否会持续推送？**
|
|
7247
7933
|
|
|
7934
|
+
针对特定的网络错误，会进行重试，最多重试1次:
|
|
7935
|
+
- context deadline exceeded (排除 awaiting headers)
|
|
7936
|
+
- i/o timeout
|
|
7937
|
+
- eof
|
|
7248
7938
|
|
|
7249
7939
|
2. **推送来源可信 IP 白名单？**
|
|
7250
7940
|
- {ip_whitelist}
|
|
7251
|
-
- 未来可能会更新，请定期查验`,
|
|
7941
|
+
- 未来可能会更新，请定期查验`,yn=`---
|
|
7252
7942
|
title: "Jira 同步"
|
|
7253
7943
|
description: "通过 Jira 同步 Webhook，实现故障与 Jira Issue 的关联。"
|
|
7254
7944
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -7333,7 +8023,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/jira-sync"
|
|
|
7333
8023
|
|
|
7334
8024
|
- Flashduty 会按照默认的字段映射以及您配置的自定义字段映射进行同步信息，如果您的 Jira 事务类型中有必选的字段且没有配置映射关系，则会遇到创建 Jira Issue 失败的情况。
|
|
7335
8025
|
- Jira 的 Issue 详情是基于项目 KEY + 编号的格式进行访问的，如果您修改了项目 KEY，可能无法通过 Flashduty 中保存的 Issue 地址进行访问，请谨慎修改项目 KEY。
|
|
7336
|
-
`,
|
|
8026
|
+
`,fn=`---
|
|
7337
8027
|
title: "ServiceNow 同步"
|
|
7338
8028
|
description: "通过 ServiceNow 同步 Webhook，实现故障与 ServiceNow Incident 的关联。"
|
|
7339
8029
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -7646,7 +8336,7 @@ IncidentWebhookHelper.prototype = {
|
|
|
7646
8336
|
<details>
|
|
7647
8337
|
<summary>配置集成时提示 401 错误 </summary>
|
|
7648
8338
|
提示 401 一般是密码错误导致的，请检查密码是否正确，或者重新设置新的密码(在配置密码时，请勿勾选 Password needs reset 选项)
|
|
7649
|
-
</details>`,
|
|
8339
|
+
</details>`,bn=`---
|
|
7650
8340
|
title: "ServiceDesk Plus 同步"
|
|
7651
8341
|
description: "通过 ServiceDesk Plus 同步 Webhook，实现故障与 ServiceDesk Plus request 的关联。"
|
|
7652
8342
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -7718,30 +8408,20 @@ url: "https://docs.flashcat.cloud/zh/flashduty/servicedesk-plus-sync"
|
|
|
7718
8408
|
- 手动触发：需要在故障详情页的更多操作中手动触发 ServiceDesk Plus 同步（该集成配置的名称为触发器名称）。
|
|
7719
8409
|
|
|
7720
8410
|
5. **协作空间**：选择该集成生效的协作空间。
|
|
7721
|
-
6. **请求模版**：选择创建 request
|
|
7722
|
-
7.
|
|
7723
|
-
8. **自定义字段映射**：可以将故障中的标签或自定义字段，映射到 ServiceDesk Plus 工单中的对应文本字段，实现信息自动填充。该功能支持将常见上下文信息（如服务名、实例地址、指标名称等）同步至
|
|
8411
|
+
6. **请求模版**：选择创建 request 时使用的模版，为空时使用默认模版创建工单。
|
|
8412
|
+
7. **严重程度映射**：可以选择使用严重程度、故障标签、自定义字段的值与 ServiceDesk Plus 的优先级字段进行映射，如果为空，在创建工单时不传该字段。
|
|
8413
|
+
8. **自定义字段映射**：可以将故障中的标签或自定义字段，映射到 ServiceDesk Plus 工单中的对应文本字段，实现信息自动填充。该功能支持将常见上下文信息（如服务名、实例地址、指标名称等）同步至 ServiceDesk Plus，便于后续排查与跟踪。
|
|
7724
8414
|
- 仅支持目标为单行文本或多行文本类型的字段。
|
|
7725
8415
|
- 支持从故障标签（如 service、instance）或自定义属性中提取值。
|
|
7726
8416
|
- 若源字段为空，目标字段也将保持为空，不会覆盖原有内容。
|
|
7727
|
-
- 映射配置在集成设置中统一管理，无需每次手动填写。
|
|
7728
8417
|
|
|
7729
8418
|
9. **指派对象映射**：当 Flashduty 的故障同步至 ServiceDesk Plus 并需要自动指派到 Technician 或 Group 时，可以获取 Flashduty 故障标签的值作为指派对象（如果对应的指派对象不存在，会导致同步失败，请谨慎选择）。
|
|
7730
|
-
|
|
7731
|
-
|
|
8419
|
+
10. **请求者**：创建工单时指定的 requester，如果工单在创建时该字段是必须，则需要配置。
|
|
8420
|
+
11. 点击\`保存\`完成配置。
|
|
7732
8421
|
|
|
7733
8422
|
### 在 ServiceDesk Plus
|
|
7734
|
-
#### 步骤2 创建 Requester
|
|
7735
|
-
当 Flashduty 的故障同步到 ServiceDesk Plus 时，系统自动设置的 Requester
|
|
7736
|
-
|
|
7737
|
-
1. 登录 ServiceDesk Plus 控制台，找到 \`Setup\` 配置页面。
|
|
7738
|
-
2. 选择 \`Users & Permissions\` 之后，进入到 \`Users\` 创建页面，选择 \`New Requester\`。
|
|
7739
|
-
3. \`Name (Display Name)\` 和 \`First Name\` 填写 **flashduty**，\`Email\` 填写 **flashduty-sync@flashcat.cloud** 。
|
|
7740
|
-
4. 其他可按需设置，点击 \`Save\` 保存配置。
|
|
7741
8423
|
|
|
7742
|
-
|
|
7743
|
-
|
|
7744
|
-
#### 步骤3 配置同步 <span id="配置同步"></span>
|
|
8424
|
+
#### 步骤2 配置同步 <span id="配置同步"></span>
|
|
7745
8425
|
要实现 ServiceDesk Plus 的 Request 向 Flashduty 的同步，请参考此配置项。**注意:** 不同版本的路径可能略有不同，但配置方法相同。
|
|
7746
8426
|
##### 创建 Webhook
|
|
7747
8427
|
1. 登录 ServiceDesk Plus 控制台，找到 \`Setup\` 配置页面。
|
|
@@ -7780,7 +8460,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/servicedesk-plus-sync"
|
|
|
7780
8460
|
|
|
7781
8461
|
|
|
7782
8462
|
|
|
7783
|
-
##### 创建触发器
|
|
8463
|
+
##### 步骤3 创建触发器
|
|
7784
8464
|
1. 登录 ServiceDesk Plus 控制台，找到 \`Setup\` 配置页面。
|
|
7785
8465
|
2. 选择 \`Automation\` 之后，进入到 \`Triggers\` 页面，并选择 \`Request\`。
|
|
7786
8466
|
3. 点击 \`New Trigger\`，在编辑页面中 \`Name\` 填写 **to_Flashduty**。
|
|
@@ -7820,14 +8500,6 @@ url: "https://docs.flashcat.cloud/zh/flashduty/servicedesk-plus-sync"
|
|
|
7820
8500
|
| Canceled | CLosed | 关闭 |
|
|
7821
8501
|
| Rejected | CLosed | 关闭 |
|
|
7822
8502
|
|
|
7823
|
-
### 优先级映射 <span id="优先级映射"></span>
|
|
7824
|
-
|
|
7825
|
-
| ServiceDesk Plus | Flashduty | 备注 |
|
|
7826
|
-
| ---------- | --------- | ---- |
|
|
7827
|
-
| Low | Info | 提示 |
|
|
7828
|
-
| Medium | Warning | 警告 |
|
|
7829
|
-
| High | Critical | 灾难 |
|
|
7830
|
-
|
|
7831
8503
|
|
|
7832
8504
|
## 常见问题
|
|
7833
8505
|
|
|
@@ -7835,7 +8507,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/servicedesk-plus-sync"
|
|
|
7835
8507
|
<summary> Scope 是否可以更改</summary>
|
|
7836
8508
|
不可以，目前所使用的 Scope 已经是最小单元了，Flashduty 在与 ServiceDesc Plus 进行同步 request 时，需要做获取/创建/更新操作，以及在配置集成时，需要获取优先级/自定义字段列表，所以需要相应的权限支持。
|
|
7837
8509
|
</details>
|
|
7838
|
-
`,
|
|
8510
|
+
`,vn=`---
|
|
7839
8511
|
title: "配置通知模版"
|
|
7840
8512
|
description: "通过自定义配置模版，可以实现个性化通知内容的需求"
|
|
7841
8513
|
date: "2024-05-10T10:00:00+08:00"
|
|
@@ -7969,10 +8641,8 @@ Title | string | 是 | 告警标题
|
|
|
7969
8641
|
Description | string | 是 | 告警描述，可能为空
|
|
7970
8642
|
AlertSeverity | string | 是 | 严重程度，枚举值：Critical，Warning，Info
|
|
7971
8643
|
AlertStatus | string | 是 | 告警状态，枚举值：Critical，Warning，Info，Ok
|
|
7972
|
-
Progress | string | 是 | 处理进度，枚举值：Triggered，Processing，Closed
|
|
7973
8644
|
StartTime | int64 | 是 | 触发时间，Unix 秒时间戳
|
|
7974
8645
|
EndTime | int64 | 否 | 恢复时间，Unix 秒时间戳，默认为 0
|
|
7975
|
-
CloseTime | int64 | 否 | 关闭时间，EndTime 为告警恢复时间，CloseTime 为处理进度的关闭时间，告警恢复时会自动关闭，告警手动关闭时不影响告警恢复。Unix 秒时间戳，默认为 0
|
|
7976
8646
|
\`Labels\` | map[string]string | 否 | 标签 KV，Key 和 Value 均为字符串
|
|
7977
8647
|
|
|
7978
8648
|
## 常见问题
|
|
@@ -8911,6 +9581,17 @@ msg_type 必填，值为 post
|
|
|
8911
9581
|
\`\`\`
|
|
8912
9582
|
</div>
|
|
8913
9583
|
|
|
9584
|
+
<div class="voice hide">
|
|
9585
|
+
|
|
9586
|
+
## 语音
|
|
9587
|
+
---
|
|
9588
|
+
如果不设置自定义内容，将采用系统默认模板渲染通知：
|
|
9589
|
+
|
|
9590
|
+
\`\`\`
|
|
9591
|
+
您有故障待处理：{{toHtml .Title}}，协作空间：{{.ChannelName}}，等级：{{.IncidentSeverity}}{{if gt .AlertCnt 1}}，共聚合{{.AlertCnt}}条告警{{end}}
|
|
9592
|
+
\`\`\`
|
|
9593
|
+
</div>
|
|
9594
|
+
|
|
8914
9595
|
<div class="email hide">
|
|
8915
9596
|
|
|
8916
9597
|
## 邮件
|
|
@@ -8925,80 +9606,321 @@ msg_type 必填，值为 post
|
|
|
8925
9606
|
|
|
8926
9607
|
<head data-id="__react-email-head">
|
|
8927
9608
|
<style>
|
|
8928
|
-
|
|
8929
|
-
|
|
8930
|
-
|
|
8931
|
-
|
|
8932
|
-
|
|
8933
|
-
|
|
8934
|
-
|
|
8935
|
-
|
|
8936
|
-
|
|
8937
|
-
|
|
9609
|
+
/* Light mode colors */
|
|
9610
|
+
:root {
|
|
9611
|
+
--bg-color: rgb(255, 255, 255);
|
|
9612
|
+
--text-color: rgb(55, 65, 81);
|
|
9613
|
+
--label-key-color: #000;
|
|
9614
|
+
--section-bg: rgb(255, 255, 255);
|
|
9615
|
+
--border-color: rgb(229, 231, 235);
|
|
9616
|
+
}
|
|
9617
|
+
|
|
9618
|
+
/* Dark mode colors */
|
|
9619
|
+
@media (prefers-color-scheme: dark) {
|
|
9620
|
+
:root {
|
|
9621
|
+
--bg-color: rgb(31, 41, 55);
|
|
9622
|
+
--text-color: rgb(209, 213, 219);
|
|
9623
|
+
--label-key-color: rgb(229, 231, 235);
|
|
9624
|
+
--section-bg: rgb(17, 24, 39);
|
|
9625
|
+
--border-color: rgb(75, 85, 99);
|
|
9626
|
+
}
|
|
9627
|
+
}
|
|
9628
|
+
|
|
9629
|
+
/* Severity background colors */
|
|
9630
|
+
.severity-Critical {
|
|
9631
|
+
background-color: #C80000;
|
|
9632
|
+
color: #ffffff;
|
|
9633
|
+
padding: 4px 12px;
|
|
9634
|
+
border-radius: 12px;
|
|
9635
|
+
display: inline-block;
|
|
9636
|
+
font-weight: 600;
|
|
9637
|
+
font-size: 13px;
|
|
9638
|
+
}
|
|
9639
|
+
.severity-Warning {
|
|
9640
|
+
background-color: #fef3c7;
|
|
9641
|
+
color: #92400e;
|
|
9642
|
+
padding: 4px 12px;
|
|
9643
|
+
border-radius: 12px;
|
|
9644
|
+
display: inline-block;
|
|
9645
|
+
font-weight: 600;
|
|
9646
|
+
font-size: 13px;
|
|
9647
|
+
}
|
|
9648
|
+
.severity-Info {
|
|
9649
|
+
background-color: #dbeafe;
|
|
9650
|
+
color: #1e40af;
|
|
9651
|
+
padding: 4px 12px;
|
|
9652
|
+
border-radius: 12px;
|
|
9653
|
+
display: inline-block;
|
|
9654
|
+
font-weight: 600;
|
|
9655
|
+
font-size: 13px;
|
|
9656
|
+
}
|
|
9657
|
+
.severity-Ok {
|
|
9658
|
+
background-color: #d1fae5;
|
|
9659
|
+
color: #065f46;
|
|
9660
|
+
padding: 4px 12px;
|
|
9661
|
+
border-radius: 12px;
|
|
9662
|
+
display: inline-block;
|
|
9663
|
+
font-weight: 600;
|
|
9664
|
+
font-size: 13px;
|
|
9665
|
+
}
|
|
9666
|
+
|
|
9667
|
+
/* Progress status colors */
|
|
9668
|
+
.progress-Triggered {
|
|
9669
|
+
background-color: #dbeafe;
|
|
9670
|
+
color: #1e40af;
|
|
9671
|
+
padding: 4px 12px;
|
|
9672
|
+
border-radius: 12px;
|
|
9673
|
+
display: inline-block;
|
|
9674
|
+
font-weight: 600;
|
|
9675
|
+
font-size: 13px;
|
|
9676
|
+
}
|
|
9677
|
+
.progress-Acknowledged {
|
|
9678
|
+
background-color: #ede9fe;
|
|
9679
|
+
color: #6b21a8;
|
|
9680
|
+
padding: 4px 12px;
|
|
9681
|
+
border-radius: 12px;
|
|
9682
|
+
display: inline-block;
|
|
9683
|
+
font-weight: 600;
|
|
9684
|
+
font-size: 13px;
|
|
9685
|
+
}
|
|
9686
|
+
.progress-Resolved {
|
|
9687
|
+
background-color: #d1fae5;
|
|
9688
|
+
color: #065f46;
|
|
9689
|
+
padding: 4px 12px;
|
|
9690
|
+
border-radius: 12px;
|
|
9691
|
+
display: inline-block;
|
|
9692
|
+
font-weight: 600;
|
|
9693
|
+
font-size: 13px;
|
|
9694
|
+
}
|
|
9695
|
+
.progress-Closed {
|
|
9696
|
+
background-color: #f3f4f6;
|
|
9697
|
+
color: #374151;
|
|
9698
|
+
padding: 4px 12px;
|
|
9699
|
+
border-radius: 12px;
|
|
9700
|
+
display: inline-block;
|
|
9701
|
+
font-weight: 600;
|
|
9702
|
+
font-size: 13px;
|
|
9703
|
+
}
|
|
9704
|
+
|
|
9705
|
+
/* Field row styles */
|
|
9706
|
+
.field-row {
|
|
9707
|
+
padding: 1rem 0;
|
|
9708
|
+
border-bottom: 1px solid var(--border-color);
|
|
9709
|
+
}
|
|
9710
|
+
.field-row:first-child {
|
|
9711
|
+
padding-top: 0;
|
|
9712
|
+
}
|
|
9713
|
+
.field-row:last-child {
|
|
9714
|
+
border-bottom: none;
|
|
9715
|
+
}
|
|
9716
|
+
.field-label {
|
|
9717
|
+
color: #6b7280;
|
|
9718
|
+
font-size: 0.875rem;
|
|
9719
|
+
margin-bottom: 0.25rem;
|
|
9720
|
+
}
|
|
9721
|
+
.field-value {
|
|
9722
|
+
color: var(--text-color);
|
|
9723
|
+
word-break: break-word;
|
|
9724
|
+
overflow-wrap: break-word;
|
|
9725
|
+
}
|
|
9726
|
+
|
|
9727
|
+
body {
|
|
9728
|
+
background-color: var(--bg-color);
|
|
9729
|
+
color: var(--text-color);
|
|
9730
|
+
}
|
|
9731
|
+
|
|
9732
|
+
.labels-section {
|
|
9733
|
+
background-color: #f3f4f6;
|
|
9734
|
+
padding: 1rem;
|
|
9735
|
+
border-radius: 0.375rem;
|
|
9736
|
+
margin-top: 0.5rem;
|
|
9737
|
+
}
|
|
9738
|
+
@media (prefers-color-scheme: dark) {
|
|
9739
|
+
.labels-section {
|
|
9740
|
+
background-color: rgb(55, 65, 81);
|
|
9741
|
+
}
|
|
9742
|
+
}
|
|
8938
9743
|
</style>
|
|
8939
9744
|
</head>
|
|
8940
9745
|
|
|
8941
|
-
<body data-id="__react-email-body" style="
|
|
8942
|
-
|
|
8943
|
-
<
|
|
8944
|
-
<
|
|
8945
|
-
|
|
8946
|
-
|
|
8947
|
-
|
|
8948
|
-
|
|
8949
|
-
|
|
8950
|
-
|
|
8951
|
-
|
|
8952
|
-
|
|
8953
|
-
|
|
8954
|
-
|
|
8955
|
-
|
|
8956
|
-
|
|
8957
|
-
|
|
8958
|
-
|
|
8959
|
-
|
|
8960
|
-
|
|
8961
|
-
|
|
8962
|
-
|
|
8963
|
-
|
|
8964
|
-
|
|
8965
|
-
|
|
8966
|
-
|
|
8967
|
-
|
|
8968
|
-
|
|
8969
|
-
|
|
8970
|
-
|
|
8971
|
-
|
|
8972
|
-
|
|
8973
|
-
|
|
8974
|
-
|
|
8975
|
-
|
|
8976
|
-
|
|
8977
|
-
|
|
8978
|
-
|
|
8979
|
-
|
|
8980
|
-
|
|
8981
|
-
|
|
8982
|
-
|
|
8983
|
-
|
|
8984
|
-
|
|
8985
|
-
|
|
8986
|
-
|
|
8987
|
-
|
|
8988
|
-
|
|
8989
|
-
|
|
8990
|
-
|
|
8991
|
-
|
|
8992
|
-
|
|
8993
|
-
|
|
8994
|
-
|
|
8995
|
-
|
|
8996
|
-
|
|
8997
|
-
|
|
8998
|
-
|
|
8999
|
-
|
|
9746
|
+
<body data-id="__react-email-body" style="margin:0;padding:0;background-color:#f3f4f6;font-family:ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, Segoe UI, Roboto, Helvetica Neue, Arial, Noto Sans, sans-serif, Apple Color Emoji, Segoe UI Emoji, Segoe UI Symbol, Noto Color Emoji">
|
|
9747
|
+
<!-- Outer wrapper table for centering -->
|
|
9748
|
+
<table width="100%" cellpadding="0" cellspacing="0" border="0" style="background-color:#f3f4f6">
|
|
9749
|
+
<tr>
|
|
9750
|
+
<td align="center" style="padding:40px 20px">
|
|
9751
|
+
<!-- Main container table with fixed width -->
|
|
9752
|
+
<table width="600" cellpadding="0" cellspacing="0" border="0" style="background-color:#ffffff;max-width:600px">
|
|
9753
|
+
<!-- Purple header bar with logo -->
|
|
9754
|
+
<tr>
|
|
9755
|
+
<td style="padding:32px 0 32px 32px;text-align:left">
|
|
9756
|
+
<img data-id="react-email-img" src="https://flashduty-public.oss-cn-beijing.aliyuncs.com/icons/flashduty-20251216.png" height="70" style="display:block;outline:none;border:none;text-decoration:none;height:70px;width:auto" alt="Flashduty" />
|
|
9757
|
+
</td>
|
|
9758
|
+
</tr>
|
|
9759
|
+
|
|
9760
|
+
<!-- Divider after logo -->
|
|
9761
|
+
<tr>
|
|
9762
|
+
<td style="padding:0 32px">
|
|
9763
|
+
<div style="border-top:1px solid #e5e7eb"></div>
|
|
9764
|
+
</td>
|
|
9765
|
+
</tr>
|
|
9766
|
+
|
|
9767
|
+
<!-- Main content -->
|
|
9768
|
+
<tr>
|
|
9769
|
+
<td style="padding:16px 32px 32px 32px">
|
|
9770
|
+
<!-- Title and Description -->
|
|
9771
|
+
<table width="100%" cellpadding="0" cellspacing="0" border="0">
|
|
9772
|
+
<tr>
|
|
9773
|
+
<td>
|
|
9774
|
+
<h1 style="margin:0;font-size:24px;font-weight:600;color:#111827;line-height:1.5">{{.Title}}</h1>
|
|
9775
|
+
{{if .Description}}
|
|
9776
|
+
<p style="margin:8px 0 0 0;font-size:16px;color:#6b7280;line-height:1.5">{{toHtml .Description}}</p>
|
|
9777
|
+
{{end}}
|
|
9778
|
+
</td>
|
|
9779
|
+
</tr>
|
|
9780
|
+
</table>
|
|
9781
|
+
|
|
9782
|
+
<!-- Divider after title -->
|
|
9783
|
+
<div style="border-top:1px solid #e5e7eb;margin:32px 0"></div>
|
|
9784
|
+
|
|
9785
|
+
<!-- Fields section -->
|
|
9786
|
+
<table width="100%" cellpadding="0" cellspacing="0" border="0" style="margin-bottom:30px">
|
|
9787
|
+
<tr>
|
|
9788
|
+
<td style="padding:16px 0;border-bottom:1px solid #e5e7eb;background-color:#ffffff">
|
|
9789
|
+
<table width="100%" cellpadding="0" cellspacing="0" border="0">
|
|
9790
|
+
<tr>
|
|
9791
|
+
<td width="100" style="font-weight:600;color:#374151;font-size:14px;vertical-align:top;padding-left:16px">严重程度</td>
|
|
9792
|
+
<td style="color:#6b7280;font-size:14px;word-break:break-word;padding-right:16px"><span class="severity-{{.IncidentSeverity}}">{{.IncidentSeverity}}</span></td>
|
|
9793
|
+
</tr>
|
|
9794
|
+
</table>
|
|
9795
|
+
</td>
|
|
9796
|
+
</tr>
|
|
9797
|
+
|
|
9798
|
+
<tr>
|
|
9799
|
+
<td style="padding:16px 0;border-bottom:1px solid #e5e7eb;background-color:#ffffff">
|
|
9800
|
+
<table width="100%" cellpadding="0" cellspacing="0" border="0">
|
|
9801
|
+
<tr>
|
|
9802
|
+
<td width="100" style="font-weight:600;color:#374151;font-size:14px;vertical-align:top;padding-left:16px">协作空间</td>
|
|
9803
|
+
<td style="color:#6b7280;font-size:14px;word-break:break-word;padding-right:16px">{{if .ChannelName}}{{.ChannelName}}{{else}}无{{end}}</td>
|
|
9804
|
+
</tr>
|
|
9805
|
+
</table>
|
|
9806
|
+
</td>
|
|
9807
|
+
</tr>
|
|
9808
|
+
|
|
9809
|
+
<tr>
|
|
9810
|
+
<td style="padding:16px 0;border-bottom:1px solid #e5e7eb;background-color:#ffffff">
|
|
9811
|
+
<table width="100%" cellpadding="0" cellspacing="0" border="0">
|
|
9812
|
+
<tr>
|
|
9813
|
+
<td width="100" style="font-weight:600;color:#374151;font-size:14px;vertical-align:top;padding-left:16px">触发时间</td>
|
|
9814
|
+
<td style="color:#6b7280;font-size:14px;word-break:break-word;padding-right:16px">{{date "2006-01-02 15:04:05" .StartTime}}</td>
|
|
9815
|
+
</tr>
|
|
9816
|
+
</table>
|
|
9817
|
+
</td>
|
|
9818
|
+
</tr>
|
|
9819
|
+
|
|
9820
|
+
{{if .CreatorID}}
|
|
9821
|
+
<tr>
|
|
9822
|
+
<td style="padding:16px 0;border-bottom:1px solid #e5e7eb;background-color:#ffffff">
|
|
9823
|
+
<table width="100%" cellpadding="0" cellspacing="0" border="0">
|
|
9824
|
+
<tr>
|
|
9825
|
+
<td width="100" style="font-weight:600;color:#374151;font-size:14px;vertical-align:top;padding-left:16px">发起人员</td>
|
|
9826
|
+
<td style="color:#6b7280;font-size:14px;word-break:break-word;padding-right:16px">{{.Creator.PersonName}}</td>
|
|
9827
|
+
</tr>
|
|
9828
|
+
</table>
|
|
9829
|
+
</td>
|
|
9830
|
+
</tr>
|
|
9831
|
+
{{end}}
|
|
9832
|
+
|
|
9833
|
+
{{if gt (len .Responders) 0}}
|
|
9834
|
+
<tr>
|
|
9835
|
+
<td style="padding:16px 0;border-bottom:1px solid #e5e7eb;background-color:#ffffff">
|
|
9836
|
+
<table width="100%" cellpadding="0" cellspacing="0" border="0">
|
|
9837
|
+
<tr>
|
|
9838
|
+
<td width="100" style="font-weight:600;color:#374151;font-size:14px;vertical-align:top;padding-left:16px">处理人员</td>
|
|
9839
|
+
<td style="color:#6b7280;font-size:14px;word-break:break-word;padding-right:16px">{{range .Responders}}@{{.PersonName}} {{end}}</td>
|
|
9840
|
+
</tr>
|
|
9841
|
+
</table>
|
|
9842
|
+
</td>
|
|
9843
|
+
</tr>
|
|
9844
|
+
{{end}}
|
|
9845
|
+
|
|
9846
|
+
<tr>
|
|
9847
|
+
<td style="padding:16px 0;border-bottom:1px solid #e5e7eb;background-color:#ffffff">
|
|
9848
|
+
<table width="100%" cellpadding="0" cellspacing="0" border="0">
|
|
9849
|
+
<tr>
|
|
9850
|
+
<td width="100" style="font-weight:600;color:#374151;font-size:14px;vertical-align:top;padding-left:16px">处理进度</td>
|
|
9851
|
+
<td style="color:#6b7280;font-size:14px;word-break:break-word;padding-right:16px"><span class="progress-{{.Progress}}">{{.Progress}}</span></td>
|
|
9852
|
+
</tr>
|
|
9853
|
+
</table>
|
|
9854
|
+
</td>
|
|
9855
|
+
</tr>
|
|
9856
|
+
|
|
9857
|
+
{{if .Labels.resource}}
|
|
9858
|
+
<tr>
|
|
9859
|
+
<td style="padding:16px 0;border-bottom:1px solid #e5e7eb;background-color:#ffffff">
|
|
9860
|
+
<table width="100%" cellpadding="0" cellspacing="0" border="0">
|
|
9861
|
+
<tr>
|
|
9862
|
+
<td width="100" style="font-weight:600;color:#374151;font-size:14px;vertical-align:top;padding-left:16px">告警对象</td>
|
|
9863
|
+
<td style="color:#6b7280;font-size:14px;word-break:break-word;padding-right:16px">{{(joinAlertLabels . "resource" ", ")}}</td>
|
|
9864
|
+
</tr>
|
|
9865
|
+
</table>
|
|
9866
|
+
</td>
|
|
9867
|
+
</tr>
|
|
9868
|
+
{{end}}
|
|
9869
|
+
|
|
9870
|
+
{{if gt (len .Labels) 0}}
|
|
9871
|
+
<tr>
|
|
9872
|
+
<td style="padding:16px 0">
|
|
9873
|
+
<table width="100%" cellpadding="0" cellspacing="0" border="0">
|
|
9874
|
+
<tr>
|
|
9875
|
+
<td width="100" style="font-weight:600;color:#374151;font-size:14px;vertical-align:top;padding-left:16px">标签</td>
|
|
9876
|
+
<td style="color:#6b7280;font-size:14px;word-break:break-word;padding-right:16px;background-color:#f9fafb;padding:16px">
|
|
9877
|
+
<pre style="margin:0;font-family:'Courier New',monospace;font-size:13px;color:#374151;white-space:pre-wrap;word-break:break-word">{{mustToPrettyJson .Labels}}</pre>
|
|
9878
|
+
</td>
|
|
9879
|
+
</tr>
|
|
9880
|
+
</table>
|
|
9881
|
+
</td>
|
|
9882
|
+
</tr>
|
|
9883
|
+
{{end}}
|
|
9884
|
+
</table>
|
|
9885
|
+
|
|
9886
|
+
<!-- Action buttons -->
|
|
9887
|
+
<table width="100%" cellpadding="0" cellspacing="0" border="0" style="margin-top:32px">
|
|
9888
|
+
<tr>
|
|
9889
|
+
<td width="48%" align="center" style="padding:0">
|
|
9890
|
+
<table cellpadding="0" cellspacing="0" border="0" style="width:100%">
|
|
9891
|
+
<tr>
|
|
9892
|
+
<td align="center" style="background-color:rgb(108,83,177);border-radius:6px;padding:14px 32px">
|
|
9893
|
+
<a href="{{.DetailUrl}}?ack=1" data-id="react-email-button" target="_blank" style="color:#ffffff;font-size:16px;font-weight:600;text-decoration:none;display:block">立即认领</a>
|
|
9894
|
+
</td>
|
|
9895
|
+
</tr>
|
|
9896
|
+
</table>
|
|
9897
|
+
</td>
|
|
9898
|
+
<td width="4%" style="padding:0"></td>
|
|
9899
|
+
<td width="48%" align="center" style="padding:0">
|
|
9900
|
+
<table cellpadding="0" cellspacing="0" border="0" style="width:100%">
|
|
9901
|
+
<tr>
|
|
9902
|
+
<td align="center" style="background-color:#ffffff;border:2px solid rgb(108,83,177);border-radius:6px;padding:14px 32px">
|
|
9903
|
+
<a href="{{.DetailUrl}}" data-id="react-email-button" target="_blank" style="color:rgb(108,83,177);font-size:16px;font-weight:600;text-decoration:none;display:block">查看详情</a>
|
|
9904
|
+
</td>
|
|
9905
|
+
</tr>
|
|
9906
|
+
</table>
|
|
9907
|
+
</td>
|
|
9908
|
+
</tr>
|
|
9909
|
+
</table>
|
|
9910
|
+
</td>
|
|
9911
|
+
</tr>
|
|
9912
|
+
|
|
9913
|
+
<!-- Footer -->
|
|
9914
|
+
<tr>
|
|
9915
|
+
<td style="background-color:#f9fafb;padding:20px;text-align:center">
|
|
9916
|
+
<p style="margin:0;font-size:12px;color:#9ca3af">ALL RIGHTS RESERVED © FLASHCAT.CLOUD</p>
|
|
9917
|
+
</td>
|
|
9918
|
+
</tr>
|
|
9919
|
+
</table>
|
|
9920
|
+
</td>
|
|
9921
|
+
</tr>
|
|
9922
|
+
</table>
|
|
9000
9923
|
</body>
|
|
9001
|
-
|
|
9002
9924
|
</html>
|
|
9003
9925
|
\`\`\`
|
|
9004
9926
|
|
|
@@ -9007,7 +9929,7 @@ msg_type 必填，值为 post
|
|
|
9007
9929
|
<img src="https://download.flashcat.cloud/flashduty/changelog/20230720/email_render.png" alt="drawing" style="display: block; margin: 0 auto;" width="500"/>
|
|
9008
9930
|
|
|
9009
9931
|
</div>
|
|
9010
|
-
`,
|
|
9932
|
+
`,_n=`---
|
|
9011
9933
|
title: "Link 集成"
|
|
9012
9934
|
description: "通过 Link 集成，可直接从故障属性、标签等信息中获取访问外部链接所需的关键参数，实现快速访问"
|
|
9013
9935
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -9064,4 +9986,208 @@ https://cmdb.com/vm?sn=VM123456
|
|
|
9064
9986
|
1. 当引用的内容不存在时，Link 集成会正常生成对应的链接，但无法获取到值
|
|
9065
9987
|
2. 同一个协作空间至多绑定三个 Link 集成
|
|
9066
9988
|
3. 注意引用语法，如未按照要求进行书写引用变量，会导致无法正常获取对应值
|
|
9067
|
-
`,
|
|
9989
|
+
`,wn=`配置标签映射 API，当告警事件到达时，Flashduty 将自动调用您配置的外部 API 获取增强标签，实现告警信息的动态丰富和关联。通过此功能，您可以将 CMDB、HR 系统等外部数据源的信息自动附加到告警上。
|
|
9990
|
+
|
|
9991
|
+
## 一、功能概述
|
|
9992
|
+
|
|
9993
|
+
标签映射 API 允许您构建自定义的外部服务来增强告警标签。工作流程如下：
|
|
9994
|
+
|
|
9995
|
+
1. Flashduty 接收到告警事件
|
|
9996
|
+
2. 系统根据配置，将事件信息和期望获取的标签列表发送到您的 API
|
|
9997
|
+
3. 您的 API 查询外部数据源（如 CMDB、数据库等）
|
|
9998
|
+
4. API 返回计算得到的增强标签
|
|
9999
|
+
5. Flashduty 将返回的标签附加到告警上
|
|
10000
|
+
|
|
10001
|
+
<span id="ApiSpec"></span>
|
|
10002
|
+
|
|
10003
|
+
## 二、API 规范
|
|
10004
|
+
|
|
10005
|
+
### 请求方式
|
|
10006
|
+
|
|
10007
|
+
<div class="md-block">
|
|
10008
|
+
|
|
10009
|
+
POST, Content-Type:"application/json"
|
|
10010
|
+
|
|
10011
|
+
</div>
|
|
10012
|
+
|
|
10013
|
+
### 请求 Payload：
|
|
10014
|
+
|
|
10015
|
+
<div class="md-block">
|
|
10016
|
+
|
|
10017
|
+
| 字段 | 类型 | 必含 | 释义 |
|
|
10018
|
+
| :--------: | :-------------------: | :--: | :--------- |
|
|
10019
|
+
| result_label_keys | []string | 是 | 期望返回的标签 Key 列表，由用户在 Flashduty 中配置 |
|
|
10020
|
+
| event | [Event](#Event) | 是 | 当前告警事件的完整信息 |
|
|
10021
|
+
|
|
10022
|
+
<span id="Event"></span>
|
|
10023
|
+
**Event**:
|
|
10024
|
+
|
|
10025
|
+
| 字段 | 类型 | 必含 | 释义 |
|
|
10026
|
+
| :--------: | :-------------------: | :--: | :--------- |
|
|
10027
|
+
| account_id | int64 | 是 | 账户 ID |
|
|
10028
|
+
| channel_id | int64 | 是 | 协作空间 ID |
|
|
10029
|
+
| data_source_id | int64 | 是 | 数据源 ID |
|
|
10030
|
+
| data_source_type | string | 是 | 数据源类型，如 prometheus、zabbix 等 |
|
|
10031
|
+
| title | string | 是 | 告警标题 |
|
|
10032
|
+
| title_rule | string | 否 | 标题规则 |
|
|
10033
|
+
| description | string | 否 | 告警描述 |
|
|
10034
|
+
| alert_key | string | 是 | 告警唯一标识 |
|
|
10035
|
+
| alert_id | string | 是 | 告警 ID |
|
|
10036
|
+
| event_severity | string | 是 | 事件严重程度，枚举值：Critical、Warning、Info |
|
|
10037
|
+
| event_status | string | 是 | 事件状态，枚举值：Critical、Warning、Info、Ok |
|
|
10038
|
+
| event_time | int64 | 是 | 事件时间，Unix 秒时间戳 |
|
|
10039
|
+
| labels | map[string]string | 否 | 告警原始标签 KV |
|
|
10040
|
+
| images | []string | 否 | 告警关联图片列表 |
|
|
10041
|
+
|
|
10042
|
+
</div>
|
|
10043
|
+
|
|
10044
|
+
### 请求示例
|
|
10045
|
+
|
|
10046
|
+
<div class="md-block">
|
|
10047
|
+
|
|
10048
|
+
\`\`\`json
|
|
10049
|
+
{
|
|
10050
|
+
"result_label_keys": ["owner_team", "service_tier", "host_ip"],
|
|
10051
|
+
"event": {
|
|
10052
|
+
"account_id": 1,
|
|
10053
|
+
"channel_id": 20,
|
|
10054
|
+
"data_source_id": 15,
|
|
10055
|
+
"data_source_type": "prometheus",
|
|
10056
|
+
"description": "CPU usage for instance '10.0.1.101:9100' is over 95%",
|
|
10057
|
+
"title": "High CPU Usage on instance 10.0.1.101:9100",
|
|
10058
|
+
"title_rule": "",
|
|
10059
|
+
"alert_key": "d41d8cd98f00b204e9800998ecf8427e",
|
|
10060
|
+
"alert_id": "62d6c0f6b8f1b2b3c4d5e6f7",
|
|
10061
|
+
"event_severity": "Critical",
|
|
10062
|
+
"event_status": "Critical",
|
|
10063
|
+
"event_time": 1678886400,
|
|
10064
|
+
"labels": {
|
|
10065
|
+
"region": "us-east-1",
|
|
10066
|
+
"service": "service-A",
|
|
10067
|
+
"env": "production",
|
|
10068
|
+
"instance": "10.0.1.101:9100"
|
|
10069
|
+
},
|
|
10070
|
+
"images": []
|
|
10071
|
+
}
|
|
10072
|
+
}
|
|
10073
|
+
\`\`\`
|
|
10074
|
+
|
|
10075
|
+
</div>
|
|
10076
|
+
|
|
10077
|
+
### 响应规范
|
|
10078
|
+
|
|
10079
|
+
<div class="md-block">
|
|
10080
|
+
|
|
10081
|
+
**成功响应：**
|
|
10082
|
+
|
|
10083
|
+
| 字段 | 类型 | 必含 | 释义 |
|
|
10084
|
+
| :--------: | :-------------------: | :--: | :--------- |
|
|
10085
|
+
| result_labels | map[string]string | 是 | 返回的增强标签 KV 对象 |
|
|
10086
|
+
|
|
10087
|
+
- HTTP 状态码：\`200 OK\`
|
|
10088
|
+
- 响应体必须是包含 \`result_labels\` 字段的 JSON 对象
|
|
10089
|
+
- \`result_labels\` 的 Key 必须是请求中 \`result_label_keys\` 指定的标签名
|
|
10090
|
+
- 如果某个标签无法获取，**不应**在响应中包含该 Key
|
|
10091
|
+
|
|
10092
|
+
**成功响应示例：**
|
|
10093
|
+
|
|
10094
|
+
\`\`\`json
|
|
10095
|
+
{
|
|
10096
|
+
"result_labels": {
|
|
10097
|
+
"owner_team": "team-database",
|
|
10098
|
+
"service_tier": "tier-1",
|
|
10099
|
+
"host_ip": "10.0.1.101"
|
|
10100
|
+
}
|
|
10101
|
+
}
|
|
10102
|
+
\`\`\`
|
|
10103
|
+
|
|
10104
|
+
**失败响应：**
|
|
10105
|
+
|
|
10106
|
+
| 状态码 | 含义 |
|
|
10107
|
+
| :--------: | :--------- |
|
|
10108
|
+
| 404 Not Found | 根据 event 信息无法找到任何可用于增强的数据 |
|
|
10109
|
+
| 400 Bad Request | 请求体格式错误或 event 对象缺少关键字段 |
|
|
10110
|
+
| 5xx | API 内部发生非预期的错误（如数据库连接失败） |
|
|
10111
|
+
|
|
10112
|
+
> **提示：** 返回 \`200 OK\` 状态码 + 空的 \`result_labels: {}\` 对象也会被视为"无结果"，但使用 \`404\` 状态码是更规范的做法。
|
|
10113
|
+
|
|
10114
|
+
</div>
|
|
10115
|
+
|
|
10116
|
+
<span id="ServiceConfig"></span>
|
|
10117
|
+
|
|
10118
|
+
## 三、配置映射服务
|
|
10119
|
+
|
|
10120
|
+
在 Flashduty 中配置标签映射时，您需要先创建一个映射服务，然后在标签增强规则中引用该服务。
|
|
10121
|
+
|
|
10122
|
+
### 映射服务字段说明
|
|
10123
|
+
|
|
10124
|
+
<div class="md-block">
|
|
10125
|
+
|
|
10126
|
+
| 字段名 | 类型 | 必填 | 释义 |
|
|
10127
|
+
| :--------: | :-------------------: | :--: | :--------- |
|
|
10128
|
+
| api_name | string | 是 | 服务的可读名称，用于在 UI 中选择和引用，例如 "CMDB 资产查询 API" |
|
|
10129
|
+
| description | string | 否 | 对该服务的详细描述 |
|
|
10130
|
+
| url | string | 是 | API 的请求 URL，支持使用模板变量 |
|
|
10131
|
+
| headers | map[string]string | 否 | HTTP 请求头，用于传递自定义认证信息，受[安全黑名单](#HeaderBlacklist)限制 |
|
|
10132
|
+
| timeout | int | 否 | 请求超时时间（单位：秒），可取值：1~3 |
|
|
10133
|
+
| retry_count | int | 否 | 请求失败后的重试次数，可取值：0~1 |
|
|
10134
|
+
| insecure_skip_verify | bool | 否 | 请求 HTTPS 时跳过证书验证 |
|
|
10135
|
+
| status | string | 否 | 服务状态，如 enabled、disabled |
|
|
10136
|
+
|
|
10137
|
+
</div>
|
|
10138
|
+
|
|
10139
|
+
### 标签增强规则配置
|
|
10140
|
+
|
|
10141
|
+
配置标签增强规则时，只需要关注以下配置：
|
|
10142
|
+
|
|
10143
|
+
1. **result_label_keys**：指定期望从 API 获取的标签列表，Flashduty 会自动将此列表和当前的 \`event\` 对象组合成请求体发送给您的 API
|
|
10144
|
+
2. **映射服务**：选择或配置 API 服务的 URL、Headers 等信息
|
|
10145
|
+
|
|
10146
|
+
<span id="HeaderBlacklist"></span>
|
|
10147
|
+
|
|
10148
|
+
## 四、Header 安全约束
|
|
10149
|
+
|
|
10150
|
+
为了防止安全绕过、请求走私、IP 伪造及缓存污染，在自定义 API 请求头时，**禁止**使用以下 Header。系统网关将自动过滤或拒绝包含这些 Header 的请求。
|
|
10151
|
+
|
|
10152
|
+
<div class="md-block">
|
|
10153
|
+
|
|
10154
|
+
| 分类 | 禁用 Header | 风险说明 |
|
|
10155
|
+
| :--- | :--- | :--- |
|
|
10156
|
+
| **认证与授权** | \`authorization\`, \`proxy-authorization\`, \`cookie\`, \`x-api-key\`, \`x-access-token\` | 防止凭证泄露或非法劫持已有的认证上下文 |
|
|
10157
|
+
| **IP 与地理位置伪造** | \`x-forwarded-for\`, \`x-real-ip\`, \`true-client-ip\`, \`x-client-ip\` | 防止客户端伪造来源 IP 以绕过频率限制或黑白名单 |
|
|
10158
|
+
| **主机与路由操控** | \`host\`, \`x-forwarded-host\`, \`x-forwarded-proto\`, \`x-internal-id\`, \`x-user-id\` | 防止 Host 注入攻击、重定向循环或伪造内部系统 ID |
|
|
10159
|
+
| **协议与请求走私** | \`transfer-encoding\`, \`upgrade\`, \`connection\` | 防止利用 HTTP 协议差异进行的请求走私攻击 |
|
|
10160
|
+
|
|
10161
|
+
</div>
|
|
10162
|
+
|
|
10163
|
+
### Header 最佳实践
|
|
10164
|
+
|
|
10165
|
+
1. **白名单模式**：建议仅允许以 \`X-Custom-\` 或 \`X-Enrich-\` 为前缀的自定义 Header
|
|
10166
|
+
2. **长度限制**：单个 Header 的 Key 长度不应超过 1024 字节, Value 长度不应超过 4096 字节
|
|
10167
|
+
3. **格式校验**：Header 的 Value 严禁包含换行符（\`\\r\`、\`\\n\`），以防止 Header 注入攻击
|
|
10168
|
+
|
|
10169
|
+
## 五、最佳实践
|
|
10170
|
+
|
|
10171
|
+
1. **性能优先：** 此 API 位于告警处理的关键路径上，必须保证低延迟。对外部数据源的查询应尽可能快，建议实现缓存机制。
|
|
10172
|
+
|
|
10173
|
+
2. **明确的错误处理：** 善用 HTTP 状态码（特别是 \`404\`）来传递清晰的执行结果。
|
|
10174
|
+
|
|
10175
|
+
3. **幂等性：** API 的设计应尽可能幂等。对于同一个 \`event\`，多次调用应返回相同的结果。
|
|
10176
|
+
|
|
10177
|
+
4. **安全性：** API 必须通过认证和授权机制进行保护，推荐使用自定义 Header（如 \`X-Custom-Auth\`）传递认证信息。
|
|
10178
|
+
|
|
10179
|
+
## 六、常见问题
|
|
10180
|
+
|
|
10181
|
+
1. **服务是否有响应超时时间？**
|
|
10182
|
+
|
|
10183
|
+
- 服务需要在配置的超时时间内返回响应，超时则认为响应失败
|
|
10184
|
+
|
|
10185
|
+
2. **如果 API 返回失败会怎样？**
|
|
10186
|
+
|
|
10187
|
+
- 告警会正常处理，但不会附加增强标签
|
|
10188
|
+
- 根据配置的重试次数，系统可能会重试请求
|
|
10189
|
+
|
|
10190
|
+
3. **result_label_keys 可以动态变化吗？**
|
|
10191
|
+
|
|
10192
|
+
- 是的，您可以在 Flashduty 中随时修改期望获取的标签列表，无需修改 API 代码
|
|
10193
|
+
`,kn={CustomAlert:n,Email:t,N9e:e,Prometheus:a,Grafana:s,Zabbix:i,UptimeKuma:d,AliyunARMS:l,AliyunCmEvent:o,AliyunCm:r,AliyunSLS:c,AWSCW:u,AzureMonitor:h,BaiDuBCM:p,HuaWeiCES:g,InfluxDB:m,OpenFalcon:y,PagerDuty:f,TencentBK:b,TencentCLS:v,TencentCm:_,TencentEb:w,OceanBase:k,Graylog:F,Skywalking:x,Sentry:S,Jiankongbao:T,AWSEventBridge:I,Dynatrace:A,HuaweiyunLTS:C,GoogleCM:P,Splunk:L,AppDynamics:D,SolarWinds:N,VolcEngineMetric:R,VolcEngineEvent:$,VolcEngineTLS:M,OpManager:E,Meraki:U,Zilliz:H,StateCloud:W,Guance:z,CustomChange:dn,Jira:ln,Lark:on,Dingtalk:rn,Wecom:cn,Slack:un,MicrosoftTeams:hn,AlertWebhook:pn,IncidentWebhook:gn,CustomAction:mn,Templates:vn,HuaweiyunAPM:O,JiraSync:yn,ZStack:j,Keep:q,ElastAlert2:V,DingtalkAlert:B,FeishuAlert:G,VolcEngineDetect:K,Link:_n,ServiceNowSync:fn,Monit:J,Rum:Z,Cloudflare:X,WecomAlert:Y,ServiceDeskPlusSync:bn,Harbor:Q,LabelMappingAPI:wn,VolcEngineRTC:nn,UcloudCloudWatch:tn,Nagios:en,JDCloudMonitor:an,AliyunPrometheus:sn};module.exports=kn;
|