flashduty-knowledge-base 1.2.7 → 1.2.9

package/dist/en.d.ts

@@ -1,3 +1,4 @@
+/** ⬆️⬆️⬆️⬆️ Other ⬆️⬆️⬆️⬆️ */
 declare const docs: {
     CustomAlert: string;
     Email: string;
@@ -59,5 +60,6 @@ declare const docs: {
     ElastAlert2: string;
     DingtalkAlert: string;
     FeishuAlert: string;
+    Link: string;
 };
 export default docs;

package/dist/esm/en.js

@@ -3267,7 +3267,7 @@ Choose this option when you need to route alerts to different channels based on
 
 </div>
 
-`,_=`---
+`,L=`---
 title: "Dynatrace Alert Events"
 description: "Sync Dynatrace alert events to Flashduty via webhook to achieve automated alert noise reduction."
 date: "2024-08-20T10:00:00+08:00"
@@ -3374,7 +3374,7 @@ Choose this option when you need to route alerts to different channels based on
 |CUSTOM_ALERT|Info|info|
 
 </div>
-`,L=`---
+`,_=`---
 title: "Huawei Cloud LTS Alert Events"
 description: "Sync Huawei Cloud Log Tank Service (LTS) alert events to Flashduty via webhook for automated alert noise reduction."
 date: "2024-08-20T10:00:00+08:00"
@@ -4522,7 +4522,7 @@ Choose this option when you need to route alerts to different channels based on
 | North | Beijing2/Changchun/Harbin/North China/Inner Mongolia3/Qingdao/Shenyang3/Shijiazhuang/Taiyuan/Tianjin/Zhengzhou |
 
 </div>
-`,G=`---
+`,q=`---
 title: "Guance Alert Events"
 description: "Sync Guance alert events to Flashduty via webhook for automated alert noise reduction"
 date: "2024-07-05T10:00:00+08:00"
@@ -4607,7 +4607,7 @@ Choose this option when you need to route alerts to different channels based on
 | Data Missing | Info | Info |
 
 </div>
-`,q=`---
+`,G=`---
 title: "Zilliz Alert Events"
 description: "Sync Zilliz alert events to Flashduty via webhook for automated alert noise reduction"
 date: "2024-07-05T10:00:00+08:00"
@@ -4874,7 +4874,7 @@ Choose this method when you need to route alerts to different channels based on
 
 </div>
 
-`,H=`---
+`,$=`---
 title: "Keep Alert Integration Guide"
 description: "Push alert events to Flashduty through Keep's Provider to achieve automated alert noise reduction."
 date: "2025-05-19T10:00:00+08:00"
@@ -4955,7 +4955,7 @@ Field|Required|Type|Definition
 
 <img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/en/fd/keep-2.png" />
 
-`,$=`---
+`,j=`---
 title: "ElastAlert2 Alert Integration Guide"
 description: "Push alert events to Flashduty through ElastAlert2's Provider to achieve automated alert noise reduction."
 date: "2025-05-19T10:00:00+08:00"
@@ -5076,7 +5076,7 @@ flashduty_env: "dev"
 # ------- FlashDuty ----------------
 \`\`\`
 
-5. Restart ElastAlert and wait for the alert to trigger.`,j=`---
+5. Restart ElastAlert and wait for the alert to trigger.`,H=`---
 title: "Dingtalk Alert Integration"
 description: "Generate a unique Dingtalk robot address in Flashduty, and synchronize the occurrence and recovery of alerts through Dingtalk"
 date: "2025-05-19T10:00:00+08:00"
@@ -5651,9 +5651,9 @@ After the application is released, you can access it via mobile/PC client. First
     - Return to the escalation rule configuration page, refresh and reselect the group chat list
     - If still unable to get the group chat list, try uninstalling the Cool App from the group and repeat the above steps. If it still doesn't work, please contact customer or dedicated technical support
 
-<img src="https://download.flashcat.cloud/flashduty/doc/en/ding/ding-18.png" alt="drawing" width="500"/>
+<img src="https://download.flashcat.cloud/flashduty/doc/en/dingtalk-install-1.png" alt="drawing" width="500"/>
 
-<img src="https://download.flashcat.cloud/flashduty/doc/en/ding/ding-19.png" alt="drawing" width="500"/>
+<img src="https://download.flashcat.cloud/flashduty/doc/en/dingtalk-install-2.png" alt="drawing" width="500"/>
 
 4. **Dingtalk Custom Application API Call Limits:** [Dingtalk Documentation](https://open.dingtalk.com/document/orgapp/descriptions-about-adjusting-limit-and-frequency-of-api-calls?spm=ding_open_doc.document.0.0.6f6b21d9WtkxJI)
 
@@ -7119,7 +7119,7 @@ Feishu/Lark bot supports message cards, rich text, and plain text formats. The d
 
 1. Message Card
 msg_type is required, value should be interactive
-\`\`\`
+\`\`\`json
 {
   "msg_type": "interactive",
   "card": {
@@ -7139,46 +7139,58 @@ msg_type is required, value should be interactive
       "fields": [{
           "text": {
             "tag": "lark_md",
-            "content": "**🏢 Channel:**{{if .ChannelName}}{{.ChannelName}}{{else}}None{{end}}"
+            "content": "**🏢 Channel: **{{.ChannelName}}"
+          }
+        },
+        {
+          "text": {
+            "tag": "lark_md",
+            "content": "**{{if eq .IncidentSeverity "Critical"}}🔴{{else if eq .IncidentSeverity "Warning"}}⚠️{{else}}ℹ️{{end}} Severity: **{{.IncidentSeverity}}"
           }
         },
         {
           "text": {
             "tag": "lark_md",
-            "content": "**{{if eq .IncidentSeverity "Critical"}}🔴{{else if eq .IncidentSeverity "Warning"}}⚠️{{else}}ℹ️{{end}} Severity:**{{.IncidentSeverity}}"
+            "content": "**⏰ Triggered at: **{{date "2006-01-02 15:04:05" .StartTime}}"
           }
         },
+        {{if gt .AlertCnt 1}}
         {
           "text": {
             "tag": "lark_md",
-            "content": "**⏰ Triggered at:**{{date "2006-01-02 15:04:05" .StartTime}}{{if gt .AlertCnt 1}}"
+            "content": "**🔔 Grouped alerts: **{{.AlertCnt}}"
           }
         },
+        {{end}}{{if .Labels.resource}}
         {
+          "tag": "div",
           "text": {
             "tag": "lark_md",
-            "content": "**🔔 Grouped alerts:**{{.AlertCnt}} {{end}}{{if .Labels.resource}}"
+            "content": {{printf "%q" (print "**📌 Resources: **" (joinAlertLabels . "resource" ","))}}
           }
         },
+        {{end}}{{if .Description}}
         {
           "tag": "div",
           "text": {
             "tag": "lark_md",
-            "content": "**📌 Alert targets:**{{toHtml (joinAlertLabels . "resource" ",")}} {{end}}{{if .Description}}"
+            "content": {{printf "%q" (print "**🔍 Description: **" .Description)}}
           }
         },
+        {{end}}{{if gt (len .Responders) 0}}
         {
           "tag": "div",
           "text": {
             "tag": "lark_md",
-            "content": "**🔍 Description:**{{.Description}}{{end}}{{if gt (len .Responders) 0}}"
+            "content": "**👨‍💻 Responders: **{{range .Responders}}@{{.PersonName}} {{end}}"
           }
         },
+        {{end}}
         {
           "tag": "div",
           "text": {
             "tag": "lark_md",
-            "content": "**👨‍💻 Responders:**{{range .Responders}}@{{.PersonName}} {{end}}{{end}}"
+            "content": ""
           }
         }
       ]
@@ -7201,20 +7213,41 @@ msg_type is required, value should be interactive
           "tag": "button",
           "text": {
             "tag": "plain_text",
-            "content": "Acknowledge"
+            "content": "Ack"
           },
           "type": "primary",
           "url": "{{.DetailUrl}}?ack=1"
         }
       ]
-    }]
+    }
+    {{if or .IsFlapping .IsInStorm}},{{end}}
+    {{if .IsFlapping}}
+    {
+        "tag": "div",
+        "text": {
+        "tag": "lark_md",
+        "content": "🔴 The current incident status changes frequently, notifications will be muted for {{.Flapping.MuteMinutes}} minute(s), it is recommended to optimize the alerting strategy."
+        }
+    }
+    {{end}}
+    {{if and .IsFlapping .IsInStorm}},{{end}}
+    {{if .IsInStorm}}
+    {
+        "tag": "div",
+        "text": {
+        "tag": "lark_md",
+        "content": "🔴 The current incident has grouped {{.AlertCnt}} alerts, triggering an alert storm, please handle it urgently!"
+        }
+    }
+    {{end}}
+    ]
   }
 }
 \`\`\`
 
 2. Rich Text
 msg_type is required, value should be post
-\`\`\`
+\`\`\`json
 {
     "msg_type": "post",
     "post": {
@@ -7226,78 +7259,77 @@ msg_type is required, value should be post
                     "text": "🏢 "
                 }, {
                     "tag": "text",
-                    "text": "Channel：",
-                    "text_type": "bold"
+                    "text": "Channel: ",
+                    "style": ["bold"]
                 }, {
                     "tag": "text",
-                    "text": "{{if .ChannelName}}{{.ChannelName}}{{else}}None{{end}}\\n"
+                    "text": "{{if .ChannelName}}{{.ChannelName}}{{else}}None{{end}}"
                 }],
                 [{
                     "tag": "text",
-                    "text": "{{if eq .IncidentSeverity "Critical"}}🔴{{else if eq .IncidentSeverity "Warning"}}⚠️{{else}}ℹ️{{end}} "
+                    "text": "{{if eq .IncidentSeverity "Critical"}}🔴{{else if eq .IncidentSeverity "Warning"}}⚠️{{else}}ℹ️{{end}}"
                 }, {
                     "tag": "text",
-                    "text": "Severity：",
-                    "text_type": "bold"
+                    "text": "Severity: ",
+                    "style": ["bold"]
                 }, {
                     "tag": "text",
-                    "text": "{{.IncidentSeverity}}\\n",
-                    "text_type": "{{if eq .IncidentSeverity "Critical"}}bold{{end}}"
+                    "text": "{{.IncidentSeverity}}"
                 }],
                 [{
                     "tag": "text",
                     "text": "⏰ "
                 }, {
                     "tag": "text",
-                    "text": "Triggered at：",
-                    "text_type": "bold"
+                    "text": "Triggered at: ",
+                    "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",
                     "text": "🔔 "
                 }, {
                     "tag": "text",
-                    "text": "Grouped alerts：",
-                    "text_type": "bold"
+                    "text": "Grouped alerts: ",
+                    "style": ["bold"]
                 }, {
                     "tag": "text",
-                    "text": "{{.AlertCnt}}\\n"
+                    "text": "{{.AlertCnt}}"
                 }],{{end}}
                 {{if .Labels.resource}}[{
                     "tag": "text",
                     "text": "📋 "
                 }, {
                     "tag": "text",
-                    "text": "Alert targets：",
-                    "text_type": "bold"
+                    "text": "Resources: ",
+                    "style": ["bold"]
                 }, {
                     "tag": "text",
-                    "text": "{{toHtml (joinAlertLabels . "resource" ", ")}}\\n"
+                    "text": {{printf "%q" (print (joinAlertLabels . "resource" ","))}}
                 }],{{end}}
                 {{if .Description}}[{
                     "tag": "text",
                     "text": "📝 "
                 }, {
                     "tag": "text",
-                    "text": "Description：",
-                    "text_type": "bold"
+                    "text": "Description: ",
+                    "style": ["bold"]
                 }, {
                     "tag": "text",
-                    "text": "{{toHtml .Description}}\\n"
+                    "text": {{printf "%q" (print .Description)}}
                 }],{{end}}
                 {{if gt (len .Responders) 0}}[{
                     "tag": "text",
                     "text": "👨‍💻 "
                 }, {
                     "tag": "text",
-                    "text": "Responders：",
-                    "text_type": "bold"
+                    "text": "Responders: ",
+                    "style": ["bold"]
                 }, {
                     "tag": "text",
-                    "text": "{{range .Responders}}@{{.PersonName}} {{end}}\\n"
+                    "text": "{{range .Responders}}@{{.PersonName}} {{end}}"
                 }],{{end}}
                 [{
                     "tag": "a",
@@ -7309,8 +7341,22 @@ msg_type is required, value should be post
                 },{
                     "tag": "a",
                     "href": "{{.DetailUrl}}?ack=1",
-                    "text": "Acknowledge"
+                    "text": "Ack"
+                }]
+                {{if or .IsFlapping .IsInStorm}},{{end}}
+                {{if .IsFlapping}}
+                [{
+                    "tag": "text",
+                    "text": "\\n 🔴 The incident triggers and recovers frequently, {{if .Flapping.MuteMinutes}}new notifications will be muted for {{.Flapping.MuteMinutes}} minute(s), {{end}}it is recommended to optimize the alerting strategy."
+                }]
+                {{end}}
+                {{if and .IsFlapping .IsInStorm}},{{end}}
+                {{if .IsInStorm}}
+                [{
+                    "tag": "text",
+                    "text": "\\n 🔴 The current incident has grouped {{.AlertCnt}} alerts, triggering an alert storm, please handle it urgently!"
                 }]
+                {{end}}
             ]
         }
     }
@@ -7444,94 +7490,100 @@ Responders: {{range .Responders}}@{{.PersonName}} {{end}}{{end}}
 - If no custom content is set, the system default template will be used to display key information:
 
 \`\`\`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 "Channel: " .ChannelName)}},
     "style": {
-      "bold": true,
+      "bold": false,
+      "italic": false
+    }
+  },
+  {
+    "type": "message",
+    "text": "Severity: {{.IncidentSeverity}}",
+    "style": {
+      "bold": false,
       "italic": false,
-      "color": "{{$s := serverityToColor .IncidentSeverity}}{{toHtml $s}}"
+      "color": "{{$s := serverityToColor .IncidentSeverity}}{{$s}}"
     }
   },
-  "body": [
-    {
-      "type": "message",
-      "text": "Channel: {{if .ChannelName}}{{.ChannelName}}{{else}}None{{end}}",
-      "style": {
-        "bold": false,
-        "italic": false
-      }
-    },
-    {
-      "type": "message",
-      "text": "Severity: {{.IncidentSeverity}}",
-      "style": {
-        "bold": false,
-        "italic": false,
-        "color": "{{$s := serverityToColor .IncidentSeverity}}{{toHtml $s}}"
-      }
-    },
-    {
-      "type": "message",
-      "text": "Duration: {{ago .StartTime}}{{if gt .AlertCnt 1}}",
-      "style": {
-        "bold": false,
-        "italic": false
-      }
-    },
-    {
-      "type": "message",
-      "text": "Grouped alerts: {{.AlertCnt}}{{end}}{{if .Labels.resource}}",
-      "style": {
-        "bold": false,
-        "italic": false
-      }
-    },
-    {
-        "type": "message",
-        "text": "Alert targets: {{.Labels.resource}}{{end}}{{if .Description}}",
-        "style": {
-          "bold": false,
-          "italic": false
-        }
-      },
-    {
+  {
+    "type": "message",
+    "text": "{{if .AlertCnt}}Grouped alerts: {{.AlertCnt}}{{end}}",
+    "style": {
+      "bold": false,
+      "italic": false
+    }
+  },
+  {{if .Labels.resource}}
+  {
       "type": "message",
-      "text": "Description: {{toHtml .Description}}{{end}}{{if gt (len .Responders) 0}}",
+      "text": {{printf "%q" (print "Resources: " (joinAlertLabels . "resource" ", "))}},
       "style": {
         "bold": false,
         "italic": false
       }
-    },
-    {
+  },
+  {{end}}{{if .Labels.body_text}}
+  {
       "type": "message",
-      "text": "Responders: {{range .Responders}}@{{.PersonName}}{{end}}{{end}}",
+      "text": {{printf "%q" (print "Description: " .Labels.body_text)}},
       "style": {
         "bold": false,
         "italic": false
       }
-    },
-    {
-        "type": "message",
-        "text": "View Details",
-        "link": "{{.DetailUrl}}{{if .IsFlapping}}"
-    },
-    {
-      "type": "message",
-      "text": "Note: The current incident status is changing frequently. Notifications will be suppressed for {{.Flapping.MuteMinutes}} minutes. Please optimize your alert policy.{{end}}{{if .IsInStorm}}",
-      "style": {
-        "bold": true,
-        "italic": false
-      }
-    },
-    {
+  },
+  {{else if .Description}}
+  {
+    "type": "message",
+    "text": {{printf "%q" (print "Description: " .Description)}},
+    "style": {
+      "bold": false,
+      "italic": false
+    }
+  },
+  {{end}}{{if gt (len .Responders) 0}}
+  {
+    "type": "message",
+    "text": "Responders: {{range .Responders}}@{{.PersonName}}{{end}}",
+    "style": {
+      "bold": false,
+      "italic": false
+    }
+  },
+  {{end}}
+  {
       "type": "message",
-      "text": "Note: The current incident has grouped {{.AlertCnt}} alerts, triggering an alert storm. Please handle with urgency!{{end}}",
-      "style": {
-        "bold": true,
-        "italic": false
-      }
+      "text": "Details",
+      "link": {{printf "%q" .DetailUrl}}
+  },
+  {
+    "type": "message",
+    "text": "{{if .IsFlapping}}🔴 The current incident status changes frequently, notifications will be muted for {{.Flapping.MuteMinutes}} minute(s), it is recommended to optimize the alerting strategy.{{end}}",
+    "style": {
+      "bold": true,
+      "italic": false
     }
-  ]
+  },
+  {
+    "type": "message",
+    "text": "{{if .IsInStorm}}🔴 The current incident has grouped {{.AlertCnt}} alerts, triggering an alert storm, please handle it urgently!{{end}}",
+    "style": {
+      "bold": true,
+      "italic": false
+    }
+  }
+]
 }
 \`\`\`
 </div>
@@ -7642,4 +7694,61 @@ As shown in the image below:
 
 <img src="https://download.flashcat.cloud/flashduty/changelog/20230720/email_render.png" alt="drawing" style="display: block; margin: 0 auto;" width="500"/>
 
-</div>`,oe={CustomAlert:n,Email:t,N9e:a,Prometheus:i,Grafana:o,Zabbix:s,UptimeKuma:r,AliyunARMS:l,AliyunCmEvent:d,AliyunCm:c,AliyunSLS:e,AWSCW:e,AzureMonitor:h,BaiDuBCM:u,HuaWeiCES:g,InfluxDB:p,OpenFalcon:m,PagerDuty:f,TencentBK:y,TencentCLS:v,TencentCm:b,TencentEb:w,OceanBase:C,Graylog:k,Skywalking:I,Sentry:S,Jiankongbao:A,AWSEventBridge:x,Dynatrace:_,HuaweiyunLTS:L,GoogleCM:F,Zilliz:q,Splunk:R,AppDynamics:T,SolarWinds:D,VolcEngineMetric:U,VolcEngineEvent:E,VolcEngineTLS:N,OpManager:P,Meraki:M,StateCloud:W,Guance:G,CustomChange:z,Jira:V,Lark:K,Dingtalk:J,Wecom:Z,Slack:Q,MicrosoftTeams:X,AlertWebhook:ee,IncidentWebhook:ne,CustomAction:te,Templates:ie,HuaweiyunAPM:O,JiraSync:ae,ZStack:Y,Keep:H,ElastAlert2:$,DingtalkAlert:j,FeishuAlert:B};module.exports=oe;
+</div>`,oe=`---
+title: "Link Integration"
+description: "Through Link integration, you can quickly access external links by obtaining key parameters from incident attributes, labels, and other information"
+date: "2025-05-19T10:00:00+08:00"
+url: "https://docs.flashcat.cloud/en/flashduty/link-integration-guide"
+---
+
+Through Link integration, you can quickly access external links by obtaining key parameters from incident attributes, labels, and other information
+
+## Configuration Guide
+
+Link integration supports extracting key parameters from incident attributes, labels, and other information to enable quick navigation to external systems. Through automated parameter filling and redirection, it eliminates manual input, improving the efficiency of problem identification and resolution. This feature is applicable to incident troubleshooting, performance monitoring, and system debugging scenarios, helping optimize operations processes and enhance response speed and accuracy.
+
+### Opening Methods
+
+#### 1. Pop-up Window
+Opens a window in the current incident details page, maintaining the original interface state, suitable for quick viewing or returning after operations
+
+#### 2. New Tab
+Opens the link in a new browser tab, suitable for scenarios where you need to retain the current operation context while accessing external content
+
+### URL Configuration
+
+When referencing content from labels, start with labels.; when referencing custom fields, start with fields.; when referencing incident attributes, reference them directly, such as .title .severity
+
+#### Retrieving from Incident Labels
+Supports dynamic value retrieval through \${} syntax to construct request URLs. For example, parameter values can be automatically filled from incident labels, requiring no manual input:
+  
+\`\`\`
+https://cmdb.com/vm?sn=\${labels.sn}
+\`\`\`
+
+In the above example, \${labels.sn} indicates that the sn label value from the incident will be dynamically injected into the URL. If the incident data contains sn=VM123456, the final request URL will be:
+
+\`\`\`
+https://cmdb.com/vm?sn=VM123456
+\`\`\`
+
+
+#### Retrieving from Custom Fields
+Supports dynamic value retrieval through \${} syntax to construct request URLs. For example, parameter values can be automatically filled from custom fields, requiring no manual input:
+  
+\`\`\`
+https://cmdb.com/vm?sn=\${fields.sn}
+\`\`\`
+
+In the above example, \${fields.sn} indicates that the sn custom field value will be dynamically injected into the URL. If the custom field data contains sn=VM123456, the final request URL will be:
+
+\`\`\`
+https://cmdb.com/vm?sn=VM123456
+\`\`\`
+
+### Notes
+
+1. When referenced content does not exist, Link integration will still generate the corresponding link but will not be able to retrieve the value
+2. Each channel can bind up to three Link integrations
+3. Pay attention to reference syntax; improper variable reference formatting will result in failure to retrieve corresponding values
+`,se={CustomAlert:n,Email:t,N9e:a,Prometheus:i,Grafana:o,Zabbix:s,UptimeKuma:r,AliyunARMS:l,AliyunCmEvent:d,AliyunCm:c,AliyunSLS:e,AWSCW:e,AzureMonitor:h,BaiDuBCM:u,HuaWeiCES:g,InfluxDB:p,OpenFalcon:m,PagerDuty:f,TencentBK:y,TencentCLS:v,TencentCm:b,TencentEb:w,OceanBase:C,Graylog:k,Skywalking:I,Sentry:S,Jiankongbao:A,AWSEventBridge:x,Dynatrace:L,HuaweiyunLTS:_,GoogleCM:F,Zilliz:G,Splunk:R,AppDynamics:T,SolarWinds:D,VolcEngineMetric:U,VolcEngineEvent:E,VolcEngineTLS:N,OpManager:P,Meraki:M,StateCloud:W,Guance:q,CustomChange:z,Jira:V,Lark:K,Dingtalk:J,Wecom:Z,Slack:Q,MicrosoftTeams:X,AlertWebhook:ee,IncidentWebhook:ne,CustomAction:te,Templates:ie,HuaweiyunAPM:O,JiraSync:ae,ZStack:Y,Keep:$,ElastAlert2:j,DingtalkAlert:H,FeishuAlert:B,Link:oe};module.exports=se;