flashduty-knowledge-base 1.2.7 → 1.2.9

package/dist/esm/zh.js

@@ -1834,7 +1834,7 @@ Azure Monitor 到 Flashduty 告警等级映射关系：
 | Sev4     | Info     | 提醒 |
 
 </div>
-`,m=`---
+`,p=`---
 title: "百度云BCM监控集成"
 description: "通过 webhook 的方式同步百度云 BCM 告警事件到 Flashduty，实现告警事件自动化降噪处理"
 date: "2025-05-19T10:00:00+08:00"
@@ -1910,7 +1910,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/baidu-bcm-integration-guide"
 | 通知 | Info     | 提醒 |
 
 </div>
-`,p=`---
+`,m=`---
 title: "华为云监控 CES集成"
 description: 通过 webhook 的方式同步华为云监控 CES 告警事件到 Flashduty，实现告警事件自动化降噪处理"
 date: "2025-05-19T10:00:00+08:00"
@@ -4164,7 +4164,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/solarwinds-integration-guide"
 |Info|Info|提醒|
 
 </div>
-`,N=`---
+`,E=`---
 title: "火山引擎云监控告警事件"
 description: "通过 webhook 的方式同步火山引擎云监控告警事件到 Flashduty，实现告警事件自动化降噪处理"
 date: "2024-08-20T10:00:00+08:00"
@@ -4255,7 +4255,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-metric-integration-gui
 |通知|Info|提醒|
 
 </div>
-`,E=`---
+`,N=`---
 title: "火山引擎云监控事件中心告警事件"
 description: "通过 webhook 的方式同步火山引擎云监控事件中心告警事件到 Flashduty，实现告警事件自动化降噪处理"
 date: "2024-07-05T10:00:00+08:00"
@@ -4344,7 +4344,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-event-integration-guid
 |通知|Info|提醒|
 
 </div>
-`,W=`---
+`,$=`---
 title: "火山引擎日志服务 TLS 告警事件"
 description: "通过 webhook 的方式同步火山引擎日志服务 TLS 告警事件到 Flashduty，实现告警事件自动化降噪处理"
 date: "2024-07-05T10:00:00+08:00"
@@ -4481,7 +4481,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-tls-integration-guide"
 |通知|Info|提醒|
 
 </div>
-`,$=`---
+`,W=`---
 title: "Opmanager 告警事件"
 description: "通过 webhook 的方式同步 Opmanager 告警事件到 Flashduty，实现告警事件自动化降噪处理"
 date: "2024-07-05T10:00:00+08:00"
@@ -4943,7 +4943,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/zilliz-integration-guide"
 
 </div>
 
-`,H=`---
+`,O=`---
 title: "华为云 APM 告警事件"
 description: "通过 webhook 的方式同步华为云 APM 告警事件到 Flashduty，实现告警事件自动化降噪处理"
 date: "2024-07-05T10:00:00+08:00"
@@ -5051,7 +5051,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/huawei-apm-integration-guide"
 
 </div>
 
-`,O=`---
+`,q=`---
 title: "zstack 告警事件"
 description: "通过 webhook 的方式同步 zstack 告警事件到 Flashduty，实现告警事件自动化降噪处理"
 date: "2024-07-05T10:00:00+08:00"
@@ -5140,7 +5140,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/zstack-integration-guide"
 
 </div>
 
-`,q=`---
+`,H=`---
 title: "Keep 告警集成指引"
 description: "通过 Keep 的 Provider 将告警事件推送到 Flashduty，实现告警事件自动化降噪处理。"
 date: "2025-05-19T10:00:00+08:00"
