flashduty-knowledge-base 1.3.6 → 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/dist/esm/zh.js CHANGED
@@ -81,7 +81,7 @@ POST, Content-Type:"application/json"
81
81
 
82
82
  字段|必含|类型|释义
83
83
  :-:|:-:|:-:|:---
84
- | title_rule | 是 | string | 告警标题,不超过\`512\`个字符,超出后将自动截断。<br><br>支持根据告警内容动态生成标题,生成规则请参考 [定制故障标题](https://docs.flashcat.cloud/zh/flashduty/customize-incident-attrs)。
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\`个字符,超出后将自动截断。
@@ -225,7 +225,7 @@ curl -X POST '{api_host}/event/push/alert/standard?integration_key={integration_
225
225
  3. 新的event可能由于匹配到排除、丢弃、抑制或静默规则,而被丢弃。
226
226
  4. 当新的event触发了新告警,则系统会进入第二层降噪检查,判断新告警是否可以被合并到某个活跃的故障中,如果可以,则只会并入已有的故障,而不会产生新故障。
227
227
 
228
- 更多内容请参考 [告警降噪](https://docs.flashcat.cloud/zh/flashduty/what-is-noise-reduction)。
228
+ 更多内容请参考 [告警降噪](https://docs.flashcat.cloud/zh/on-call/channel/noise-reduction)。
229
229
  </details>
230
230
 
231
231
  `,t=`---
@@ -327,7 +327,7 @@ attachment_stripped = true
327
327
  ## 严重程度映射关系
328
328
  ---
329
329
 
330
- 当前邮件集成推送到 Flashduty 的告警等级均为Warning,但您可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/flashduty/alert-pipelines) 来自定义严重程度。
330
+ 当前邮件集成推送到 Flashduty 的告警等级均为Warning,但您可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/on-call/integration/alert-integration/alert-pipelines) 来自定义严重程度。
331
331
 
332
332
  `,e=`---
333
333
  title: "夜莺/FlahCat集成"
@@ -2969,22 +2969,7 @@ OCP告警通知-单条告警
2969
2969
  |OceanBase| Flashduty|状态|
2970
2970
  |---|---|---|
2971
2971
  |停服|Critical|严重|
2972
- |严重|Warning|严重|
2973
- |警告|Warning|警告|
2974
- |注意|Info|提醒|
2975
- |提醒|Info|提醒|
2976
-
2977
- </div>
2978
-
2979
-
2980
- ## 状态对照
2981
- ---
2982
- <div class="md-block">
2983
-
2984
- |OceanBase| Flashduty|状态|
2985
- |---|---|---|
2986
- |停服|Critical|严重|
2987
- |严重|Warning|严重|
2972
+ |严重|Critical|严重|
2988
2973
  |警告|Warning|警告|
2989
2974
  |注意|Info|提醒|
2990
2975
  |提醒|Info|提醒|
@@ -3730,7 +3715,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/huaweilts-integration-guide"
3730
3715
  |Info|Info|提醒|
3731
3716
 
3732
3717
  </div>
3733
- `,L=`---
3718
+ `,P=`---
3734
3719
  title: "GoogleCloudMonitoring 告警事件"
3735
3720
  description: "通过 webhook 的方式同步 GoogleCloudMonitoring 告警事件到 Flashduty,实现告警事件自动化降噪处理"
3736
3721
  date: "2024-07-05T10:00:00+08:00"
@@ -3824,7 +3809,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/gcpcm-integration-guide"
3824
3809
  |No severity|Info|提醒|
3825
3810
 
3826
3811
  </div>
3827
- `,P=`---
3812
+ `,L=`---
3828
3813
  title: "Splunk 告警事件"
3829
3814
  description: "通过 webhook 的方式同步 Splunk 告警事件到 Flashduty,实现告警事件自动化降噪处理"
3830
3815
  date: "2024-08-20T10:00:00+08:00"
@@ -4068,7 +4053,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/appdynamics-integration-guide"
4068
4053
  |INFO|Info|提醒|
4069
4054
 
4070
4055
  </div>
4071
- `,R=`---
4056
+ `,N=`---
4072
4057
  title: "SolarWinds 告警事件"
4073
4058
  description: "通过 webhook 的方式同步 SolarWinds 告警事件到 Flashduty,实现告警事件自动化降噪处理"
4074
4059
  date: "2024-08-20T10:00:00+08:00"
@@ -4173,7 +4158,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/solarwinds-integration-guide"
4173
4158
  |Info|Info|提醒|
4174
4159
 
4175
4160
  </div>
4176
- `,N=`---
4161
+ `,R=`---
4177
4162
  title: "火山引擎云监控告警事件"
4178
4163
  description: "通过 webhook 的方式同步火山引擎云监控告警事件到 Flashduty,实现告警事件自动化降噪处理"
4179
4164
  date: "2024-08-20T10:00:00+08:00"
@@ -4264,7 +4249,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-metric-integration-gui
4264
4249
  |通知|Info|提醒|
4265
4250
 
4266
4251
  </div>
4267
- `,M=`---
4252
+ `,$=`---
4268
4253
  title: "火山引擎云监控事件中心告警事件"
4269
4254
  description: "通过 webhook 的方式同步火山引擎云监控事件中心告警事件到 Flashduty,实现告警事件自动化降噪处理"
4270
4255
  date: "2024-07-05T10:00:00+08:00"
@@ -4353,7 +4338,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-event-integration-guid
4353
4338
  |通知|Info|提醒|
4354
4339
 
4355
4340
  </div>
4356
- `,$=`---
4341
+ `,M=`---
4357
4342
  title: "火山引擎日志服务 TLS 告警事件"
4358
4343
  description: "通过 webhook 的方式同步火山引擎日志服务 TLS 告警事件到 Flashduty,实现告警事件自动化降噪处理"
4359
4344
  date: "2024-07-05T10:00:00+08:00"
@@ -4625,7 +4610,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/opmanager-integration-guide"
4625
4610
  | Attention | Info | 提醒 |
4626
4611
 
4627
4612
  </div>
4628
- `,z=`---
4613
+ `,U=`---
4629
4614
  title: "Meraki 告警事件"
4630
4615
  description: "通过 webhook 的方式同步 Meraki 告警事件到 Flashduty,实现告警事件自动化降噪处理"
4631
4616
  date: "2024-07-05T10:00:00+08:00"
@@ -4710,7 +4695,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/statecloud-integration-guide"
4710
4695
 
4711
4696
  通过 webhook 的方式同步天翼云监控告警事件到 Flashduty,实现告警事件自动化降噪处理。
4712
4697
 
4713
- 天翼云[二级节点](#二级节点)的资源监控事件推送,请使用华为云集成,请参考 [华为云告警集成指引](https://docs.flashcat.cloud/zh/flashduty/huawei-ces-integration-guide)。
4698
+ 天翼云[二级节点](#二级节点)的资源监控事件推送,请使用华为云集成,请参考 [华为云告警集成指引](https://docs.flashcat.cloud/zh/on-call/integration/alert-integration/alert-sources/huawei-ces)。
4714
4699
 
4715
4700
  <div class="hide">
4716
4701
 
@@ -4789,7 +4774,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/statecloud-integration-guide"
4789
4774
 
4790
4775
 
4791
4776
  </div>
4792
- `,U=`---
4777
+ `,z=`---
4793
4778
  title: "观测云告警事件"
4794
4779
  description: "通过 webhook 的方式同步观测云告警事件到 Flashduty,实现告警事件自动化降噪处理"
4795
4780
  date: "2024-07-05T10:00:00+08:00"
@@ -4877,7 +4862,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/guance-integration-guide"
4877
4862
  | 数据断档 | Info | 提醒 |
4878
4863
 
4879
4864
  </div>
4880
- `,j=`---
4865
+ `,H=`---
4881
4866
  title: "zilliz 告警事件"
4882
4867
  description: "通过 webhook 的方式同步 zilliz 告警事件到 Flashduty,实现告警事件自动化降噪处理"
4883
4868
  date: "2024-07-05T10:00:00+08:00"
@@ -4952,7 +4937,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/zilliz-integration-guide"
4952
4937
 
4953
4938
  </div>
4954
4939
 
4955
- `,H=`---
4940
+ `,O=`---
4956
4941
  title: "华为云 APM 告警事件"
4957
4942
  description: "通过 webhook 的方式同步华为云 APM 告警事件到 Flashduty,实现告警事件自动化降噪处理"
4958
4943
  date: "2024-07-05T10:00:00+08:00"
@@ -5060,7 +5045,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/huawei-apm-integration-guide"
5060
5045
 
5061
5046
  </div>
5062
5047
 
5063
- `,q=`---
5048
+ `,j=`---
5064
5049
  title: "zstack 告警事件"
5065
5050
  description: "通过 webhook 的方式同步 zstack 告警事件到 Flashduty,实现告警事件自动化降噪处理"
5066
5051
  date: "2024-07-05T10:00:00+08:00"
@@ -5149,7 +5134,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/zstack-integration-guide"
5149
5134
 
5150
5135
  </div>
5151
5136
 
5152
- `,O=`---
5137
+ `,q=`---
5153
5138
  title: "Keep 告警集成指引"
5154
5139
  description: "通过 Keep 的 Provider 将告警事件推送到 Flashduty,实现告警事件自动化降噪处理。"
5155
5140
  date: "2025-05-19T10:00:00+08:00"
@@ -5230,7 +5215,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/keep-alert-integration-guide"
5230
5215
 
5231
5216
  <img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/en/fd/keep-2.png" />
5232
5217
 
5233
- `,B=`---
5218
+ `,V=`---
5234
5219
  title: "ElastAlert2 告警集成指引"
5235
5220
  description: "通过 ElastAlert2 的 Provider 将告警事件推送到 Flashduty,实现告警事件自动化降噪处理。"
5236
5221
  date: "2025-05-19T10:00:00+08:00"
@@ -5351,7 +5336,7 @@ flashduty_env: "dev"
5351
5336
  # ------- Flashduty ----------------
5352
5337
  \`\`\`
5353
5338
 
5354
- 5.重启 ElastAlert,等待告警触发。`,V=`---
5339
+ 5.重启 ElastAlert,等待告警触发。`,B=`---
5355
5340
  title: "钉钉告警集成"
5356
5341
  description: "在 Flashduty 生成唯一的钉钉机器人地址,通过钉钉的方式将告警的发生与恢复同步到 Flashduty"
5357
5342
  date: "2025-05-19T10:00:00+08:00"
@@ -5432,7 +5417,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/dingtalk-alert-integration-guide"
5432
5417
  ## 严重程度映射关系
5433
5418
  ---
5434
5419
 
5435
- 当前钉钉告警集成推送到 Flashduty 的严重程度均为Warning,但您可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/flashduty/alert-pipelines) 来自定义严重程度。
5420
+ 当前钉钉告警集成推送到 Flashduty 的严重程度均为Warning,但您可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/on-call/integration/alert-integration/alert-pipelines) 来自定义严重程度。
5436
5421
 
5437
5422
  `,G=`---
5438
5423
  title: "飞书告警集成"
@@ -5515,9 +5500,9 @@ url: "https://docs.flashcat.cloud/zh/flashduty/feishu-alert-integration-guide"
5515
5500
  ## 严重程度映射关系
5516
5501
  ---
5517
5502
 
5518
- 当前飞书告警集成推送到 Flashduty 的严重程度均为 Warning,但您可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/flashduty/alert-pipelines) 来自定义严重程度。
5503
+ 当前飞书告警集成推送到 Flashduty 的严重程度均为 Warning,但您可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/on-call/integration/alert-integration/alert-pipelines) 来自定义严重程度。
5519
5504
 
5520
- `,J=`---
5505
+ `,K=`---
5521
5506
  title: "火山引擎云拨测告警事件"
5522
5507
  description: "通过 webhook 的方式同步 火山引擎云拨测的告警事件到 Flashduty,实现告警事件自动化降噪处理"
5523
5508
  date: "2024-07-05T10:00:00+08:00"
@@ -5604,7 +5589,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-detect-integration-gui
5604
5589
 
5605
5590
  </div>
5606
5591
 
5607
- `,K=`---
5592
+ `,J=`---
5608
5593
  title: "Monit 告警集成"
5609
5594
  description: "Flashduty Monit 告警集成,Monit 服务通过此集成上报告警"
5610
5595
  date: "2025-05-19T10:00:00+08:00"
@@ -5708,11 +5693,11 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-detect-integration-gui
5708
5693
 
5709
5694
  <div class="md-block">
5710
5695
 
5711
- 当前 Cloudflare 集成推送到 Flashduty 的告警等级均为 Warning,但您可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/flashduty/alert-pipelines) 来自定义严重程度。
5696
+ 当前 Cloudflare 集成推送到 Flashduty 的告警等级均为 Warning,但您可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/on-call/integration/alert-integration/alert-pipelines) 来自定义严重程度。
5712
5697
 
5713
5698
  </div>
5714
5699
 
5715
- `,Q=`---
5700
+ `,Y=`---
5716
5701
  title: "企微告警集成"
5717
5702
  description: "在 Flashduty 生成唯一的企微机器人地址,通过企微的方式将告警的发生与恢复同步到 Flashduty"
5718
5703
  date: "2025-05-19T10:00:00+08:00"
@@ -5787,12 +5772,12 @@ url: "https://docs.flashcat.cloud/zh/flashduty/wecom-alert-integration-guide"
5787
5772
 
5788
5773
  ### 注意事项
5789
5774
  - 企微告警集成地址仅支持接收 Text、Markdown 消息类型,其他消息无法接收。
5790
- - Flashduty 会生成默认告警标题: “企微机器人告警”,如果您需要更改标题,可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/flashduty/alert-pipelines) 来自定义标题。
5775
+ - Flashduty 会生成默认告警标题: “企微机器人告警”,如果您需要更改标题,可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/on-call/integration/alert-integration/alert-pipelines) 来自定义标题。
5791
5776
 
5792
5777
  ## 严重程度映射关系
5793
5778
  ---
5794
5779
 
5795
- 当前企微告警集成推送到 Flashduty 的严重程度均为Warning,但您可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/flashduty/alert-pipelines) 来自定义严重程度。`,Y=`---
5780
+ 当前企微告警集成推送到 Flashduty 的严重程度均为Warning,但您可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/on-call/integration/alert-integration/alert-pipelines) 来自定义严重程度。`,Q=`---
5796
5781
  title: "Harbor 告警集成"
5797
5782
  description: "通过 webhook 的方式同步 Harbor 的告警事件到 Flashduty,实现告警事件自动化降噪处理"
5798
5783
  date: "2025-05-19T10:00:00+08:00"
@@ -5859,7 +5844,610 @@ url: "https://docs.flashcat.cloud/zh/flashduty/harboe-integration-guide"
5859
5844
  ## 严重程度映射关系
5860
5845
  ---
5861
5846
 
5862
- 当前 Harbor 告警集成推送到 Flashduty 的严重程度均为 Warning,但您可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/flashduty/alert-pipelines) 来自定义严重程度。`,nn=`---
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"
5852
+ ---
5853
+
5854
+ 通过 webhook 的方式同步火山引擎 RTC 的告警事件到 Flashduty,实现告警事件自动化降噪处理。
5855
+
5856
+ <div class="hide">
5857
+
5858
+ ## 在 Flashduty
5859
+ ---
5860
+
5861
+ ### 创建火山引擎 RTC 告警集成
5862
+
5863
+ 您可通过以下2种方式,获取一个企微机器人告警集成地址,任选其一即可。
5864
+
5865
+ #### 使用专属集成
5866
+
5867
+ 当您不需要将告警事件路由到不同的协作空间,优先选择此方式,更简单。
5868
+
5869
+ <details>
5870
+ <summary>展开</summary>
5871
+
5872
+ 1. 进入 Flashduty 控制台,选择 **协作空间**,进入某个空间的详情页面
5873
+ 2. 选择 **集成数据** tab,点击 **添加一个集成**,进入添加集成页面
5874
+ 3. 选择 **火山引擎 RTC** 集成,点击 **保存**,生成卡片。
5875
+ 4. 点击生成的卡片,可以查看到 **火山引擎 RTC 告警集成地址**,复制备用,完成。
5876
+
5877
+ </details>
5878
+
5879
+ #### 使用共享集成
5880
+
5881
+ 当您需要根据告警事件的 Payload 信息,将告警路由到不同的协作空间,优先选择此方式。
5882
+
5883
+ <details>
5884
+ <summary>展开</summary>
5885
+
5886
+ 1. 进入 Flashduty 控制台,选择 **集成中心=>告警事件**,进入集成选择页面。
5887
+ 2. 选择 **火山引擎 RTC** 集成:
5888
+ - **集成名称**:为当前集成定义一个名称。
5889
+ - **推送模式**:选择企微告警在何种情况下触发或恢复告警。
5890
+ 3. 复制当前页面的 **火山引擎 RTC 告警集成地址** 备用。
5891
+ 4. 配置默认路由,并选择对应的协作空间(集成创建后可以前往 \`路由\` 进行更多路由规则的配置)。
5892
+ 5. 完成。
5893
+
5894
+ </details>
5895
+
5896
+ ## 在火山引擎
5897
+ ---
5898
+ </div>
5899
+
5900
+
5901
+ ### 配置告警规则
5902
+
5903
+ 1. 登录您的火山引擎控制台,检索 \`实时音视频\` 产品,并进入对应产品控制台。
5904
+ 2. 在左侧菜单中选择 \`监控台->告警通知\`,并转到 \`告警规则\` 页面。
5905
+ 3. 创建或编辑告警规则,在规则页面中勾选 \`告警回调\` 并输入告警集成的<span class='integration_url'>推送地址</span>。
5906
+ 4. 其他选项按需配置。
5907
+ 5. 点击 \`确定\` 完成配置。
5908
+
5909
+ ![2026-02-05-17-32-39](https://docs-cdn.flashcat.cloud/images/png/21908f6a040f61ad2e8091226874fe97.png)
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,实现告警事件自动化降噪处理"
5922
+ date: "2025-05-19T10:00:00+08:00"
5923
+ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-rtc-integration-guide"
5924
+ ---
5925
+
5926
+ 通过 webhook 的方式同步 Ucloud CloudWatch 的告警事件到 Flashduty,实现告警事件自动化降噪处理。
5927
+
5928
+ <div class="hide">
5929
+
5930
+ ## 在 Flashduty
5931
+ ---
5932
+
5933
+ ### 创建 Ucloud CloudWatch 告警集成
5934
+
5935
+ 您可通过以下2种方式,获取一个企微机器人告警集成地址,任选其一即可。
5936
+
5937
+ #### 使用专属集成
5938
+
5939
+ 当您不需要将告警事件路由到不同的协作空间,优先选择此方式,更简单。
5940
+
5941
+ <details>
5942
+ <summary>展开</summary>
5943
+
5944
+ 1. 进入 Flashduty 控制台,选择 **协作空间**,进入某个空间的详情页面
5945
+ 2. 选择 **集成数据** tab,点击 **添加一个集成**,进入添加集成页面
5946
+ 3. 选择 **Ucloud CloudWatch** 集成,点击 **保存**,生成卡片。
5947
+ 4. 点击生成的卡片,可以查看到 **火山引擎 RTC 告警集成地址**,复制备用,完成。
5948
+
5949
+ </details>
5950
+
5951
+ #### 使用共享集成
5952
+
5953
+ 当您需要根据告警事件的 Payload 信息,将告警路由到不同的协作空间,优先选择此方式。
5954
+
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>
5967
+
5968
+ ## 在 Ucloud
5969
+ ---
5970
+ </div>
5971
+
5972
+
5973
+ ### 步骤1:配置通知模版
5974
+
5975
+ 1. 登录您的 Ucloud 控制台,检索 \`CloudWatch\` 产品,并进入对应产品控制台。
5976
+ 2. 在菜单中选择 \`通知管理\`,并转到 \`通知模版\` 页面。
5977
+ 3. 创建或编辑通知模版,在模版页面中勾选 \`接口回调\`。
5978
+ 4. **回调语言**选择 \`英文\`,输入框中输入告警集成的<span class='integration_url'>推送地址</span>。
5979
+ 5. 模版名称输入 \`Flashduty\` 或其他。
5980
+ 6. 其他选项按需配置。
5981
+ 7. 点击 \`提交\` 完成配置。
5982
+
5983
+ ![2026-02-05-17-31-12](https://docs-cdn.flashcat.cloud/images/png/7243d6686265fd95da85f88efc1feab5.png)
5984
+
5985
+ ### 步骤2:配置告警策略
5986
+ 1. 登录您的 Ucloud 控制台,检索 \`CloudWatch\` 产品,并进入对应产品控制台。
5987
+ 2. 在菜单中选择 \`告警管理\`,并转到 \`告警策略\` 页面。
5988
+ 3. 新建或编辑告警策略,找到策略配置页面的**通知设置**,选择**步骤1** 创建的通知模版。
5989
+ 4. 其他选项按需配置。
5990
+ 5. 点击 \`提交\` 完成配置。
5991
+
5992
+
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"
6000
+ ---
6001
+
6002
+ 通过 webhook 的方式同步 Nagios 告警事件到 Flashduty,实现告警事件自动化降噪处理。
6003
+
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=`---
5863
6451
  title: "自定义变更事件集成指引"
