flashduty-knowledge-base 1.3.0 → 1.3.2
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/dist/en.d.ts +4 -0
- package/dist/esm/en.js +435 -29
- package/dist/esm/zh.js +435 -28
- package/dist/iife/en.js +410 -4
- package/dist/iife/zh.js +410 -3
- package/dist/zh.d.ts +4 -0
- package/package.json +1 -1
package/dist/esm/zh.js
CHANGED
|
@@ -3180,7 +3180,7 @@ hooks:
|
|
|
3180
3180
|
|
|
3181
3181
|
|
|
3182
3182
|
</div>
|
|
3183
|
-
`,
|
|
3183
|
+
`,S=`---
|
|
3184
3184
|
title: "Sentry 告警事件"
|
|
3185
3185
|
description: "通过 webhook 的方式同步 Sentry 告警事件到 Flashduty,实现告警事件自动化降噪处理"
|
|
3186
3186
|
date: "2024-07-05T10:00:00+08:00"
|
|
@@ -3291,7 +3291,7 @@ Sentry 提供了两类告警机制:Issue Alerts 和 Metric Alerts。Issue Aler
|
|
|
3291
3291
|
|resolved|Ok|恢复|
|
|
3292
3292
|
|
|
3293
3293
|
</div>
|
|
3294
|
-
`,
|
|
3294
|
+
`,T=`---
|
|
3295
3295
|
title: "监控宝告警事件"
|
|
3296
3296
|
description: "通过 webhook 的方式同步监控宝告警事件到 Flashduty,实现告警事件自动化降噪处理"
|
|
3297
3297
|
date: "2024-08-20T10:00:00+08:00"
|
|
@@ -3386,7 +3386,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/jiankongbao-integration-guide"
|
|
|
3386
3386
|
|2|Info|提醒|
|
|
3387
3387
|
|
|
3388
3388
|
</div>
|
|
3389
|
-
`,
|
|
3389
|
+
`,A=`---
|
|
3390
3390
|
title: "AWS EventBridge 告警事件"
|
|
3391
3391
|
description: "通过 webhook 的方式同步 AWS EventBridge 告警事件到 Flashduty,实现告警事件自动化降噪处理"
|
|
3392
3392
|
date: "2024-08-20T10:00:00+08:00"
|
|
@@ -3445,7 +3445,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/aws-eventbridge-integration-guide
|
|
|
3445
3445
|
### 步骤1:在 API destinations 中创建 Connerction
|
|
3446
3446
|
1. 登录您的 AWS 控制台,检索 \`Amazon Eventbridge\` 产品,并进入对应产品控制台。
|
|
3447
3447
|
2. 在左侧导航栏选择 \`Integration=>API destinations\`。
|
|
3448
|
-
3. 点击 \`
|
|
3448
|
+
3. 点击 \`connection\`,并点击 \`Create connection\` 创建链接。
|
|
3449
3449
|
|
|
3450
3450
|
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/aws-eb-3.png" />
|
|
3451
3451
|
|
|
@@ -3491,7 +3491,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/aws-eventbridge-integration-guide
|
|
|
3491
3491
|
|
|
3492
3492
|
</div>
|
|
3493
3493
|
|
|
3494
|
-
`,
|
|
3494
|
+
`,I=`---
|
|
3495
3495
|
title: "Dynatrace 告警事件"
|
|
3496
3496
|
description: "通过 webhook 的方式同步 Dynatrace 告警事件到 Flashduty,实现告警事件自动化降噪处理。"
|
|
3497
3497
|
date: "2024-08-20T10:00:00+08:00"
|
|
@@ -3605,7 +3605,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/dynatrace-integration-guide"
|
|
|
3605
3605
|
|CUSTOM_ALERT|Info|提醒|
|
|
3606
3606
|
|
|
3607
3607
|
</div>
|
|
3608
|
-
`,
|
|
3608
|
+
`,C=`---
|
|
3609
3609
|
title: "华为云日志服务 LTS 告警事件"
|
|
3610
3610
|
description: "通过 webhook 的方式同步华为云日志服务 LTS 告警事件到 Flashduty,实现告警事件自动化降噪处理。"
|
|
3611
3611
|
date: "2024-08-20T10:00:00+08:00"
|
|
@@ -4164,7 +4164,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/solarwinds-integration-guide"
|
|
|
4164
4164
|
|Info|Info|提醒|
|
|
4165
4165
|
|
|
4166
4166
|
</div>
|
|
4167
|
-
`,
|
|
4167
|
+
`,N=`---
|
|
4168
4168
|
title: "火山引擎云监控告警事件"
|
|
4169
4169
|
description: "通过 webhook 的方式同步火山引擎云监控告警事件到 Flashduty,实现告警事件自动化降噪处理"
|
|
4170
4170
|
date: "2024-08-20T10:00:00+08:00"
|
|
@@ -4255,7 +4255,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-metric-integration-gui
|
|
|
4255
4255
|
|通知|Info|提醒|
|
|
4256
4256
|
|
|
4257
4257
|
</div>
|
|
4258
|
-
`,
|
|
4258
|
+
`,R=`---
|
|
4259
4259
|
title: "火山引擎云监控事件中心告警事件"
|
|
4260
4260
|
description: "通过 webhook 的方式同步火山引擎云监控事件中心告警事件到 Flashduty,实现告警事件自动化降噪处理"
|
|
4261
4261
|
date: "2024-07-05T10:00:00+08:00"
|
|
@@ -4344,7 +4344,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-event-integration-guid
|
|
|
4344
4344
|
|通知|Info|提醒|
|
|
4345
4345
|
|
|
4346
4346
|
</div>
|
|
4347
|
-
|
|
4347
|
+
`,E=`---
|
|
4348
4348
|
title: "火山引擎日志服务 TLS 告警事件"
|
|
4349
4349
|
description: "通过 webhook 的方式同步火山引擎日志服务 TLS 告警事件到 Flashduty,实现告警事件自动化降噪处理"
|
|
4350
4350
|
date: "2024-07-05T10:00:00+08:00"
|
|
@@ -4616,7 +4616,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/opmanager-integration-guide"
|
|
|
4616
4616
|
| Attention | Info | 提醒 |
|
|
4617
4617
|
|
|
4618
4618
|
</div>
|
|
4619
|
-
`,
|
|
4619
|
+
`,j=`---
|
|
4620
4620
|
title: "Meraki 告警事件"
|
|
4621
4621
|
description: "通过 webhook 的方式同步 Meraki 告警事件到 Flashduty,实现告警事件自动化降噪处理"
|
|
4622
4622
|
date: "2024-07-05T10:00:00+08:00"
|
|
@@ -4692,7 +4692,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/meraki-integration-guide"
|
|
|
4692
4692
|
| informational | Info | 提醒 |
|
|
4693
4693
|
|
|
4694
4694
|
</div>
|
|
4695
|
-
|
|
4695
|
+
`,$=`---
|
|
4696
4696
|
title: "天翼云告警事件"
|
|
4697
4697
|
description: "通过 webhook 的方式同步天翼云告警事件到 Flashduty,实现告警事件自动化降噪处理"
|
|
4698
4698
|
date: "2024-07-05T10:00:00+08:00"
|
|
@@ -4780,7 +4780,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/statecloud-integration-guide"
|
|
|
4780
4780
|
|
|
4781
4781
|
|
|
4782
4782
|
</div>
|
|
4783
|
-
`,
|
|
4783
|
+
`,z=`---
|
|
4784
4784
|
title: "观测云告警事件"
|
|
4785
4785
|
description: "通过 webhook 的方式同步观测云告警事件到 Flashduty,实现告警事件自动化降噪处理"
|
|
4786
4786
|
date: "2024-07-05T10:00:00+08:00"
|
|
@@ -5425,7 +5425,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/dingtalk-alert-integration-guide"
|
|
|
5425
5425
|
|
|
5426
5426
|
当前钉钉告警集成推送到 Flashduty 的严重程度均为Warning。
|
|
5427
5427
|
|
|
5428
|
-
`,
|
|
5428
|
+
`,G=`---
|
|
5429
5429
|
title: "飞书告警集成"
|
|
5430
5430
|
description: "在 Flashduty 生成唯一的飞书机器人地址,通过飞书的方式将告警的发生与恢复同步到 Flashduty"
|
|
5431
5431
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -5508,7 +5508,132 @@ url: "https://docs.flashcat.cloud/zh/flashduty/feishu-alert-integration-guide"
|
|
|
5508
5508
|
|
|
5509
5509
|
当前飞书告警集成推送到 Flashduty 的严重程度均为 Warning。
|
|
5510
5510
|
|
|
5511
|
-
`,
|
|
5511
|
+
`,J=`---
|
|
5512
|
+
title: "火山引擎云拨测告警事件"
|
|
5513
|
+
description: "通过 webhook 的方式同步 火山引擎云拨测的告警事件到 Flashduty,实现告警事件自动化降噪处理"
|
|
5514
|
+
date: "2024-07-05T10:00:00+08:00"
|
|
5515
|
+
url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-detect-integration-guide"
|
|
5516
|
+
---
|
|
5517
|
+
|
|
5518
|
+
通过 webhook 的方式同步 火山引擎云拨测的告警事件到 Flashduty,实现告警事件自动化降噪处理。
|
|
5519
|
+
|
|
5520
|
+
<div class="hide">
|
|
5521
|
+
|
|
5522
|
+
## 在 Flashduty
|
|
5523
|
+
---
|
|
5524
|
+
您可通过以下2种方式,获取一个集成推送地址,任选其一即可。
|
|
5525
|
+
|
|
5526
|
+
### 使用专属集成
|
|
5527
|
+
|
|
5528
|
+
当您不需要将告警事件路由到不同的协作空间,优先选择此方式,更简单。
|
|
5529
|
+
|
|
5530
|
+
<details>
|
|
5531
|
+
<summary>展开</summary>
|
|
5532
|
+
|
|
5533
|
+
1. 进入 Flashduty 控制台,选择 **协作空间**,进入某个空间的详情页面
|
|
5534
|
+
2. 选择 **集成数据** tab,点击 **添加一个集成**,进入添加集成页面
|
|
5535
|
+
3. 选择 **火山引擎云拨测** 集成,点击 **保存**,生成卡片。
|
|
5536
|
+
4. 点击生成的卡片,可以查看到 **推送地址**,复制备用,完成。
|
|
5537
|
+
|
|
5538
|
+
|
|
5539
|
+
</details>
|
|
5540
|
+
|
|
5541
|
+
### 使用共享集成
|
|
5542
|
+
|
|
5543
|
+
当您需要根据告警事件的 Payload 信息,将告警路由到不同的协作空间,优先选择此方式。
|
|
5544
|
+
|
|
5545
|
+
<details>
|
|
5546
|
+
<summary>展开</summary>
|
|
5547
|
+
|
|
5548
|
+
1. 进入 Flashduty 控制台,选择 **集成中心=>告警事件**,进入集成选择页面。
|
|
5549
|
+
2. 选择 **火山引擎云拨测** 集成:
|
|
5550
|
+
- **集成名称**:为当前集成定义一个名称。
|
|
5551
|
+
3. 配置默认路由,并选择对应的协作空间(集成创建后可以前往 \`路由\` 进行更多路由规则的配置)。
|
|
5552
|
+
4. 点击 **保存** 后,复制当前页面的新生成的 **推送地址** 备用。
|
|
5553
|
+
5. 完成。
|
|
5554
|
+
|
|
5555
|
+
</details>
|
|
5556
|
+
</div>
|
|
5557
|
+
|
|
5558
|
+
## 在 火山引擎
|
|
5559
|
+
---
|
|
5560
|
+
|
|
5561
|
+
<div class="md-block">
|
|
5562
|
+
|
|
5563
|
+
## 一、告警推送配置
|
|
5564
|
+
|
|
5565
|
+
### 步骤1:创建通知对象
|
|
5566
|
+
|
|
5567
|
+
1. 登录您的 \`火山引擎\` 控制台,在 \`告警管理\` 菜单中,找到 \`通知对象管理\`。
|
|
5568
|
+
2. 点击 \`系统集成\`,点击\`创建系统集成\`或编辑已有的通知对象。
|
|
5569
|
+
3. 在编辑页面中,名称填写 \`Flashduty\` ,\`回调 URL\` 处填写告警集成的<span class='integration_url'>推送地址</span>。
|
|
5570
|
+
4. 点击 \`确定\` 完成配置。
|
|
5571
|
+
|
|
5572
|
+
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/zh/fd/volcengine-1.png" />
|
|
5573
|
+
|
|
5574
|
+
### 步骤2:在告警策略中使用通知对象
|
|
5575
|
+
|
|
5576
|
+
1. 登录您的 \`火山引擎\` 控制台,在 \`告警管理\` 菜单中,找到 \`告警策略\`。
|
|
5577
|
+
2. 点击\`创建告警策略\`或编辑已有的报警器。
|
|
5578
|
+
3. 在编辑页面中,\`通知对象\` 处选择创建的 \`Flashduty\` 通知对象。
|
|
5579
|
+
4. 其他按需配置即可,点击 \`确定\` 完成配置。
|
|
5580
|
+
|
|
5581
|
+
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/zh/fd/volcengine-2.png" />
|
|
5582
|
+
|
|
5583
|
+
|
|
5584
|
+
|
|
5585
|
+
</dev>
|
|
5586
|
+
|
|
5587
|
+
## 二、状态对照
|
|
5588
|
+
|
|
5589
|
+
<div class="md-block">
|
|
5590
|
+
|
|
5591
|
+
| 火山引擎 | Flashduty | 状态 |
|
|
5592
|
+
| ---------- | -------- | ---- |
|
|
5593
|
+
| 严重告警 | Critical | 严重 |
|
|
5594
|
+
| 普通告警 | Warning | 警告 |
|
|
5595
|
+
|
|
5596
|
+
</div>
|
|
5597
|
+
|
|
5598
|
+
`,K=`---
|
|
5599
|
+
title: "Monit 告警集成"
|
|
5600
|
+
description: "Flashduty Monit 告警集成,Monit 服务通过此集成上报告警"
|
|
5601
|
+
date: "2025-05-19T10:00:00+08:00"
|
|
5602
|
+
url: "https://docs.flashcat.cloud/zh/flashduty/monit-alert-integration-guide"
|
|
5603
|
+
---
|
|
5604
|
+
|
|
5605
|
+
当您开通 Monit 服务时,系统会自动为您创建此集成。此集成用于收集 Monit 服务产生的告警事件。
|
|
5606
|
+
|
|
5607
|
+
:::tips
|
|
5608
|
+
您无法修改或删除此集成。但您可以管理集成下的标签增强、告警处理以及路由等规则。
|
|
5609
|
+
:::
|
|
5610
|
+
|
|
5611
|
+
## 如何开启 Monit 告警
|
|
5612
|
+
|
|
5613
|
+
前往\`Monit\`-\`告警规则\`-\`规则详情\`页面,配置监控指标和阈值等条件,并开启告警。您可以选择将告警投递至多个协作空间。告警的通知规则遵循协作空间下的分派策略,您可以为团队设定值班人员,在告警发生时分派给值班人。
|
|
5614
|
+
|
|
5615
|
+

|
|
5616
|
+
|
|
5617
|
+
某些情况下,您可能希望将同一个告警规则产生的告警,按条件路由到不同的协作空间,这个时候您可以选择将告警直接投递到集成,而非协作空间列表。并在当前集成下,设置路由规则。`,Z=`---
|
|
5618
|
+
title: "RUM 告警集成"
|
|
5619
|
+
description: "Flashduty RUM 告警集成,RUM 服务通过此集成上报告警"
|
|
5620
|
+
date: "2025-05-19T10:00:00+08:00"
|
|
5621
|
+
url: "https://docs.flashcat.cloud/zh/flashduty/rum-alert-integration-guide"
|
|
5622
|
+
---
|
|
5623
|
+
|
|
5624
|
+
当您开通 RUM 服务时,系统会自动为您创建此集成。此集成用于收集 RUM 服务产生的告警事件。
|
|
5625
|
+
|
|
5626
|
+
:::tips
|
|
5627
|
+
您无法修改或删除此集成。但您可以管理集成下的标签增强、告警处理以及路由等规则。
|
|
5628
|
+
:::
|
|
5629
|
+
|
|
5630
|
+
## 如何开启 RUM 告警
|
|
5631
|
+
|
|
5632
|
+
前往\`RUM\`-\`应用详情\`-\`告警设置\`页面,开启告警。您可以选择将告警投递至多个协作空间。告警的通知规则遵循协作空间下的分派策略,您可以为团队设定值班人员,在告警发生时分派给值班人。
|
|
5633
|
+
|
|
5634
|
+

|
|
5635
|
+
|
|
5636
|
+
更多内容,请您参考 [RUM Issue 告警](https://docs.flashcat.cloud/zh/flashduty/rum/issue-alerting)。`,Q=`---
|
|
5512
5637
|
title: "自定义变更事件集成指引"
|
|
5513
5638
|
description: "通过标准协议推送自有系统变更事件到 Flashduty,大部分故障由变更导致,变更和告警事件联动有助于快速定位故障原因。"
|
|
5514
5639
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -5565,7 +5690,7 @@ Flashduty 已经适配部分常用工单、部署系统的 webhook 协议,对
|
|
|
5565
5690
|
|
|
5566
5691
|
</details>
|
|
5567
5692
|
|
|
5568
|
-
`,
|
|
5693
|
+
`,X=`---
|
|
5569
5694
|
title: "Jira 事件集成指引"
|
|
5570
5695
|
description: "通过 webhook 的方式同步 Jira Issue 事件到 Flashduty,实现变更事件收集。"
|
|
5571
5696
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -5639,7 +5764,7 @@ Flashduty 默认提取 webhook payload 中 status.name 信息,并按照下边
|
|
|
5639
5764
|
如您希望变更此映射关系,请联系 Flashduty。
|
|
5640
5765
|
|
|
5641
5766
|
</div>
|
|
5642
|
-
`,
|
|
5767
|
+
`,Y=`---
|
|
5643
5768
|
title: Contributing to our documentation — Meilisearch documentation
|
|
5644
5769
|
description: The Meilisearch documentation is open-source. Learn how to help make it even better.
|
|
5645
5770
|
sidebarDepth: 3
|
|
@@ -5776,7 +5901,7 @@ sidebarDepth: 3
|
|
|
5776
5901
|
|给同一个用户或同一个群发消息|最高频率 5 次/秒|
|
|
5777
5902
|
|
|
5778
5903
|
**注意:** 超出限制后将无法正常推送消息,建议合理使用通知渠道
|
|
5779
|
-
`,
|
|
5904
|
+
`,nn=`---
|
|
5780
5905
|
title: "钉钉集成"
|
|
5781
5906
|
description: "通过集成钉钉自建应用,实现在钉钉端内接收和响应告警的能力"
|
|
5782
5907
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -5937,7 +6062,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/dingtalk-integration-guide"
|
|
|
5937
6062
|
|专属版|550万次|60| 每月1日 |
|
|
5938
6063
|
|
|
5939
6064
|
**注意:** 超出限制后将无法正常推送消息,建议合理使用通知渠道
|
|
5940
|
-
`,
|
|
6065
|
+
`,tn=`---
|
|
5941
6066
|
title: "企业微信集成"
|
|
5942
6067
|
description: "通过集成企业微信第三方应用,实现在企业微信端内接收和响应告警的能力"
|
|
5943
6068
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -6017,7 +6142,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/wecom-integration-guide"
|
|
|
6017
6142
|
7. **故障通知失败,提示\`未开通企微许可\`?**
|
|
6018
6143
|
|
|
6019
6144
|
- 联系 Flashduty 客服或专属支持,为您购买开通
|
|
6020
|
-
`,
|
|
6145
|
+
`,en=`---
|
|
6021
6146
|
title: "Slack 集成"
|
|
6022
6147
|
description: "通过集成Slack第三方应用,实现在Slack内接收和响应告警的能力"
|
|
6023
6148
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -6071,7 +6196,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/slack-integration-guide"
|
|
|
6071
6196
|
|
|
6072
6197
|
8. **Slack App 内 Other questions,报错**
|
|
6073
6198
|
- 重新操作,遇到了还没被记录的问题
|
|
6074
|
-
- 重试后仍然报错,联系客服`,
|
|
6199
|
+
- 重试后仍然报错,联系客服`,an=`---
|
|
6075
6200
|
title: "Microsoft Teams集成"
|
|
6076
6201
|
description: "通过集成 Microsoft Teams 第三方应用,实现在 Microsoft Teams 内接收和响应告警的能力"
|
|
6077
6202
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -6202,7 +6327,7 @@ Microsoft Teams 集成现处于 Beta 阶段,在关联前您需要先完成以
|
|
|
6202
6327
|
暂不支持
|
|
6203
6328
|
</details>
|
|
6204
6329
|
|
|
6205
|
-
`,
|
|
6330
|
+
`,sn=`配置告警 Webhook,当告警发生特定操作(如触发、关闭)时,系统通过 HTTP 回调您配置的地址。回调内容将包含告警最新关键信息,您可以与自研工具进行集成。
|
|
6206
6331
|
|
|
6207
6332
|
<span id="EventTypes"></span>
|
|
6208
6333
|
|
|
@@ -6370,7 +6495,7 @@ curl -X POST 'https://example.com/alert/webhook?a=a' \\
|
|
|
6370
6495
|
4. **推送来源可信 IP 白名单?**
|
|
6371
6496
|
- {ip_whitelist}
|
|
6372
6497
|
- 未来可能会更新,请定期查验
|
|
6373
|
-
`,
|
|
6498
|
+
`,ln=`配置故障 Webhook,当故障发生特定操作(如触发、关闭)时,系统通过 HTTP 回调您配置的地址。回调内容将包含故障最新关键信息,您可以与自研工具进行集成。
|
|
6374
6499
|
|
|
6375
6500
|
<span id="EventTypes"></span>
|
|
6376
6501
|
|
|
@@ -6470,7 +6595,7 @@ acknowledged_at | int64| 否 | 认领时间
|
|
|
6470
6595
|
| fields | map[string]interface{} | 否 | 自定义字段 KV,Key 为字符串,Value 可能为任意类型,取决于字段类型|
|
|
6471
6596
|
| creator | [Person](#Person) | 否 | 创建人员信息,仅手动创建故障时存在 |
|
|
6472
6597
|
| closer | [Person](#Person) | 否 | 关闭人员信息,仅手动关闭故障时存在 |
|
|
6473
|
-
| responders | [][Responder](#Responder) | 否 |
|
|
6598
|
+
| responders | [][Responder](#Responder) | 否 | 处理人员信息列表,仅故障被分派后存在。对于i_new事件,此值可能为空 |
|
|
6474
6599
|
| alert_cnt | int64 | 否 | 关联告警个数 |
|
|
6475
6600
|
| channel_id | int64 | 否 | 协作空间ID,为0代表不属于任何空间 |
|
|
6476
6601
|
| channel_name | string | 否 | 协作空间名称 |
|
|
@@ -6578,7 +6703,7 @@ curl -X POST 'https://example.com/incident/webhook?a=a' \\
|
|
|
6578
6703
|
|
|
6579
6704
|
4. **推送来源可信 IP 白名单?**
|
|
6580
6705
|
- {ip_whitelist}
|
|
6581
|
-
- 未来可能会更新,请定期查验`,
|
|
6706
|
+
- 未来可能会更新,请定期查验`,dn=`配置故障 自定义操作,允许您在故障排查期间,快速调用外部接口,实现故障自愈、信息丰富等任何自定义操作。
|
|
6582
6707
|
|
|
6583
6708
|
## 一、创建操作
|
|
6584
6709
|
|
|
@@ -6837,7 +6962,7 @@ curl -X POST 'https://example.com/incident/action?a=a' \\
|
|
|
6837
6962
|
|
|
6838
6963
|
2. **推送来源可信 IP 白名单?**
|
|
6839
6964
|
- {ip_whitelist}
|
|
6840
|
-
- 未来可能会更新,请定期查验`,
|
|
6965
|
+
- 未来可能会更新,请定期查验`,on=`---
|
|
6841
6966
|
title: "Jira 同步"
|
|
6842
6967
|
description: "通过 Jira 同步 Webhook,实现故障与 Jira Issue 的关联。"
|
|
6843
6968
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -6922,7 +7047,289 @@ url: "https://docs.flashcat.cloud/zh/flashduty/jira-sync"
|
|
|
6922
7047
|
|
|
6923
7048
|
- Flashduty 会按照默认的字段映射以及您配置的自定义字段映射进行同步信息,如果您的 Jira 事务类型中有必选的字段且没有配置映射关系,则会遇到创建 Jira Issue 失败的情况。
|
|
6924
7049
|
- Jira 的 Issue 详情是基于项目 KEY + 编号的格式进行访问的,如果您修改了项目 KEY,可能无法通过 Flashduty 中保存的 Issue 地址进行访问,请谨慎修改项目 KEY。
|
|
6925
|
-
`,
|
|
7050
|
+
`,rn=`---
|
|
7051
|
+
title: "ServiceNow 同步"
|
|
7052
|
+
description: "通过 ServiceNow 同步 Webhook,实现故障与 ServiceNow Incident 的关联。"
|
|
7053
|
+
date: "2025-05-19T10:00:00+08:00"
|
|
7054
|
+
url: "https://docs.flashcat.cloud/zh/flashduty/service-now-sync"
|
|
7055
|
+
---
|
|
7056
|
+
|
|
7057
|
+
通过 ServiceNow 同步 Webhook,将 Flashduty 的故障与 ServiceNow Incident 进行关联同步,实现 Flashduty 与 ServiceNow 的联动。
|
|
7058
|
+
|
|
7059
|
+
## 在 ServiceNow
|
|
7060
|
+
|
|
7061
|
+
### 创建用户
|
|
7062
|
+
|
|
7063
|
+
1. 登录 ServiceNow 实例控制台,通过选择 \`ALL\` ,输入 \`USERS\` 选择\`Organization\`-\`Users\` 。
|
|
7064
|
+
2. 点击 \`New\` 新建用户。
|
|
7065
|
+
3. 在编辑页面中,\`User ID\` 输入:flashduty 。
|
|
7066
|
+
4. \`Password needs reset\` 和 \`Web service access only\` 以及 \`Internal Integration User\` 保持取消勾选状态。
|
|
7067
|
+
5. 提交保存。
|
|
7068
|
+
|
|
7069
|
+
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/snow/snow-1.png" />
|
|
7070
|
+
|
|
7071
|
+
### 配置用户
|
|
7072
|
+
|
|
7073
|
+
用于访问 ServiceNow 的用户需要是管理员角色。
|
|
7074
|
+
|
|
7075
|
+
1. 在用户列表页面,找到新创建的 \`flashduty\` 用户并进到配置页面。
|
|
7076
|
+
2. 在编辑页面中,点击 \`Set Password\` 设置一个密码。
|
|
7077
|
+
3. 点击 \`Roles\` 添加 **admin 和 itil** 角色。
|
|
7078
|
+
4. 点击 \`Update\` 更新配置。
|
|
7079
|
+
|
|
7080
|
+
<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/snow/snow-2.png" />
|
|
7081
|
+
|
|
7082
|
+
## 在 Flashduty
|
|
7083
|
+
|
|
7084
|
+
### 配置集成
|
|
7085
|
+
|
|
7086
|
+
将以上配置的用户名/密码以及实例名称输入到左侧集成信息中并点击下一步进行配置。
|
|
7087
|
+
|
|
7088
|
+
- **集成名称:** 为当前集成定义一个名称。
|
|
7089
|
+
- **管理团队:** 当选择管理团队后,只有该团队成员以及租户管理员可以编辑此集成。
|
|
7090
|
+
- **协作空间**:选择该集成生效的协作空间,。
|
|
7091
|
+
- **同步方向:**
|
|
7092
|
+
- To_ServiceNow:将 Flashduty 的故障同步至 ServiceNow。
|
|
7093
|
+
- From_ServiceNow:将 ServiceNow 的 Incident 同步至 Flashduty。
|
|
7094
|
+
- Two-way:Flashduty 和 ServiceNow 互相同步。
|
|
7095
|
+
- **触发模式**:
|
|
7096
|
+
- 自动触发:需要配置相应的条件,Flashduty 会自动将符合条件的故障同步到 ServiceNow 中。
|
|
7097
|
+
- 手动触发:需要在故障详情页的更多操作中手动触发 ServiceNow 同步(该集成配置的名称为触发器名称)。
|
|
7098
|
+
- **严重程度映射**:ServiceNow 的 Priority 是由 Impact 和 Urgency 的值共同决定的,所以可以参考 ServiceNow 的 \`Priority Lookup Rules\` 进行配置。另外需要注意的是,只有当 ServiceNow Incident 的 Urgency 发生变化时,才会触发 Flashduty 故障严重程度的更新。
|
|
7099
|
+
- **自定义字段映射**:可以选择将故障的某些标签或所有标签以及自定义字段内容同步至 ServiceNow 的字段中(仅支持文本类型的字段)。
|
|
7100
|
+
|
|
7101
|
+
## 在 ServiceNow
|
|
7102
|
+
|
|
7103
|
+
当同步方向选择 From_ServiceNow 或 Two-way 时,还需要在 ServiceNow 中做相应的配置,以便将 ServiceNow Incident 同步至 Flashduty, 在同步至 Flashduty 时,有以下两种方式,可根据实际需求选择即可。
|
|
7104
|
+
|
|
7105
|
+
### 手动同步
|
|
7106
|
+
|
|
7107
|
+
该方式依赖 ServiceNow 提供的 UI Action 和 Script Include 的配置,根据以下步骤配置完成的效果:当新建 Incident 或更新 Incident 时,可以在功能区看到发送同步请求的按钮,触发该按钮,可以将当前 Incident 的内容同步至 Flashduty。需要注意的是,如果触发请求时遇到失败的情况,请重试(重试时间间隔需大于 10 秒)。
|
|
7108
|
+
|
|
7109
|
+
#### 配置 UI Action
|
|
7110
|
+
|
|
7111
|
+
1. 登录 ServiceNow 实例控制台,通过选择 \`ALL\` ,输入 \`UI Actions\` 选择\`System Definition\`-\`UI Actions\` 。
|
|
7112
|
+
2. 点击 \`New\` 新建 Action。
|
|
7113
|
+
3. \`Name\` 输入: **Send To Flashduty**, \`Table\` 选择 **Incident** 。
|
|
7114
|
+
4. \`Form button\` ,\`Active\` ,\`Show insert\` ,\`Show update\` ,\`Client\`, \`List v2/3 Compatible\` 保持勾选状态。
|
|
7115
|
+
5. \`Onclick\` 输入:**onClick();**。
|
|
7116
|
+
6. \`Script\` 输入:
|
|
7117
|
+
|
|
7118
|
+
\`\`\`js
|
|
7119
|
+
function onClick() {
|
|
7120
|
+
g_form.save();
|
|
7121
|
+
|
|
7122
|
+
var ga = new GlideAjax("IncidentWebhookHelperAjax");
|
|
7123
|
+
ga.addParam("sysparm_name", "sendWebhook");
|
|
7124
|
+
ga.addParam("sysparm_sys_id", g_form.getUniqueValue());
|
|
7125
|
+
|
|
7126
|
+
ga.getXMLAnswer(function (response) {
|
|
7127
|
+
alert("Webhook Triggered: " + response);
|
|
7128
|
+
});
|
|
7129
|
+
}
|
|
7130
|
+
\`\`\`
|
|
7131
|
+
|
|
7132
|
+
7. 提交保存。
|
|
7133
|
+
|
|
7134
|
+
#### 配置 Script Include
|
|
7135
|
+
|
|
7136
|
+
1. 登录 ServiceNow 实例控制台,通过选择 \`ALL\` ,输入 \`Script Includes\` 选择\`System Definition\`-\`Script Includes\` 。
|
|
7137
|
+
2. 点击 \`New\` 新建 Script Include。
|
|
7138
|
+
3. \`Name\` 输入:**IncidentWebhookHelper** , \`Accessible from\` 选择 **All application scopes**。
|
|
7139
|
+
4. \`Client callable\` 和 \`Active\` 保持勾选状态。
|
|
7140
|
+
5. \`Script\` 输入以下内容,其中 **request.setEndpoint** 中需要补充集成的推送地址:
|
|
7141
|
+
|
|
7142
|
+
<div class="hide">
|
|
7143
|
+
|
|
7144
|
+
注意: body 中配置的是默认接收字段,如果有自定义字段需要同步至 Flashduty ,需要额外手动补充内容到 body 中,比如希望添加一个字段名为:test_001 的字段(该字段名可以在配置集成中添加自定义字段的时候获取,不要使用 ServiceNow Inident 表单中显示的字段名),那么需要在 body 中补充:test_001: current.getDisplayValue("test_001")。
|
|
7145
|
+
|
|
7146
|
+
</div>
|
|
7147
|
+
|
|
7148
|
+
\`\`\`js
|
|
7149
|
+
var IncidentWebhookHelper = Class.create();
|
|
7150
|
+
IncidentWebhookHelper.prototype = {
|
|
7151
|
+
initialize: function() {},
|
|
7152
|
+
|
|
7153
|
+
sendIncidentWebhook: function(current) {
|
|
7154
|
+
function getLastComment(sysId) {
|
|
7155
|
+
var journalGR = new GlideRecord('sys_journal_field');
|
|
7156
|
+
journalGR.addQuery('element_id', sysId);
|
|
7157
|
+
journalGR.addQuery('element', 'comments');
|
|
7158
|
+
journalGR.orderByDesc('sys_created_on');
|
|
7159
|
+
journalGR.setLimit(1);
|
|
7160
|
+
journalGR.query();
|
|
7161
|
+
if (journalGR.next()) {
|
|
7162
|
+
return journalGR.getValue('value');
|
|
7163
|
+
}
|
|
7164
|
+
return '';
|
|
7165
|
+
}
|
|
7166
|
+
|
|
7167
|
+
var body = {
|
|
7168
|
+
action_type: current.isNewRecord() ? 'insert' : 'update',
|
|
7169
|
+
number: current.getValue("number"),
|
|
7170
|
+
sys_id: current.getUniqueValue(),
|
|
7171
|
+
short_description: current.getValue("short_description"),
|
|
7172
|
+
description: current.getValue("description"),
|
|
7173
|
+
impact: current.getDisplayValue("impact"),
|
|
7174
|
+
urgency: current.getDisplayValue("urgency"),
|
|
7175
|
+
comments: getLastComment(current.getUniqueValue()),
|
|
7176
|
+
<label name='field_mapping' tab='10'>{original.key}: current.getDisplayValue("{original.key}")</label>
|
|
7177
|
+
};
|
|
7178
|
+
|
|
7179
|
+
try {
|
|
7180
|
+
var request = new sn_ws.RESTMessageV2();
|
|
7181
|
+
request.setHttpMethod("POST");
|
|
7182
|
+
request.setEndpoint("PUSH URL");
|
|
7183
|
+
request.setRequestHeader("Content-Type", "application/json");
|
|
7184
|
+
request.setRequestBody(JSON.stringify(body));
|
|
7185
|
+
request.executeAsync();
|
|
7186
|
+
} catch (ex) {
|
|
7187
|
+
gs.error("Webhook Call failed: " + ex.message);
|
|
7188
|
+
}
|
|
7189
|
+
},
|
|
7190
|
+
type: 'IncidentWebhookHelper'
|
|
7191
|
+
};
|
|
7192
|
+
|
|
7193
|
+
\`\`\`
|
|
7194
|
+
|
|
7195
|
+
6. 提交保存。
|
|
7196
|
+
7. 回到 Script Includes 列表,继续创建。
|
|
7197
|
+
8. 点击 \`New\` 新建 Script Include。
|
|
7198
|
+
9. \`Name\` 输入:**IncidentWebhookHelperAjax** , \`Accessible from\` 选择 **All application scopes**。
|
|
7199
|
+
10. \`Client callable\` 和 \`Active\` 保持勾选状态。
|
|
7200
|
+
11. \`Script\` 输入以下内容:
|
|
7201
|
+
|
|
7202
|
+
\`\`\`js
|
|
7203
|
+
var IncidentWebhookHelperAjax = Class.create();
|
|
7204
|
+
IncidentWebhookHelperAjax.prototype = Object.extendsObject(
|
|
7205
|
+
global.AbstractAjaxProcessor,
|
|
7206
|
+
{
|
|
7207
|
+
sendWebhook: function () {
|
|
7208
|
+
var sysId = this.getParameter("sysparm_sys_id");
|
|
7209
|
+
var gr = new GlideRecord("incident");
|
|
7210
|
+
if (gr.get(sysId)) {
|
|
7211
|
+
var helper = new IncidentWebhookHelper();
|
|
7212
|
+
helper.sendIncidentWebhook(gr);
|
|
7213
|
+
return "Success";
|
|
7214
|
+
}
|
|
7215
|
+
return "Request failed";
|
|
7216
|
+
},
|
|
7217
|
+
}
|
|
7218
|
+
);
|
|
7219
|
+
\`\`\`
|
|
7220
|
+
|
|
7221
|
+
12. 提交保存。
|
|
7222
|
+
|
|
7223
|
+
### 自动同步
|
|
7224
|
+
|
|
7225
|
+
该方式依赖 ServiceNow 提供的 Business Rules 的配置,使用该方式可以实现当有新建或更新事件时,自动将 Incident 同步至 Flashduty。
|
|
7226
|
+
|
|
7227
|
+
#### 配置 Business Rules
|
|
7228
|
+
|
|
7229
|
+
1. 登录 ServiceNow 实例控制台,通过选择 \`ALL\` ,输入 \`Business Rules\` 选择\`System Definition\`-\`Business Rules\` 。
|
|
7230
|
+
2. 点击 \`New\` 新建 Business Rule。
|
|
7231
|
+
3. \`Name\` 输入:**Send To Flashduty** , \`Table\` 选择 **Incident**。
|
|
7232
|
+
4. \`Advanced\` 和 \`Active\` 保持勾选状态。
|
|
7233
|
+
5. 在 \`When to run\` 区域中,\`When\` 选择 **async**,\`Insert\` 和 \`Upsert\` 保持勾选状态,其他按需配置。
|
|
7234
|
+
6. 在 \`Advanced\` 区域中,\`Script\` 填写以下内容,其中 **endpoint** 中需要补充集成的推送地址:
|
|
7235
|
+
|
|
7236
|
+
<div class="hide">
|
|
7237
|
+
|
|
7238
|
+
注意: body 中配置的是默认接收字段,如果有自定义字段需要同步至 Flashduty ,需要额外手动补充内容到 body 中,比如希望添加一个字段名为:test_001 的字段(该字段名可以在配置集成中添加自定义字段的时候获取,不要使用 ServiceNow Inident 表单中显示的字段名),那么需要在 body 中补充:test_001: current.getDisplayValue("test_001")。
|
|
7239
|
+
|
|
7240
|
+
</div>
|
|
7241
|
+
|
|
7242
|
+
\`\`\`js
|
|
7243
|
+
(function executeRule(current, previous) {
|
|
7244
|
+
function getLastComment(recordSysId) {
|
|
7245
|
+
var journalGR = new GlideRecord("sys_journal_field");
|
|
7246
|
+
journalGR.addQuery("element_id", recordSysId);
|
|
7247
|
+
journalGR.addQuery("element", "comments");
|
|
7248
|
+
journalGR.orderByDesc("sys_created_on");
|
|
7249
|
+
journalGR.setLimit(1);
|
|
7250
|
+
journalGR.query();
|
|
7251
|
+
if (journalGR.next()) {
|
|
7252
|
+
var comment = journalGR.getValue("value");
|
|
7253
|
+
return comment;
|
|
7254
|
+
}
|
|
7255
|
+
return "";
|
|
7256
|
+
}
|
|
7257
|
+
|
|
7258
|
+
var operation = current.operation() || "unknown";
|
|
7259
|
+
var isPreviousNull = previous === null;
|
|
7260
|
+
var createdOn = current.getValue("sys_created_on");
|
|
7261
|
+
var updatedOn = current.getValue("sys_updated_on");
|
|
7262
|
+
var isNewRecord = createdOn === updatedOn;
|
|
7263
|
+
|
|
7264
|
+
var action = "update";
|
|
7265
|
+
if (isPreviousNull && isNewRecord) {
|
|
7266
|
+
action = "insert";
|
|
7267
|
+
}
|
|
7268
|
+
|
|
7269
|
+
var body = {
|
|
7270
|
+
action_type: action,
|
|
7271
|
+
number: current.getValue("number"),
|
|
7272
|
+
sys_id: current.getUniqueValue(),
|
|
7273
|
+
short_description: current.getValue("short_description"),
|
|
7274
|
+
description: current.getValue("description"),
|
|
7275
|
+
state: current.getDisplayValue("state"),
|
|
7276
|
+
impact: current.getDisplayValue("impact"),
|
|
7277
|
+
urgency: current.getDisplayValue("urgency"),
|
|
7278
|
+
comments: getLastComment(current.getUniqueValue()),
|
|
7279
|
+
<label name='field_mapping' tab='4'>{original.key}: current.getDisplayValue("{original.key}")</label>
|
|
7280
|
+
|
|
7281
|
+
};
|
|
7282
|
+
|
|
7283
|
+
try {
|
|
7284
|
+
var endpoint = "";
|
|
7285
|
+
var request = new sn_ws.RESTMessageV2();
|
|
7286
|
+
request.setHttpMethod("POST");
|
|
7287
|
+
request.setEndpoint(endpoint);
|
|
7288
|
+
request.setRequestHeader("Content-Type", "application/json");
|
|
7289
|
+
request.setRequestBody(JSON.stringify(body));
|
|
7290
|
+
request.executeAsync();
|
|
7291
|
+
} catch (ex) {
|
|
7292
|
+
gs.error("Error sending webhook: " + ex.message);
|
|
7293
|
+
}
|
|
7294
|
+
})(current, previous);
|
|
7295
|
+
\`\`\`
|
|
7296
|
+
|
|
7297
|
+
7. 提交保存。
|
|
7298
|
+
|
|
7299
|
+
## 同步信息
|
|
7300
|
+
|
|
7301
|
+
### 表单字段
|
|
7302
|
+
|
|
7303
|
+
| ServiceNow | Flashduty | 备注 |
|
|
7304
|
+
| ------------------- | ------------- | ---- |
|
|
7305
|
+
| Short_description | Title | |
|
|
7306
|
+
| Description | Description | |
|
|
7307
|
+
| Additional comments | Comments | |
|
|
7308
|
+
| State | Progress | |
|
|
7309
|
+
| Urgency | Severity | |
|
|
7310
|
+
| Others | Custom Fields | |
|
|
7311
|
+
|
|
7312
|
+
### 状态映射
|
|
7313
|
+
|
|
7314
|
+
| ServiceNow | Flashduty | 备注 |
|
|
7315
|
+
| ----------- | ---------- | --------------- |
|
|
7316
|
+
| New | Trigger | |
|
|
7317
|
+
| In Progress | Processing | |
|
|
7318
|
+
| On Hold | Snoozed | 默认暂缓 2 小时 |
|
|
7319
|
+
| Resolved | CLosed | |
|
|
7320
|
+
| Closed | CLosed | |
|
|
7321
|
+
| Canceled | CLosed | |
|
|
7322
|
+
|
|
7323
|
+
### 优先级映射
|
|
7324
|
+
|
|
7325
|
+
只有 ServiceNow 的 Urgency 值变化时,才会影响 Flashduty 的 Severity
|
|
7326
|
+
|
|
7327
|
+
| ServiceNow | Flashduty | 备注 |
|
|
7328
|
+
| ---------- | --------- | ---- |
|
|
7329
|
+
| Low | Info | |
|
|
7330
|
+
| Medium | Warning | |
|
|
7331
|
+
| High | Critical | |
|
|
7332
|
+
`,cn=`---
|
|
6926
7333
|
title: "配置通知模版"
|
|
6927
7334
|
description: "通过自定义配置模版,可以实现个性化通知内容的需求"
|
|
6928
7335
|
date: "2024-05-10T10:00:00+08:00"
|
|
@@ -8049,7 +8456,7 @@ msg_type 必填,值为 post
|
|
|
8049
8456
|
<img src="https://download.flashcat.cloud/flashduty/changelog/20230720/email_render.png" alt="drawing" style="display: block; margin: 0 auto;" width="500"/>
|
|
8050
8457
|
|
|
8051
8458
|
</div>
|
|
8052
|
-
`,
|
|
8459
|
+
`,un=`---
|
|
8053
8460
|
title: "Link 集成"
|
|
8054
8461
|
description: "通过 Link 集成,可直接从故障属性、标签等信息中获取访问外部链接所需的关键参数,实现快速访问"
|
|
8055
8462
|
date: "2025-05-19T10:00:00+08:00"
|
|
@@ -8106,4 +8513,4 @@ https://cmdb.com/vm?sn=VM123456
|
|
|
8106
8513
|
1. 当引用的内容不存在时,Link 集成会正常生成对应的链接,但无法获取到值
|
|
8107
8514
|
2. 同一个协作空间至多绑定三个 Link 集成
|
|
8108
8515
|
3. 注意引用语法,如未按照要求进行书写引用变量,会导致无法正常获取对应值
|
|
8109
|
-
`,
|
|
8516
|
+
`,hn={CustomAlert:n,Email:t,N9e:e,Prometheus:a,Grafana:s,Zabbix:i,UptimeKuma:l,AliyunARMS:d,AliyunCmEvent:o,AliyunCm:r,AliyunSLS:c,AWSCW:u,AzureMonitor:h,BaiDuBCM:p,HuaWeiCES:m,InfluxDB:g,OpenFalcon:y,PagerDuty:f,TencentBK:b,TencentCLS:v,TencentCm:w,TencentEb:_,OceanBase:k,Graylog:F,Skywalking:x,Sentry:S,Jiankongbao:T,AWSEventBridge:A,Dynatrace:I,HuaweiyunLTS:C,GoogleCM:L,Splunk:D,AppDynamics:P,SolarWinds:M,VolcEngineMetric:N,VolcEngineEvent:R,VolcEngineTLS:E,OpManager:W,Meraki:j,Zilliz:U,StateCloud:$,Guance:z,CustomChange:Q,Jira:X,Lark:Y,Dingtalk:nn,Wecom:tn,Slack:en,MicrosoftTeams:an,AlertWebhook:sn,IncidentWebhook:ln,CustomAction:dn,Templates:cn,HuaweiyunAPM:O,JiraSync:on,ZStack:H,Keep:q,ElastAlert2:B,DingtalkAlert:V,FeishuAlert:G,VolcEngineDetect:J,Link:un,ServiceNowSync:rn,Monit:K,Rum:Z};module.exports=hn;
|