@@ -5342,7 +5342,7 @@ flashduty_env: "dev"
 # ------- FlashDuty ----------------
 \`\`\`
 
-5.重启 ElastAlert，等待告警触发。`,J=`---
+5.重启 ElastAlert，等待告警触发。`,V=`---
 title: "钉钉告警集成"
 description: "在 Flashduty 生成唯一的钉钉机器人地址，通过钉钉的方式将告警的发生与恢复同步到 Flashduty"
 date: "2025-05-19T10:00:00+08:00"
@@ -5425,7 +5425,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/dingtalk-alert-integration-guide"
 
 当前钉钉告警集成推送到 Flashduty 的严重程度均为Warning。
 
-`,G=`---
+`,J=`---
 title: "飞书告警集成"
 description: "在 Flashduty 生成唯一的飞书机器人地址，通过飞书的方式将告警的发生与恢复同步到 Flashduty"
 date: "2025-05-19T10:00:00+08:00"
@@ -5508,7 +5508,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/feishu-alert-integration-guide"
 
 当前飞书告警集成推送到 Flashduty 的严重程度均为 Warning。
 
-`,V=`---
+`,G=`---
 title: "自定义变更事件集成指引"
 description: "通过标准协议推送自有系统变更事件到 Flashduty，大部分故障由变更导致，变更和告警事件联动有助于快速定位故障原因。"
 date: "2025-05-19T10:00:00+08:00"
@@ -5923,7 +5923,8 @@ url: "https://docs.flashcat.cloud/zh/flashduty/dingtalk-integration-guide"
     - 回到分派策略配置页面，刷新后重新选择群聊列表
     - 如果仍然拿不到群聊列表，请尝试群内卸载酷应用后，重试以上步骤。如果还不可以，请联系客户或专属技术支持
 
-<img src="https://download.flashcat.cloud/dingtalk-self-app-install.png" alt="drawing" width="800"/>
+<img src="https://download.flashcat.cloud/flashduty/doc/zh/fd/dingtalk-install-1.png" alt="drawing" width="800"/>
+<img src="https://download.flashcat.cloud/flashduty/doc/zh/fd/dingtalk-install-2.png" alt="drawing" width="800"/>
 
 <img src="https://download.flashcat.cloud/dingtalk-self-app-notify-rule.png" alt="drawing" width="800"/>
 
@@ -7432,7 +7433,7 @@ msg_type 必填，值为 interactive
       "fields": [{
           "text": {
             "tag": "lark_md",
-            "content": "**🏢 协作空间:**{{if .ChannelName}}{{.ChannelName}}{{else}}无{{end}}"
+            "content": "**🏢 协作空间:**{{.ChannelName}}"
           }
         },
         {
@@ -7444,34 +7445,46 @@ msg_type 必填，值为 interactive
         {
           "text": {
             "tag": "lark_md",
-            "content": "**⏰ 触发时间:**{{date "2006-01-02 15:04:05" .StartTime}}{{if gt .AlertCnt 1}}"
+            "content": "**⏰ 触发时间:**{{date "2006-01-02 15:04:05" .StartTime}}"
           }
         },
+        {{if gt .AlertCnt 1}}
         {
           "text": {
             "tag": "lark_md",
-            "content": "**🔔 聚合告警:**{{.AlertCnt}}条 {{end}}{{if .Labels.resource}}"
+            "content": "**🔔 聚合告警:**{{.AlertCnt}}条"
           }
         },
+        {{end}}{{if .Labels.resource}}
         {
           "tag": "div",
           "text": {
             "tag": "lark_md",
-            "content": "**📌 告警对象:**{{toHtml (joinAlertLabels . "resource" ",")}} {{end}}{{if .Description}}"
+            "content": {{printf "%q" (print "**📌 告警对象:**" (joinAlertLabels . "resource" ","))}}
           }
         },
+        {{end}}{{if .Description}}
         {
           "tag": "div",
           "text": {
             "tag": "lark_md",
-            "content": "**🔍 故障描述:**{{.Description}}{{end}}{{if gt (len .Responders) 0}}"
+            "content": {{printf "%q" (print "**🔍 故障描述:**" .Description)}}
           }
         },
+        {{end}}{{if gt (len .Responders) 0}}
         {
           "tag": "div",
           "text": {
             "tag": "lark_md",
-            "content": "**👨‍💻 处理人员:**{{range .Responders}}@{{.PersonName}} {{end}}{{end}}"
+            "content": "**👨‍💻 处理人员:**{{range .Responders}}@{{.PersonName}} {{end}}"
+          }
+        },
+        {{end}}
+        {
+          "tag": "div",
+          "text": {
+            "tag": "lark_md",
+            "content": ""
           }
         }
       ]
@@ -7500,7 +7513,28 @@ msg_type 必填，值为 interactive
           "url": "{{.DetailUrl}}?ack=1"
         }
       ]
-    }]
+    }
+    {{if or .IsFlapping .IsInStorm}},{{end}}
+    {{if .IsFlapping}}
+    {
+        "tag": "div",
+        "text": {
+        "tag": "lark_md",
+        "content": "🔴 当前故障频繁发生与恢复，{{if .Flapping.MuteMinutes}}未来{{.Flapping.MuteMinutes}}分钟内此告警重复触发将不再通知。{{end}}建议您优化告警策略。"
+        }
+    }
+    {{end}}
+    {{if and .IsFlapping .IsInStorm}},{{end}}
+    {{if .IsInStorm}}
+    {
+        "tag": "div",
+        "text": {
+        "tag": "lark_md",
+        "content": "🔴 当前故障已聚合{{.AlertCnt}}条告警，触发告警风暴，请加急处理！"
+        }
+    }
+    {{end}} 
+    ]
   }
 }
 \`\`\`
@@ -7520,10 +7554,10 @@ msg_type 必填，值为 post
                 }, {
                     "tag": "text",
                     "text": "协作空间：",
-                    "text_type": "bold"
+                    "style": ["bold"]
                 }, {
                     "tag": "text",
-                    "text": "{{if .ChannelName}}{{.ChannelName}}{{else}}无{{end}}\\n"
+                    "text": "{{if .ChannelName}}{{.ChannelName}}{{else}}无{{end}}"
                 }],
                 [{
                     "tag": "text",
@@ -7531,11 +7565,10 @@ msg_type 必填，值为 post
                 }, {
                     "tag": "text",
                     "text": "严重程度：",
-                    "text_type": "bold"
+                    "style": ["bold"]
                 }, {
                     "tag": "text",
-                    "text": "{{.IncidentSeverity}}\\n",
-                    "text_type": "{{if eq .IncidentSeverity "Critical"}}bold{{end}}"
+                    "text": "{{.IncidentSeverity}}"
                 }],
                 [{
                     "tag": "text",
@@ -7543,10 +7576,10 @@ msg_type 必填，值为 post
                 }, {
                     "tag": "text",
                     "text": "触发时间：",
-                    "text_type": "bold"
+                    "style": ["bold"]
                 }, {
                     "tag": "text",
-                    "text": "{{date "2006-01-02 15:04:05" .StartTime}}\\n"
+                    "text": "{{date "2006-01-02 15:04:05" .StartTime}}"
                 }],
                 {{if gt .AlertCnt 1}}[{
                     "tag": "text",
@@ -7554,10 +7587,10 @@ msg_type 必填，值为 post
                 }, {
                     "tag": "text",
                     "text": "聚合告警：",
-                    "text_type": "bold"
+                    "style": ["bold"]
                 }, {
                     "tag": "text",
-                    "text": "{{.AlertCnt}}条\\n"
+                    "text": "{{.AlertCnt}}条"
                 }],{{end}}
                 {{if .Labels.resource}}[{
                     "tag": "text",
@@ -7565,10 +7598,10 @@ msg_type 必填，值为 post
                 }, {
                     "tag": "text",
                     "text": "告警对象：",
-                    "text_type": "bold"
+                    "style": ["bold"]
                 }, {
                     "tag": "text",
-                    "text": "{{toHtml (joinAlertLabels . "resource" ", ")}}\\n"
+                    "text": {{printf "%q" (print (joinAlertLabels . "resource" ","))}}
                 }],{{end}}
                 {{if .Description}}[{
                     "tag": "text",
@@ -7576,10 +7609,10 @@ msg_type 必填，值为 post
                 }, {
                     "tag": "text",
                     "text": "描述：",
-                    "text_type": "bold"
+                    "style": ["bold"]
                 }, {
                     "tag": "text",
-                    "text": "{{toHtml .Description}}\\n"
+                    "text": {{printf "%q" (print .Description)}}
                 }],{{end}}
                 {{if gt (len .Responders) 0}}[{
                     "tag": "text",
@@ -7587,10 +7620,10 @@ msg_type 必填，值为 post
                 }, {
                     "tag": "text",
                     "text": "处理人员：",
-                    "text_type": "bold"
+                    "style": ["bold"]
                 }, {
                     "tag": "text",
-                    "text": "{{range .Responders}}@{{.PersonName}} {{end}}\\n"
+                    "text": "{{range .Responders}}@{{.PersonName}} {{end}}"
                 }],{{end}}
                 [{
                     "tag": "a",
@@ -7604,6 +7637,20 @@ msg_type 必填，值为 post
                     "href": "{{.DetailUrl}}?ack=1",
                     "text": "认领"
                 }]
+                {{if or .IsFlapping .IsInStorm}},{{end}}
+                {{if .IsFlapping}}
+                [{
+                    "tag": "text",
+                    "text": "\\n 🔴 当前故障频繁发生与恢复，{{if .Flapping.MuteMinutes}}未来{{.Flapping.MuteMinutes}}分钟内此告警重复触发将不再通知。{{end}}建议您优化告警策略。"
+                }]
+                {{end}}
+                {{if and .IsFlapping .IsInStorm}},{{end}}
+                {{if .IsInStorm}}
+                ,[{
+                    "tag": "text",
+                    "text": "\\n 🔴 当前故障已聚合{{.AlertCnt}}条告警，触发告警风暴，请加急处理！"
+                }]
+                {{end}}
             ]
         }
     }
@@ -7738,94 +7785,100 @@ msg_type 必填，值为 post
 - 如果不设置自定义内容，将采用系统默认模板，仅展示关键信息：
 
 \`\`\`json
-{"head": {
-    "text": "{{fireReason .}}INC [#{{.Num}}] {{toHtml .Title}}",
+{
+"head": {
+  "text": "{{fireReason .}}INC [#{{.Num}}] {{.Title}}",
+  "style": {
+    "bold": true,
+    "italic": false,
+    "color": "{{$s := serverityToColor .IncidentSeverity}}{{$s}}"
+  }
+},
+"body": [
+  {
+    "type": "message",
+    "text": {{printf "%q" (print "协作空间：" .ChannelName)}},
     "style": {
-      "bold": true,
+      "bold": false,
+      "italic": false
+    }
+  },
+  {
+    "type": "message",
+    "text": "严重程度：{{.IncidentSeverity}}",
+    "style": {
+      "bold": false,
       "italic": false,
-      "color": "{{$s := serverityToColor .IncidentSeverity}}{{toHtml $s}}"
+      "color": "{{$s := serverityToColor .IncidentSeverity}}{{$s}}"
     }
   },
-  "body": [
-    {
-      "type": "message",
-      "text": "协作空间：{{if .ChannelName}}{{.ChannelName}}{{else}}无{{end}}",
-      "style": {
-        "bold": false,
-        "italic": false
-      }
-    },
-    {
-      "type": "message",
-      "text": "严重程度：{{.IncidentSeverity}}",
-      "style": {
-        "bold": false,
-        "italic": false,
-        "color": "{{$s := serverityToColor .IncidentSeverity}}{{toHtml $s}}"
-      }
-    },
-    {
-      "type": "message",
-      "text": "持续时长：{{ago .StartTime}}{{if gt .AlertCnt 1}}",
-      "style": {
-        "bold": false,
-        "italic": false
-      }
-    },
-    {
-      "type": "message",
-      "text": "聚合告警：{{.AlertCnt}}条{{end}}{{if .Labels.resource}}",
-      "style": {
-        "bold": false,
-        "italic": false
-      }
-    },
-    {
-        "type": "message",
-        "text": "告警对象：{{.Labels.resource}}{{end}}{{if .Description}}",
-        "style": {
-          "bold": false,
-          "italic": false
-        }
-      },
-    {
+  {
+    "type": "message",
+    "text": "{{if .AlertCnt}}聚合告警：{{.AlertCnt}}条{{end}}",
+    "style": {
+      "bold": false,
+      "italic": false
+    }
+  },
+  {{if .Labels.resource}}
+  {
       "type": "message",
-      "text": "故障描述：{{toHtml .Description}}{{end}}{{if gt (len .Responders) 0}}",
+      "text": {{printf "%q" (print "告警对象：" (joinAlertLabels . "resource" ", "))}},
       "style": {
         "bold": false,
         "italic": false
       }
-    },
-    {
+  },
+  {{end}}{{if .Labels.body_text}}
+  {
       "type": "message",
-      "text": "分派人员：{{range .Responders}}@{{.PersonName}}{{end}}{{end}}",
+      "text": {{printf "%q" (print "故障描述：" .Labels.body_text)}},
       "style": {
         "bold": false,
         "italic": false
       }
-    },
-    {
-        "type": "message",
-        "text": "查看详情",
-        "link": "{{.DetailUrl}}{{if .IsFlapping}}"
-    },
-    {
-      "type": "message",
-      "text": "注意：当前故障状态变化频繁，将收敛通知{{.Flapping.MuteMinutes}}分钟，建议您优化告警策略。{{end}}{{if .IsInStorm}}",
-      "style": {
-        "bold": true,
-        "italic": false
-      }
-    },
-    {
+  },
+  {{else if .Description}}
+  {
+    "type": "message",
+    "text": {{printf "%q" (print "故障描述：" .Description)}},
+    "style": {
+      "bold": false,
+      "italic": false
+    }
+  },
+  {{end}}{{if gt (len .Responders) 0}}
+  {
+    "type": "message",
+    "text": "处理人员：{{range .Responders}}@{{.PersonName}}{{end}}",
+    "style": {
+      "bold": false,
+      "italic": false
+    }
+  },
+  {{end}}
+  {
       "type": "message",
-      "text": "注意：当前故障已聚合{{.AlertCnt}}条告警，触发告警风暴，请加急处理！{{end}}",
-      "style": {
-        "bold": true,
-        "italic": false
-      }
+      "text": "查看详情",
+      "link": {{printf "%q" .DetailUrl}}
+  },
+  {
+    "type": "message",
+    "text": "{{if .IsFlapping}}🔴 当前故障频繁发生与恢复，{{if .Flapping.MuteMinutes}}未来{{.Flapping.MuteMinutes}}分钟内此告警重复触发将不再通知。{{end}}建议您优化告警策略。{{end}}",
+    "style": {
+      "bold": true,
+      "italic": false
     }
-  ]
+  },
+  {
+    "type": "message",
+    "text": "{{if .IsInStorm}}🔴 当前故障已聚合{{.AlertCnt}}条告警，触发告警风暴，请加急处理！{{end}}",
+    "style": {
+      "bold": true,
+      "italic": false
+    }
+  }
+]
 }
 \`\`\`
 </div>
@@ -7938,4 +7991,61 @@ msg_type 必填，值为 post
 <img src="https://download.flashcat.cloud/flashduty/changelog/20230720/email_render.png" alt="drawing" style="display: block; margin: 0 auto;" width="500"/>
 
 </div>
-`,dn={CustomAlert:n,Email:t,N9e:e,Prometheus:a,Grafana:i,Zabbix:s,UptimeKuma:l,AliyunARMS:d,AliyunCmEvent:o,AliyunCm:r,AliyunSLS:c,AWSCW:u,AzureMonitor:h,BaiDuBCM:m,HuaWeiCES:p,InfluxDB:g,OpenFalcon:y,PagerDuty:f,TencentBK:b,TencentCLS:v,TencentCm:w,TencentEb:_,OceanBase:k,Graylog:F,Skywalking:x,Sentry:T,Jiankongbao:A,AWSEventBridge:S,Dynatrace:C,HuaweiyunLTS:I,GoogleCM:L,Splunk:D,AppDynamics:P,SolarWinds:M,VolcEngineMetric:N,VolcEngineEvent:E,VolcEngineTLS:W,OpManager:$,Meraki:R,Zilliz:U,StateCloud:z,Guance:j,CustomChange:V,Jira:K,Lark:Z,Dingtalk:X,Wecom:Y,Slack:Q,MicrosoftTeams:nn,AlertWebhook:tn,IncidentWebhook:en,CustomAction:an,Templates:ln,HuaweiyunAPM:H,JiraSync:sn,ZStack:O,Keep:q,ElastAlert2:B,DingtalkAlert:J,FeishuAlert:G};module.exports=dn;
+`,dn=`---
+title: "Link 集成"
+description: "通过 Link 集成，可直接从故障属性、标签等信息中获取访问外部链接所需的关键参数，实现快速访问"
+date: "2025-05-19T10:00:00+08:00"
+url: "https://docs.flashcat.cloud/zh/flashduty/link-integration-guide"
+---
+
+通过 Link 集成，可直接从故障属性、标签等信息中获取访问外部链接所需的关键参数，实现快速访问
+
+## 配置说明
+
+Link 集成功能支持从故障属性、标签等信息中提取关键参数，实现与外部系统的快速跳转。通过自动化填充和跳转，避免了手动输入，提高了问题定位与处理的效率。该功能适用于故障排查、性能监控和系统调试等场景，有助于优化运维流程，提升响应速度与准确性
+
+### 打开方式
+
+#### 1. 弹窗
+在故障详情的当前页面中弹出窗口，保持原有界面状态，适合快速查看或操作后返回
+
+#### 2. 新标签页
+在浏览器新标签中打开链接，适用于需要保留当前操作上下文并同时访问外部内容的场景
+
+### URL 配置
+
+URL的参数引用内容为标签时以 labels. 开头；引用内容为自定义字段时，以 fields. 开头；引用内容为故障属性时，直接引用即可，如 .title、.severity 等
+
+#### 故障标签中获取
+支持通过 \${} 的方式从参数中动态取值，用于构造请求地址。例如参数值从故障标签（labels）中自动填充，无需手动输入：
+  
+\`\`\`
+https://cmdb.com/vm?sn=\${labels.sn}
+\`\`\`
+
+在上述示例中，\${labels.sn} 表示将故障中的 sn 标签值动态注入至 URL 中。如果故障数据中包含 sn=VM123456，则最终请求地址为：
+
+\`\`\`
+https://cmdb.com/vm?sn=VM123456
+\`\`\`
+
+
+#### 自定义字段中获取
+支持通过 \${} 的方式从参数中动态取值，用于构造请求地址。例如参数值从自定义字段（fields）中自动填充，无需手动输入：
+  
+\`\`\`
+https://cmdb.com/vm?sn=\${fields.sn}
+\`\`\`
+
+在上述示例中，\${fields.sn} 表示将故障中的 sn 自定义字段值动态注入至 URL 中。如果自定义字段数据中包含 sn=VM123456，则最终请求地址为：
+
+\`\`\`
+https://cmdb.com/vm?sn=VM123456
+\`\`\`
+
+### 注意事项
+
+1. 当引用的内容不存在时，Link 集成会正常生成对应的链接，但无法获取到值
+2. 同一个协作空间至多绑定三个 Link 集成
+3. 注意引用语法，如未按照要求进行书写引用变量，会导致无法正常获取对应值
+`,on={CustomAlert:n,Email:t,N9e:e,Prometheus:a,Grafana:i,Zabbix:s,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:T,Jiankongbao:A,AWSEventBridge:S,Dynatrace:C,HuaweiyunLTS:I,GoogleCM:L,Splunk:D,AppDynamics:P,SolarWinds:M,VolcEngineMetric:E,VolcEngineEvent:N,VolcEngineTLS:$,OpManager:W,Meraki:R,Zilliz:U,StateCloud:z,Guance:j,CustomChange:G,Jira:K,Lark:Z,Dingtalk:X,Wecom:Y,Slack:Q,MicrosoftTeams:nn,AlertWebhook:tn,IncidentWebhook:en,CustomAction:an,Templates:ln,HuaweiyunAPM:O,JiraSync:sn,ZStack:q,Keep:H,ElastAlert2:B,DingtalkAlert:V,FeishuAlert:J,Link:dn};module.exports=on;