5864
6452
  description: "通过标准协议推送自有系统变更事件到 Flashduty,大部分故障由变更导致,变更和告警事件联动有助于快速定位故障原因。"
5865
6453
  date: "2025-05-19T10:00:00+08:00"
@@ -5916,7 +6504,7 @@ Flashduty 已经适配部分常用工单、部署系统的 webhook 协议,对
5916
6504
 
5917
6505
  </details>
5918
6506
 
5919
- `,tn=`---
6507
+ `,ln=`---
5920
6508
  title: "Jira 事件集成指引"
5921
6509
  description: "通过 webhook 的方式同步 Jira Issue 事件到 Flashduty,实现变更事件收集。"
5922
6510
  date: "2025-05-19T10:00:00+08:00"
@@ -5990,7 +6578,7 @@ Flashduty 默认提取 webhook payload 中 status.name 信息,并按照下边
5990
6578
  如您希望变更此映射关系,请联系 Flashduty。
5991
6579
 
5992
6580
  </div>
5993
- `,en=`---
6581
+ `,on=`---
5994
6582
  title: "飞书集成"
5995
6583
  description: "通过集成飞书自建应用,您可以在飞书端内接收和响应告警。"
5996
6584
  date: "2025-05-19T10:00:00+08:00"
@@ -6079,7 +6667,8 @@ url: "https://docs.flashcat.cloud/zh/flashduty/lark-integration-guide"
6079
6667
 
6080
6668
  - \`im:chat\`:获取与更新群组信息
6081
6669
  - \`im:message\`:获取与发送单聊、群组消息
6082
- - \`contact:user.id:readonly\`:通过手机号或邮箱获取用户 ID <span id="war-room-scope"></span>
6670
+ - \`contact:user.id:readonly\`:通过手机号或邮箱获取用户 ID
6671
+ - \`im:message.group_msg\`:读取群聊历史消息(AI 生成复盘报告需要读取作战室聊天记录) <span id="war-room-scope"></span>
6083
6672
 
6084
6673
  ![2025-09-18-10-55-14](https://docs-cdn.flashcat.cloud/images/png/d919be62107f6b9d0c662f440d620e61.png)
6085
6674
 
@@ -6143,7 +6732,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/lark-integration-guide"
6143
6732
  5. **为什么作战室功能未按预期工作?**
6144
6733
  - 请再次检查是否为应用配置了作战室功能[所需权限](#war-room-scope)。
6145
6734
  - 请参考 Flashduty [作战室介绍文档](https://docs.flashcat.cloud/zh/flashduty/war-room) 的 **常见问题** 部分。
6146
- `,an=`---
6735
+ `,rn=`---
6147
6736
  title: "钉钉集成"
6148
6737
  description: "通过集成钉钉自建应用,实现在钉钉端内接收和响应告警的能力"
6149
6738
  date: "2025-05-19T10:00:00+08:00"
@@ -6376,7 +6965,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/dingtalk-integration-guide"
6376
6965
  | 专属版 | 550 万次 | 60 | 每月 1 日 |
6377
6966
 
6378
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)。
6379
- `,sn=`---
6968
+ `,cn=`---
6380
6969
  title: "企业微信 WeCom 集成"
6381
6970
  description: "通过集成企业微信第三方应用,实现在企业微信端接收和响应告警的能力"
6382
6971
  date: "2025-05-19T10:00:00+08:00"
@@ -6527,7 +7116,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/wecom-integration-guide"
6527
7116
  8. **为什么作战室功能未按预期工作?**
6528
7117
  - 请参考 Flashduty [作战室介绍文档](https://docs.flashcat.cloud/zh/flashduty/war-room) 的 **常见问题** 部分。
6529
7118
  9. **为什么在企微工作台打开应用后提示“redirect_uri需使用应用可信域名”?**
6530
- - 请确认**应用主页**的url中的\`redirect_uri\`参数中的域名是否完成企业微信要求的域名归属认证,详见企业微信官方文档 [《企业内部开发配置域名指引》](https://open.work.weixin.qq.com/wwopen/common/readDocument/40754)。`,dn=`---
7119
+ - 请确认**应用主页**的url中的\`redirect_uri\`参数中的域名是否完成企业微信要求的域名归属认证,详见企业微信官方文档 [《企业内部开发配置域名指引》](https://open.work.weixin.qq.com/wwopen/common/readDocument/40754)。`,un=`---
6531
7120
  title: "Slack 集成"
6532
7121
  description: "通过集成 Slack 第三方应用,您可以在 Slack 内接收和响应告警。"
6533
7122
  date: "2025-05-19T10:00:00+08:00"
@@ -6551,6 +7140,8 @@ url: "https://docs.flashcat.cloud/zh/flashduty/slack-integration-guide"
6551
7140
 
6552
7141
  完成先前步骤后,在 Flashduty 集成配置页面的 **增强功能** 模块,勾选 **开启作战室** 即可启用该功能,无需额外配置。
6553
7142
 
7143
+ 若需启用 AI 生成复盘报告(读取作战室聊天记录),应用需要额外的 \`channels:history\` 权限。对于已授权的 Slack 集成,您需要手动重新授权以获取该权限。
7144
+
6554
7145
  ## 二、常见问题
6555
7146
 
6556
7147
  ---
@@ -6582,7 +7173,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/slack-integration-guide"
6582
7173
  9. **为什么作战室功能未按预期工作?**
6583
7174
  - 对于之前授权的 Slack IM 集成,需要您在 Flashduty 集成配置页中对 Slack 手动进行重新授权,以使应用获得作战室功能所需的额外权限。
6584
7175
  - 请参考 Flashduty [作战室介绍文档](https://docs.flashcat.cloud/zh/flashduty/war-room) 的 **常见问题** 部分。
6585
- `,ln=`---
7176
+ `,hn=`---
6586
7177
  title: "Microsoft Teams 集成"
6587
7178
  description: "通过集成 Microsoft Teams 第三方应用,您可以在 Microsoft Teams 内接收和响应告警。"
6588
7179
  date: "2025-05-19T10:00:00+08:00"
@@ -6700,7 +7291,7 @@ Microsoft Teams 集成现处于 Beta 阶段,在关联前您需要先完成以
6700
7291
  3. **如何取消已关联的团队和用户?**
6701
7292
  - 暂不支持此功能。
6702
7293
 
6703
- `,on=`配置告警 Webhook,当告警发生特定操作(如触发、关闭)时,系统通过 HTTP 回调您配置的地址。回调内容将包含告警最新关键信息,您可以与自研工具进行集成。
7294
+ `,pn=`配置告警 Webhook,当告警发生特定操作(如触发、关闭)时,系统通过 HTTP 回调您配置的地址。回调内容将包含告警最新关键信息,您可以与自研工具进行集成。
6704
7295
 
6705
7296
  <span id="EventTypes"></span>
6706
7297
 
@@ -6858,7 +7449,7 @@ curl -X POST 'https://example.com/alert/webhook?a=a' \\
6858
7449
 
6859
7450
  2. **推送失败后是否会持续推送?**
6860
7451
 
6861
- 针对特定的网络错误,会进行重试,最多重试2次:
7452
+ 针对特定的网络错误,会进行重试,最多重试1次:
6862
7453
  - context deadline exceeded (排除 awaiting headers)
6863
7454
  - i/o timeout
6864
7455
  - eof
@@ -6871,7 +7462,7 @@ curl -X POST 'https://example.com/alert/webhook?a=a' \\
6871
7462
  4. **推送来源可信 IP 白名单?**
6872
7463
  - {ip_whitelist}
6873
7464
  - 未来可能会更新,请定期查验
6874
- `,rn=`配置故障 Webhook,当故障发生特定操作(如触发、关闭)时,系统通过 HTTP 回调您配置的地址。回调内容将包含故障最新关键信息,您可以与自研工具进行集成。
7465
+ `,gn=`配置故障 Webhook,当故障发生特定操作(如触发、关闭)时,系统通过 HTTP 回调您配置的地址。回调内容将包含故障最新关键信息,您可以与自研工具进行集成。
6875
7466
 
6876
7467
  <span id="EventTypes"></span>
6877
7468
 
@@ -7070,7 +7661,7 @@ curl -X POST 'https://example.com/incident/webhook?a=a' \\
7070
7661
 
7071
7662
  2. **推送失败后是否会持续推送?**
7072
7663
 
7073
- 针对特定的网络错误,会进行重试,最多重试2次:
7664
+ 针对特定的网络错误,会进行重试,最多重试1次:
7074
7665
  - context deadline exceeded (排除 awaiting headers)
7075
7666
  - i/o timeout
7076
7667
  - eof
@@ -7082,7 +7673,7 @@ curl -X POST 'https://example.com/incident/webhook?a=a' \\
7082
7673
 
7083
7674
  4. **推送来源可信 IP 白名单?**
7084
7675
  - {ip_whitelist}
7085
- - 未来可能会更新,请定期查验`,cn=`配置故障 自定义操作,允许您在故障排查期间,快速调用外部接口,实现故障自愈、信息丰富等任何自定义操作。
7676
+ - 未来可能会更新,请定期查验`,mn=`配置故障 自定义操作,允许您在故障排查期间,快速调用外部接口,实现故障自愈、信息丰富等任何自定义操作。
7086
7677
 
7087
7678
  ## 一、创建操作
7088
7679
 
@@ -7336,12 +7927,18 @@ curl -X POST 'https://example.com/incident/action?a=a' \\
7336
7927
 
7337
7928
  1. **服务是否有响应超时时间?**
7338
7929
 
7339
- - 服务需要在 1 秒内返回响应,超过 1 秒则认为响应失败
7930
+ - 服务需要在 2 秒内返回响应,超过 2 秒则认为响应失败
7340
7931
 
7932
+ 2. **推送失败后是否会持续推送?**
7933
+
7934
+ 针对特定的网络错误,会进行重试,最多重试1次:
7935
+ - context deadline exceeded (排除 awaiting headers)
7936
+ - i/o timeout
7937
+ - eof
7341
7938
 
7342
7939
  2. **推送来源可信 IP 白名单?**
7343
7940
  - {ip_whitelist}
7344
- - 未来可能会更新,请定期查验`,un=`---
7941
+ - 未来可能会更新,请定期查验`,yn=`---
7345
7942
  title: "Jira 同步"
7346
7943
  description: "通过 Jira 同步 Webhook,实现故障与 Jira Issue 的关联。"
7347
7944
  date: "2025-05-19T10:00:00+08:00"
@@ -7426,7 +8023,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/jira-sync"
7426
8023
 
7427
8024
  - Flashduty 会按照默认的字段映射以及您配置的自定义字段映射进行同步信息,如果您的 Jira 事务类型中有必选的字段且没有配置映射关系,则会遇到创建 Jira Issue 失败的情况。
7428
8025
  - Jira 的 Issue 详情是基于项目 KEY + 编号的格式进行访问的,如果您修改了项目 KEY,可能无法通过 Flashduty 中保存的 Issue 地址进行访问,请谨慎修改项目 KEY。
7429
- `,hn=`---
8026
+ `,fn=`---
7430
8027
  title: "ServiceNow 同步"
7431
8028
  description: "通过 ServiceNow 同步 Webhook,实现故障与 ServiceNow Incident 的关联。"
7432
8029
  date: "2025-05-19T10:00:00+08:00"
@@ -7739,7 +8336,7 @@ IncidentWebhookHelper.prototype = {
7739
8336
  <details>
7740
8337
  <summary>配置集成时提示 401 错误 </summary>
7741
8338
  提示 401 一般是密码错误导致的,请检查密码是否正确,或者重新设置新的密码(在配置密码时,请勿勾选 Password needs reset 选项)
7742
- </details>`,pn=`---
8339
+ </details>`,bn=`---
7743
8340
  title: "ServiceDesk Plus 同步"
7744
8341
  description: "通过 ServiceDesk Plus 同步 Webhook,实现故障与 ServiceDesk Plus request 的关联。"
7745
8342
  date: "2025-05-19T10:00:00+08:00"
@@ -7910,7 +8507,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/servicedesk-plus-sync"
7910
8507
  <summary> Scope 是否可以更改</summary>
7911
8508
  不可以,目前所使用的 Scope 已经是最小单元了,Flashduty 在与 ServiceDesc Plus 进行同步 request 时,需要做获取/创建/更新操作,以及在配置集成时,需要获取优先级/自定义字段列表,所以需要相应的权限支持。
7912
8509
  </details>
7913
- `,gn=`---
8510
+ `,vn=`---
7914
8511
  title: "配置通知模版"
7915
8512
  description: "通过自定义配置模版,可以实现个性化通知内容的需求"
7916
8513
  date: "2024-05-10T10:00:00+08:00"
@@ -8984,6 +9581,17 @@ msg_type 必填,值为 post
8984
9581
  \`\`\`
8985
9582
  </div>
8986
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
+
8987
9595
  <div class="email hide">
8988
9596
 
8989
9597
  ## 邮件
@@ -9321,7 +9929,7 @@ msg_type 必填,值为 post
9321
9929
  <img src="https://download.flashcat.cloud/flashduty/changelog/20230720/email_render.png" alt="drawing" style="display: block; margin: 0 auto;" width="500"/>
9322
9930
 
9323
9931
  </div>
9324
- `,mn=`---
9932
+ `,_n=`---
9325
9933
  title: "Link 集成"
9326
9934
  description: "通过 Link 集成,可直接从故障属性、标签等信息中获取访问外部链接所需的关键参数,实现快速访问"
9327
9935
  date: "2025-05-19T10:00:00+08:00"
@@ -9378,7 +9986,7 @@ https://cmdb.com/vm?sn=VM123456
9378
9986
  1. 当引用的内容不存在时,Link 集成会正常生成对应的链接,但无法获取到值
9379
9987
  2. 同一个协作空间至多绑定三个 Link 集成
9380
9988
  3. 注意引用语法,如未按照要求进行书写引用变量,会导致无法正常获取对应值
9381
- `,yn=`配置标签映射 API,当告警事件到达时,Flashduty 将自动调用您配置的外部 API 获取增强标签,实现告警信息的动态丰富和关联。通过此功能,您可以将 CMDB、HR 系统等外部数据源的信息自动附加到告警上。
9989
+ `,wn=`配置标签映射 API,当告警事件到达时,Flashduty 将自动调用您配置的外部 API 获取增强标签,实现告警信息的动态丰富和关联。通过此功能,您可以将 CMDB、HR 系统等外部数据源的信息自动附加到告警上。
9382
9990
 
9383
9991
  ## 一、功能概述
9384
9992
 
@@ -9555,7 +10163,7 @@ POST, Content-Type:"application/json"
9555
10163
  ### Header 最佳实践
9556
10164
 
9557
10165
  1. **白名单模式**:建议仅允许以 \`X-Custom-\` 或 \`X-Enrich-\` 为前缀的自定义 Header
9558
- 2. **长度限制**:单个 Header 的 Key Value 长度不应超过 1024 字节
10166
+ 2. **长度限制**:单个 Header 的 Key 长度不应超过 1024 字节, Value 长度不应超过 4096 字节
9559
10167
  3. **格式校验**:Header 的 Value 严禁包含换行符(\`\\r\`、\`\\n\`),以防止 Header 注入攻击
9560
10168
 
9561
10169
  ## 五、最佳实践
@@ -9582,4 +10190,4 @@ POST, Content-Type:"application/json"
9582
10190
  3. **result_label_keys 可以动态变化吗?**
9583
10191
 
9584
10192
  - 是的,您可以在 Flashduty 中随时修改期望获取的标签列表,无需修改 API 代码
9585
- `,fn={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:L,Splunk:P,AppDynamics:D,SolarWinds:R,VolcEngineMetric:N,VolcEngineEvent:M,VolcEngineTLS:$,OpManager:E,Meraki:z,Zilliz:j,StateCloud:W,Guance:U,CustomChange:nn,Jira:tn,Lark:en,Dingtalk:an,Wecom:sn,Slack:dn,MicrosoftTeams:ln,AlertWebhook:on,IncidentWebhook:rn,CustomAction:cn,Templates:gn,HuaweiyunAPM:H,JiraSync:un,ZStack:q,Keep:O,ElastAlert2:B,DingtalkAlert:V,FeishuAlert:G,VolcEngineDetect:J,Link:mn,ServiceNowSync:hn,Monit:K,Rum:Z,Cloudflare:X,WecomAlert:Q,ServiceDeskPlusSync:pn,Harbor:Y,LabelMappingAPI:yn};module.exports=fn;
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;