flashduty-knowledge-base 1.2.6 → 1.2.8

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 CHANGED
@@ -1,3 +1,4 @@
1
+ /** ⬆️⬆️⬆️⬆️ Other ⬆️⬆️⬆️⬆️ */
1
2
  declare const docs: {
2
3
  CustomAlert: string;
3
4
  Email: string;
@@ -58,5 +59,7 @@ declare const docs: {
58
59
  Keep: string;
59
60
  ElastAlert2: string;
60
61
  DingtalkAlert: string;
62
+ FeishuAlert: string;
63
+ Link: string;
61
64
  };
62
65
  export default docs;
package/dist/esm/en.js CHANGED
@@ -3267,7 +3267,7 @@ Choose this option when you need to route alerts to different channels based on
3267
3267
 
3268
3268
  </div>
3269
3269
 
3270
- `,_=`---
3270
+ `,L=`---
3271
3271
  title: "Dynatrace Alert Events"
3272
3272
  description: "Sync Dynatrace alert events to Flashduty via webhook to achieve automated alert noise reduction."
3273
3273
  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
3374
3374
  |CUSTOM_ALERT|Info|info|
3375
3375
 
3376
3376
  </div>
3377
- `,L=`---
3377
+ `,_=`---
3378
3378
  title: "Huawei Cloud LTS Alert Events"
3379
3379
  description: "Sync Huawei Cloud Log Tank Service (LTS) alert events to Flashduty via webhook for automated alert noise reduction."
3380
3380
  date: "2024-08-20T10:00:00+08:00"
@@ -5160,6 +5160,89 @@ By default, the system always creates new alerts for each message, but you can s
5160
5160
  Currently, all alerts pushed to Flashduty through email integration are set to Warning severity.
5161
5161
 
5162
5162
  `,B=`---
5163
+ title: "Feishu Alert Integration"
5164
+ description: "Generate a unique Feishu robot address in Flashduty, and synchronize the occurrence and recovery of alerts through Feishu"
5165
+ date: "2025-05-19T10:00:00+08:00"
5166
+ url: "https://docs.flashcat.cloud/en/flashduty/Feishu-alert-integration-guide"
5167
+ ---
5168
+
5169
+ Generate a unique Feishu robot address in Flashduty, and synchronize the occurrence and recovery of alerts through Feishu.
5170
+
5171
+ <div class="hide">
5172
+
5173
+ ## Operation Steps
5174
+ ---
5175
+
5176
+ ### Create Feishu Alert Integration
5177
+
5178
+ You can obtain a Feishu alert integration address through either of these two methods:
5179
+
5180
+ #### Using Dedicated Integration
5181
+
5182
+ Choose this method when you don't need to route alert events to different channels. It's simpler and recommended.
5183
+
5184
+ <details>
5185
+ <summary>Expand</summary>
5186
+
5187
+ 1. Go to the Flashduty console, select **Channel**, and enter a specific channel's details page
5188
+ 2. Select the **Integration** tab, click **Add Integration** to enter the integration page
5189
+ 3. Choose **Feishu Alert** integration and click **Save** to generate a card
5190
+ 4. Click the generated card to view the **Feishu Alert Integration URL**, copy it for later use, and you're done
5191
+
5192
+ </details>
5193
+
5194
+ #### Using Shared Integration
5195
+
5196
+ Choose this method when you need to route alerts to different channels based on the alert event's payload information.
5197
+
5198
+ <details>
5199
+ <summary>Expand</summary>
5200
+
5201
+ 1. Go to the Flashduty console, select **Integration Center => Alert Events** to enter the integration selection page
5202
+ 2. Select **Feishu Alert** integration:
5203
+ - **Integration Name**: Define a name for the current integration
5204
+ - **Message Type**: Select Feishu alert message type, currently only Text and Markdown are supported
5205
+ - **Push Mode**: Choose when to trigger or recover alerts for Feishu notifications
5206
+ 3. Copy the **Feishu Alert Integration URL** for later use
5207
+ 4. Configure the default route and select the corresponding channel (after integration creation, you can go to \`Routes\` to configure more routing rules)
5208
+ 5. Done
5209
+
5210
+ </details>
5211
+ </div>
5212
+
5213
+ ### Customize Feishu Alert Integration
5214
+
5215
+ #### Feishu Alert Integration URL
5216
+
5217
+ The system will generate a unique Feishu alert integration URL for you. This URL is compatible with Feishu robot message protocol. When platforms only support Feishu robot channels, you can use this URL to receive corresponding messages.
5218
+
5219
+ #### Push Mode
5220
+
5221
+ By default, the system always creates new alerts for each message, but you can switch to these modes:
5222
+
5223
+ 1. **Trigger or Update Alert Based on Message Title**: In this mode, when receiving a new message, the system searches for open alerts based on the message title. If an alert is found, it will be updated; otherwise, a new alert will be triggered.
5224
+ 2. **Trigger or Close Alert Based on Rules**: In this mode, when receiving a new message, the system matches messages according to your rules and triggers new alerts or closes existing alerts based on the matching results.
5225
+
5226
+ - You need to fill in at least one **trigger** rule
5227
+ - You must set up regex extraction rules for Alert Key. The system uses this field to find historical alerts for updates or closure. **If regex extraction fails, the system will use the message title to generate an Alert Key** to ensure alerts won't be lost due to configuration errors
5228
+ - You can choose whether to discard messages when none of the rules match
5229
+
5230
+ Configuration example:
5231
+
5232
+ - Receive all messages, close the alert when the message content contains **RESOLVED**, otherwise trigger a new alert
5233
+ - Extract Alert Key from message title using the rule **/(.*)/**.
5234
+
5235
+
5236
+ ### Notes
5237
+ - Feishu alert integration URL only supports Text and post message types; other message types cannot be received
5238
+ - When Feishu message type is Text, Flashduty will generate a default alert title "Feishu Alert"
5239
+
5240
+ ## Severity Mapping
5241
+ ---
5242
+
5243
+ Currently, all alerts pushed to Flashduty through Feishu Alert integration are set to Warning severity.
5244
+
5245
+ `,z=`---
5163
5246
  title: "Custom Change Event Integration Guide"
5164
5247
  description: "Push change events from your own systems to Flashduty using standard protocols. Most incidents are caused by changes, and the correlation between changes and alerts helps quickly identify incident causes."
5165
5248
  date: "2025-05-19T10:00:00+08:00"
@@ -5216,7 +5299,7 @@ Labels are descriptions of events. You should enrich label content as much as po
5216
5299
 
5217
5300
  </details>
5218
5301
 
5219
- `,z=`---
5302
+ `,V=`---
5220
5303
  title: "Jira Issue Events"
5221
5304
  description: "Sync Jira Issue events to Flashduty via webhooks to collect change events."
5222
5305
  date: "2025-05-19T10:00:00+08:00"
@@ -5290,7 +5373,7 @@ Flashduty extracts the status.name information from the webhook payload by defau
5290
5373
  Please contact Flashduty if you wish to modify this mapping.
5291
5374
 
5292
5375
  </div>
5293
- `,V=`---
5376
+ `,K=`---
5294
5377
  title: Contributing to our documentation — Meilisearch documentation
5295
5378
  description: The Meilisearch documentation is open-source. Learn how to help make it even better.
5296
5379
  sidebarDepth: 3
@@ -5425,7 +5508,7 @@ Once published, you can access the application via mobile/PC client. First-time
5425
5508
  |Group Bot Webhook|Maximum 100 calls/minute|
5426
5509
  |Sending messages to the same user or group|Maximum 5 calls/second|
5427
5510
 
5428
- **Note:** Messages cannot be pushed normally when exceeding limits, please use notification channels reasonably`,K=`---
5511
+ **Note:** Messages cannot be pushed normally when exceeding limits, please use notification channels reasonably`,J=`---
5429
5512
  title: "Dingtalk Integration"
5430
5513
  description: "Integrate with Dingtalk custom application to receive and respond to alerts within Dingtalk"
5431
5514
  date: "2025-05-19T10:00:00+08:00"
@@ -5581,7 +5664,7 @@ After the application is released, you can access it via mobile/PC client. First
5581
5664
  |Enterprise|5,500,000|60|1st of each month|
5582
5665
 
5583
5666
  **Note:** Messages cannot be pushed normally after exceeding limits, please use notification channels reasonably
5584
- `,J=`---
5667
+ `,Z=`---
5585
5668
  title: "WeCom Integration"
5586
5669
  description: "Integrate WeCom third-party application to receive and respond to alerts within WeCom"
5587
5670
  date: "2025-05-19T10:00:00+08:00"
@@ -5660,7 +5743,7 @@ Integrate WeCom third-party application to receive and respond to alerts within
5660
5743
  7. **Incident notification fails with \`WeCom License Not Activated\`?**
5661
5744
 
5662
5745
  - Contact Flashduty customer service or dedicated support for license purchase and activation
5663
- `,Z=`---
5746
+ `,Q=`---
5664
5747
  title: "Slack Integration"
5665
5748
  description: "Integrate with Slack to receive and respond to alerts within Slack"
5666
5749
  date: "2025-05-19T10:00:00+08:00"
@@ -5714,7 +5797,7 @@ Integrate with Slack to receive and respond to alerts within Slack.
5714
5797
 
5715
5798
  8. **Slack App shows Other questions error**
5716
5799
  - Try again, as this might be an unrecorded issue
5717
- - If the error persists, contact customer support`,Q=`---
5800
+ - If the error persists, contact customer support`,X=`---
5718
5801
  title: "Microsoft Teams Integration"
5719
5802
  description: "Integrate Microsoft Teams as a third-party application to receive and respond to alerts within Microsoft Teams"
5720
5803
  date: "2025-05-19T10:00:00+08:00"
@@ -5809,7 +5892,7 @@ Please check in Integration Center => Instant Messaging => Microsoft Teams under
5809
5892
  Currently not supported
5810
5893
  </details>
5811
5894
 
5812
- `,X=`Configure alert webhooks to receive HTTP callbacks at your specified URL when alerts have specific actions (such as triggering or closing). The callback content includes the latest key information about the alert, allowing integration with your custom tools.
5895
+ `,ee=`Configure alert webhooks to receive HTTP callbacks at your specified URL when alerts have specific actions (such as triggering or closing). The callback content includes the latest key information about the alert, allowing integration with your custom tools.
5813
5896
 
5814
5897
  <span id="EventTypes"></span>
5815
5898
 
@@ -5977,7 +6060,7 @@ curl -X POST 'https://example.com/alert/webhook?a=a' \\
5977
6060
  4. **Trusted IP whitelist for push sources?**
5978
6061
  - {ip_whitelist}
5979
6062
  - May be updated in the future, please check periodically
5980
- `,ee=`Configure incident webhooks to receive HTTP callbacks at your specified URL when incidents have specific actions (such as triggering or closing). The callback content includes the latest key information about the incident, allowing integration with your custom tools.
6063
+ `,ne=`Configure incident webhooks to receive HTTP callbacks at your specified URL when incidents have specific actions (such as triggering or closing). The callback content includes the latest key information about the incident, allowing integration with your custom tools.
5981
6064
 
5982
6065
  <span id="EventTypes"></span>
5983
6066
 
@@ -6184,7 +6267,7 @@ curl -X POST 'https://example.com/incident/webhook?a=a' \\
6184
6267
 
6185
6268
  4. **Trusted IP whitelist for push sources?**
6186
6269
  - {ip_whitelist}
6187
- - May be updated in the future, please check periodically`,ne=`Custom incident actions allow you to quickly invoke external interfaces during incident troubleshooting for incident self-healing, information enrichment, and other custom operations.
6270
+ - May be updated in the future, please check periodically`,te=`Custom incident actions allow you to quickly invoke external interfaces during incident troubleshooting for incident self-healing, information enrichment, and other custom operations.
6188
6271
 
6189
6272
  ## I. Creating Actions
6190
6273
 
@@ -6431,7 +6514,7 @@ When an incident occurs and is confirmed to be caused by a change, directly trig
6431
6514
 
6432
6515
  ### Update Status Page
6433
6516
 
6434
- When an incident is confirmed to affect online services, trigger external status page updates to prompt`,te=`---
6517
+ When an incident is confirmed to affect online services, trigger external status page updates to prompt`,ae=`---
6435
6518
  title: "Jira Sync"
6436
6519
  description: "Sync incidents with Jira issues through Jira Sync Webhook."
6437
6520
  date: "2025-05-19T10:00:00+08:00"
@@ -6513,7 +6596,7 @@ In the Integration Center, select **Webhook**, choose **Jira Sync** integration,
6513
6596
 
6514
6597
  - Flashduty syncs information according to default field mappings and your custom field configurations. If your Jira issue type has required fields without mapping relationships, Jira issue creation may fail.
6515
6598
  - Jira issue details are accessed using project KEY + number format. If you modify the project KEY, saved issue URLs in Flashduty may become inaccessible, so please modify project KEYs with caution.
6516
- `,ae=`---
6599
+ `,ie=`---
6517
6600
  title: "Configure Notification Templates"
6518
6601
  description: "Customize notification content through template configuration"
6519
6602
  date: "2024-05-10T10:00:00+08:00"
@@ -7559,4 +7642,61 @@ As shown in the image below:
7559
7642
 
7560
7643
  <img src="https://download.flashcat.cloud/flashduty/changelog/20230720/email_render.png" alt="drawing" style="display: block; margin: 0 auto;" width="500"/>
7561
7644
 
7562
- </div>`,ie={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:B,Jira:z,Lark:V,Dingtalk:K,Wecom:J,Slack:Z,MicrosoftTeams:Q,AlertWebhook:X,IncidentWebhook:ee,CustomAction:ne,Templates:ae,HuaweiyunAPM:O,JiraSync:te,ZStack:Y,Keep:H,ElastAlert2:$,DingtalkAlert:j};module.exports=ie;
7645
+ </div>`,oe=`---
7646
+ title: "Link Integration"
7647
+ description: "Through Link integration, you can quickly access external links by obtaining key parameters from incident attributes, labels, and other information"
7648
+ date: "2025-05-19T10:00:00+08:00"
7649
+ url: "https://docs.flashcat.cloud/en/flashduty/link-integration-guide"
7650
+ ---
7651
+
7652
+ Through Link integration, you can quickly access external links by obtaining key parameters from incident attributes, labels, and other information
7653
+
7654
+ ## Configuration Guide
7655
+
7656
+ 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.
7657
+
7658
+ ### Opening Methods
7659
+
7660
+ #### 1. Pop-up Window
7661
+ Opens a window in the current incident details page, maintaining the original interface state, suitable for quick viewing or returning after operations
7662
+
7663
+ #### 2. New Tab
7664
+ Opens the link in a new browser tab, suitable for scenarios where you need to retain the current operation context while accessing external content
7665
+
7666
+ ### URL Configuration
7667
+
7668
+ 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
7669
+
7670
+ #### Retrieving from Incident Labels
7671
+ 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:
7672
+
7673
+ \`\`\`
7674
+ https://cmdb.com/vm?sn=\${labels.sn}
7675
+ \`\`\`
7676
+
7677
+ 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:
7678
+
7679
+ \`\`\`
7680
+ https://cmdb.com/vm?sn=VM123456
7681
+ \`\`\`
7682
+
7683
+
7684
+ #### Retrieving from Custom Fields
7685
+ 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:
7686
+
7687
+ \`\`\`
7688
+ https://cmdb.com/vm?sn=\${fields.sn}
7689
+ \`\`\`
7690
+
7691
+ 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:
7692
+
7693
+ \`\`\`
7694
+ https://cmdb.com/vm?sn=VM123456
7695
+ \`\`\`
7696
+
7697
+ ### Notes
7698
+
7699
+ 1. When referenced content does not exist, Link integration will still generate the corresponding link but will not be able to retrieve the value
7700
+ 2. Each channel can bind up to three Link integrations
7701
+ 3. Pay attention to reference syntax; improper variable reference formatting will result in failure to retrieve corresponding values
7702
+ `,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: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,Link:oe};module.exports=se;
package/dist/esm/zh.js CHANGED
@@ -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
- `,I=`---
3608
+ `,L=`---
3609
3609
  title: "华为云日志服务 LTS 告警事件"
3610
3610
  description: "通过 webhook 的方式同步华为云日志服务 LTS 告警事件到 Flashduty,实现告警事件自动化降噪处理。"
3611
3611
  date: "2024-08-20T10:00:00+08:00"
@@ -3721,7 +3721,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/huaweilts-integration-guide"
3721
3721
  |Info|Info|提醒|
3722
3722
 
3723
3723
  </div>
3724
- `,L=`---
3724
+ `,I=`---
3725
3725
  title: "GoogleCloudMonitoring 告警事件"
3726
3726
  description: "通过 webhook 的方式同步 GoogleCloudMonitoring 告警事件到 Flashduty,实现告警事件自动化降噪处理"
3727
3727
  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
- `,W=`---
4347
+ `,$=`---
4348
4348
  title: "火山引擎日志服务 TLS 告警事件"
4349
4349
  description: "通过 webhook 的方式同步火山引擎日志服务 TLS 告警事件到 Flashduty,实现告警事件自动化降噪处理"
4350
4350
  date: "2024-07-05T10:00:00+08:00"
@@ -4481,7 +4481,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-tls-integration-guide"
4481
4481
  |通知|Info|提醒|
4482
4482
 
4483
4483
  </div>
4484
- `,$=`---
4484
+ `,W=`---
4485
4485
  title: "Opmanager 告警事件"
4486
4486
  description: "通过 webhook 的方式同步 Opmanager 告警事件到 Flashduty,实现告警事件自动化降噪处理"
4487
4487
  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
- `,j=`---
4783
+ `,U=`---
4784
4784
  title: "观测云告警事件"
4785
4785
  description: "通过 webhook 的方式同步观测云告警事件到 Flashduty,实现告警事件自动化降噪处理"
4786
4786
  date: "2024-07-05T10:00:00+08:00"
@@ -4868,7 +4868,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/guance-integration-guide"
4868
4868
  | 数据断档 | Info | 提醒 |
4869
4869
 
4870
4870
  </div>
4871
- `,U=`---
4871
+ `,j=`---
4872
4872
  title: "zilliz 告警事件"
4873
4873
  description: "通过 webhook 的方式同步 zilliz 告警事件到 Flashduty,实现告警事件自动化降噪处理"
4874
4874
  date: "2024-07-05T10:00:00+08:00"
@@ -5342,7 +5342,7 @@ flashduty_env: "dev"
5342
5342
  # ------- FlashDuty ----------------
5343
5343
  \`\`\`
5344
5344
 
5345
- 5.重启 ElastAlert,等待告警触发。`,J=`---
5345
+ 5.重启 ElastAlert,等待告警触发。`,V=`---
5346
5346
  title: "钉钉告警集成"
5347
5347
  description: "在 Flashduty 生成唯一的钉钉机器人地址,通过钉钉的方式将告警的发生与恢复同步到 Flashduty"
5348
5348
  date: "2025-05-19T10:00:00+08:00"
@@ -5423,7 +5423,90 @@ url: "https://docs.flashcat.cloud/zh/flashduty/dingtalk-alert-integration-guide"
5423
5423
  ## 严重程度映射关系
5424
5424
  ---
5425
5425
 
5426
- 当前邮件集成推送到 Flashduty 的告警等级均为Warning。
5426
+ 当前钉钉告警集成推送到 Flashduty 的严重程度均为Warning。
5427
+
5428
+ `,J=`---
5429
+ title: "飞书告警集成"
5430
+ description: "在 Flashduty 生成唯一的飞书机器人地址,通过飞书的方式将告警的发生与恢复同步到 Flashduty"
5431
+ date: "2025-05-19T10:00:00+08:00"
5432
+ url: "https://docs.flashcat.cloud/zh/flashduty/feishu-alert-integration-guide"
5433
+ ---
5434
+
5435
+ 在 Flashduty 生成唯一的飞书告警地址,通过飞书告警地址将告警的发生与恢复同步到 Flashduty。
5436
+
5437
+ <div class="hide">
5438
+
5439
+ ## 操作步骤
5440
+ ---
5441
+
5442
+ ### 创建飞书告警集成
5443
+
5444
+ 您可通过以下2种方式,获取一个飞书告警集成地址,任选其一即可。
5445
+
5446
+ #### 使用专属集成
5447
+
5448
+ 当您不需要将告警事件路由到不同的协作空间,优先选择此方式,更简单。
5449
+
5450
+ <details>
5451
+ <summary>展开</summary>
5452
+
5453
+ 1. 进入 Flashduty 控制台,选择 **协作空间**,进入某个空间的详情页面
5454
+ 2. 选择 **集成数据** tab,点击 **添加一个集成**,进入添加集成页面
5455
+ 3. 选择 **飞书告警** 集成,点击 **保存**,生成卡片。
5456
+ 4. 点击生成的卡片,可以查看到 **飞书告警集成地址**,复制备用,完成。
5457
+
5458
+ </details>
5459
+
5460
+ #### 使用共享集成
5461
+
5462
+ 当您需要根据告警事件的 Payload 信息,将告警路由到不同的协作空间,优先选择此方式。
5463
+
5464
+ <details>
5465
+ <summary>展开</summary>
5466
+
5467
+ 1. 进入 Flashduty 控制台,选择 **集成中心=>告警事件**,进入集成选择页面。
5468
+ 2. 选择 **飞书告警** 集成:
5469
+ - **集成名称**:为当前集成定义一个名称。
5470
+ - **消息类型**:选择飞书告警消息类型,目前仅支持 Text、Markdown。
5471
+ - **推送模式**:选择飞书告警在何种情况下触发或恢复告警。
5472
+ 3. 复制当前页面的 **飞书告警集成地址** 备用。
5473
+ 4. 配置默认路由,并选择对应的协作空间(集成创建后可以前往 \`路由\` 进行更多路由规则的配置)。
5474
+ 5. 完成。
5475
+
5476
+ </details>
5477
+ </div>
5478
+
5479
+ ### 定制飞书告警集成
5480
+
5481
+ #### 飞书告警集成地址
5482
+
5483
+ 系统会帮您生成一个唯一的飞书告警集成地址,该地址兼容飞书机器人消息的协议,在有的平台仅支持飞书机器人通道时,您可以使用该地址来接收对应的消息。
5484
+
5485
+ #### 推送模式
5486
+
5487
+ 默认系统总是为每一条消息创建新的告警,但您可以切换模式为:
5488
+
5489
+ 1. **根据消息标题触发或更新告警**:该模式下,每当接收到新消息,系统会根据消息标题查找未关闭告警。如果找到告警则进行更新,否则系统会触发一条新的告警。
5490
+ 2. **根据规则触发或关闭告警**:该模式下,每当接收到新消息,系统会根据您的规则进行消息匹配,匹配到的消息按照规则去触发新告警或关闭已有告警。
5491
+
5492
+ - 您至少需要填写一条**触发**规则;
5493
+ - 您必须设置 Alert Key 的正则提取规则。系统使用该字段来查找历史告警,以便对其进行更新或关闭;**如果正则提取失败,系统将使用消息标题来生成 Alert Key**,以确保告警不会因为配置错误而丢失;
5494
+ - 您可以选择,当所有的规则都不匹配时,是否丢弃消息。
5495
+
5496
+ 配置示例:
5497
+
5498
+ - 接收所有消息,当消息内容中包含 **RESOVED** 字样时,关闭告警,否则触发新告警;
5499
+ - Alert Key 从消息标题中提取,规则为 **/(.\\*)/**。
5500
+
5501
+
5502
+ ### 注意事项
5503
+ - 飞书告警集成地址仅支持接收文本、富文本中 text 和 markdown 的消息类型,其他消息无法接收。
5504
+ - 当飞书消息类型是Text 时,Flashduty 会生成默认告警标题 “飞书告警”。
5505
+
5506
+ ## 严重程度映射关系
5507
+ ---
5508
+
5509
+ 当前飞书告警集成推送到 Flashduty 的严重程度均为 Warning。
5427
5510
 
5428
5511
  `,G=`---
5429
5512
  title: "自定义变更事件集成指引"
@@ -5482,7 +5565,7 @@ Flashduty 已经适配部分常用工单、部署系统的 webhook 协议,对
5482
5565
 
5483
5566
  </details>
5484
5567
 
5485
- `,V=`---
5568
+ `,K=`---
5486
5569
  title: "Jira 事件集成指引"
5487
5570
  description: "通过 webhook 的方式同步 Jira Issue 事件到 Flashduty,实现变更事件收集。"
5488
5571
  date: "2025-05-19T10:00:00+08:00"
@@ -5556,7 +5639,7 @@ Flashduty 默认提取 webhook payload 中 status.name 信息,并按照下边
5556
5639
  如您希望变更此映射关系,请联系 Flashduty。
5557
5640
 
5558
5641
  </div>
5559
- `,K=`---
5642
+ `,Z=`---
5560
5643
  title: Contributing to our documentation — Meilisearch documentation
5561
5644
  description: The Meilisearch documentation is open-source. Learn how to help make it even better.
5562
5645
  sidebarDepth: 3
@@ -5693,7 +5776,7 @@ sidebarDepth: 3
5693
5776
  |给同一个用户或同一个群发消息|最高频率 5 次/秒|
5694
5777
 
5695
5778
  **注意:** 超出限制后将无法正常推送消息,建议合理使用通知渠道
5696
- `,Z=`---
5779
+ `,X=`---
5697
5780
  title: "钉钉集成"
5698
5781
  description: "通过集成钉钉自建应用,实现在钉钉端内接收和响应告警的能力"
5699
5782
  date: "2025-05-19T10:00:00+08:00"
@@ -5853,7 +5936,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/dingtalk-integration-guide"
5853
5936
  |专属版|550万次|60| 每月1日 |
5854
5937
 
5855
5938
  **注意:** 超出限制后将无法正常推送消息,建议合理使用通知渠道
5856
- `,X=`---
5939
+ `,Y=`---
5857
5940
  title: "企业微信集成"
5858
5941
  description: "通过集成企业微信第三方应用,实现在企业微信端内接收和响应告警的能力"
5859
5942
  date: "2025-05-19T10:00:00+08:00"
@@ -5933,7 +6016,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/wecom-integration-guide"
5933
6016
  7. **故障通知失败,提示\`未开通企微许可\`?**
5934
6017
 
5935
6018
  - 联系 Flashduty 客服或专属支持,为您购买开通
5936
- `,Y=`---
6019
+ `,Q=`---
5937
6020
  title: "Slack 集成"
5938
6021
  description: "通过集成Slack第三方应用,实现在Slack内接收和响应告警的能力"
5939
6022
  date: "2025-05-19T10:00:00+08:00"
@@ -5987,7 +6070,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/slack-integration-guide"
5987
6070
 
5988
6071
  8. **Slack App 内 Other questions,报错**
5989
6072
  - 重新操作,遇到了还没被记录的问题
5990
- - 重试后仍然报错,联系客服`,Q=`---
6073
+ - 重试后仍然报错,联系客服`,nn=`---
5991
6074
  title: "Microsoft Teams集成"
5992
6075
  description: "通过集成 Microsoft Teams 第三方应用,实现在 Microsoft Teams 内接收和响应告警的能力"
5993
6076
  date: "2025-05-19T10:00:00+08:00"
@@ -6082,7 +6165,7 @@ Microsoft Teams 集成现处于 Beta 阶段,在关联前您需要先完成以
6082
6165
  暂不支持
6083
6166
  </details>
6084
6167
 
6085
- `,nn=`配置告警 Webhook,当告警发生特定操作(如触发、关闭)时,系统通过 HTTP 回调您配置的地址。回调内容将包含告警最新关键信息,您可以与自研工具进行集成。
6168
+ `,tn=`配置告警 Webhook,当告警发生特定操作(如触发、关闭)时,系统通过 HTTP 回调您配置的地址。回调内容将包含告警最新关键信息,您可以与自研工具进行集成。
6086
6169
 
6087
6170
  <span id="EventTypes"></span>
6088
6171
 
@@ -6250,7 +6333,7 @@ curl -X POST 'https://example.com/alert/webhook?a=a' \\
6250
6333
  4. **推送来源可信 IP 白名单?**
6251
6334
  - {ip_whitelist}
6252
6335
  - 未来可能会更新,请定期查验
6253
- `,tn=`配置故障 Webhook,当故障发生特定操作(如触发、关闭)时,系统通过 HTTP 回调您配置的地址。回调内容将包含故障最新关键信息,您可以与自研工具进行集成。
6336
+ `,en=`配置故障 Webhook,当故障发生特定操作(如触发、关闭)时,系统通过 HTTP 回调您配置的地址。回调内容将包含故障最新关键信息,您可以与自研工具进行集成。
6254
6337
 
6255
6338
  <span id="EventTypes"></span>
6256
6339
 
@@ -6458,7 +6541,7 @@ curl -X POST 'https://example.com/incident/webhook?a=a' \\
6458
6541
 
6459
6542
  4. **推送来源可信 IP 白名单?**
6460
6543
  - {ip_whitelist}
6461
- - 未来可能会更新,请定期查验`,en=`配置故障 自定义操作,允许您在故障排查期间,快速调用外部接口,实现故障自愈、信息丰富等任何自定义操作。
6544
+ - 未来可能会更新,请定期查验`,an=`配置故障 自定义操作,允许您在故障排查期间,快速调用外部接口,实现故障自愈、信息丰富等任何自定义操作。
6462
6545
 
6463
6546
  ## 一、创建操作
6464
6547
 
@@ -6717,7 +6800,7 @@ curl -X POST 'https://example.com/incident/action?a=a' \\
6717
6800
 
6718
6801
  2. **推送来源可信 IP 白名单?**
6719
6802
  - {ip_whitelist}
6720
- - 未来可能会更新,请定期查验`,an=`---
6803
+ - 未来可能会更新,请定期查验`,sn=`---
6721
6804
  title: "Jira 同步"
6722
6805
  description: "通过 Jira 同步 Webhook,实现故障与 Jira Issue 的关联。"
6723
6806
  date: "2025-05-19T10:00:00+08:00"
@@ -6802,7 +6885,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/jira-sync"
6802
6885
 
6803
6886
  - Flashduty 会按照默认的字段映射以及您配置的自定义字段映射进行同步信息,如果您的 Jira 事务类型中有必选的字段且没有配置映射关系,则会遇到创建 Jira Issue 失败的情况。
6804
6887
  - Jira 的 Issue 详情是基于项目 KEY + 编号的格式进行访问的,如果您修改了项目 KEY,可能无法通过 Flashduty 中保存的 Issue 地址进行访问,请谨慎修改项目 KEY。
6805
- `,sn=`---
6888
+ `,ln=`---
6806
6889
  title: "配置通知模版"
6807
6890
  description: "通过自定义配置模版,可以实现个性化通知内容的需求"
6808
6891
  date: "2024-05-10T10:00:00+08:00"
@@ -7855,4 +7938,61 @@ msg_type 必填,值为 post
7855
7938
  <img src="https://download.flashcat.cloud/flashduty/changelog/20230720/email_render.png" alt="drawing" style="display: block; margin: 0 auto;" width="500"/>
7856
7939
 
7857
7940
  </div>
7858
- `,ln={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:G,Jira:V,Lark:K,Dingtalk:Z,Wecom:X,Slack:Y,MicrosoftTeams:Q,AlertWebhook:nn,IncidentWebhook:tn,CustomAction:en,Templates:sn,HuaweiyunAPM:H,JiraSync:an,ZStack:O,Keep:q,ElastAlert2:B,DingtalkAlert:J};module.exports=ln;
7941
+ `,dn=`---
7942
+ title: "Link 集成"
7943
+ description: "通过 Link 集成,可直接从故障属性、标签等信息中获取访问外部链接所需的关键参数,实现快速访问"
7944
+ date: "2025-05-19T10:00:00+08:00"
7945
+ url: "https://docs.flashcat.cloud/zh/flashduty/link-integration-guide"
7946
+ ---
7947
+
7948
+ 通过 Link 集成,可直接从故障属性、标签等信息中获取访问外部链接所需的关键参数,实现快速访问
7949
+
7950
+ ## 配置说明
7951
+
7952
+ Link 集成功能支持从故障属性、标签等信息中提取关键参数,实现与外部系统的快速跳转。通过自动化填充和跳转,避免了手动输入,提高了问题定位与处理的效率。该功能适用于故障排查、性能监控和系统调试等场景,有助于优化运维流程,提升响应速度与准确性
7953
+
7954
+ ### 打开方式
7955
+
7956
+ #### 1. 弹窗
7957
+ 在故障详情的当前页面中弹出窗口,保持原有界面状态,适合快速查看或操作后返回
7958
+
7959
+ #### 2. 新标签页
7960
+ 在浏览器新标签中打开链接,适用于需要保留当前操作上下文并同时访问外部内容的场景
7961
+
7962
+ ### URL 配置
7963
+
7964
+ URL的参数引用内容为标签时以 labels. 开头;引用内容为自定义字段时,以 fields. 开头;引用内容为故障属性时,直接引用即可,如 .title、.severity 等
7965
+
7966
+ #### 故障标签中获取
7967
+ 支持通过 \${} 的方式从参数中动态取值,用于构造请求地址。例如参数值从故障标签(labels)中自动填充,无需手动输入:
7968
+
7969
+ \`\`\`
7970
+ https://cmdb.com/vm?sn=\${labels.sn}
7971
+ \`\`\`
7972
+
7973
+ 在上述示例中,\${labels.sn} 表示将故障中的 sn 标签值动态注入至 URL 中。如果故障数据中包含 sn=VM123456,则最终请求地址为:
7974
+
7975
+ \`\`\`
7976
+ https://cmdb.com/vm?sn=VM123456
7977
+ \`\`\`
7978
+
7979
+
7980
+ #### 自定义字段中获取
7981
+ 支持通过 \${} 的方式从参数中动态取值,用于构造请求地址。例如参数值从自定义字段(fields)中自动填充,无需手动输入:
7982
+
7983
+ \`\`\`
7984
+ https://cmdb.com/vm?sn=\${fields.sn}
7985
+ \`\`\`
7986
+
7987
+ 在上述示例中,\${fields.sn} 表示将故障中的 sn 自定义字段值动态注入至 URL 中。如果自定义字段数据中包含 sn=VM123456,则最终请求地址为:
7988
+
7989
+ \`\`\`
7990
+ https://cmdb.com/vm?sn=VM123456
7991
+ \`\`\`
7992
+
7993
+ ### 注意事项
7994
+
7995
+ 1. 当引用的内容不存在时,Link 集成会正常生成对应的链接,但无法获取到值
7996
+ 2. 同一个协作空间至多绑定三个 Link 集成
7997
+ 3. 注意引用语法,如未按照要求进行书写引用变量,会导致无法正常获取对应值
7998
+ `,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: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:L,GoogleCM:I,Splunk:D,AppDynamics:P,SolarWinds:M,VolcEngineMetric:N,VolcEngineEvent:E,VolcEngineTLS:$,OpManager:W,Meraki:R,Zilliz:j,StateCloud:z,Guance:U,CustomChange:G,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:V,FeishuAlert:J,Link:dn};module.exports=on;
package/dist/iife/en.js CHANGED
@@ -7559,4 +7559,144 @@ By default, the system always creates new alerts for each message, but you can s
7559
7559
 
7560
7560
  Currently, all alerts pushed to Flashduty through email integration are set to Warning severity.
7561
7561
 
7562
+ `,FeishuAlert:`---
7563
+ title: "Feishu Alert Integration"
7564
+ description: "Generate a unique Feishu robot address in Flashduty, and synchronize the occurrence and recovery of alerts through Feishu"
7565
+ date: "2025-05-19T10:00:00+08:00"
7566
+ url: "https://docs.flashcat.cloud/en/flashduty/Feishu-alert-integration-guide"
7567
+ ---
7568
+
7569
+ Generate a unique Feishu robot address in Flashduty, and synchronize the occurrence and recovery of alerts through Feishu.
7570
+
7571
+ <div class="hide">
7572
+
7573
+ ## Operation Steps
7574
+ ---
7575
+
7576
+ ### Create Feishu Alert Integration
7577
+
7578
+ You can obtain a Feishu alert integration address through either of these two methods:
7579
+
7580
+ #### Using Dedicated Integration
7581
+
7582
+ Choose this method when you don't need to route alert events to different channels. It's simpler and recommended.
7583
+
7584
+ <details>
7585
+ <summary>Expand</summary>
7586
+
7587
+ 1. Go to the Flashduty console, select **Channel**, and enter a specific channel's details page
7588
+ 2. Select the **Integration** tab, click **Add Integration** to enter the integration page
7589
+ 3. Choose **Feishu Alert** integration and click **Save** to generate a card
7590
+ 4. Click the generated card to view the **Feishu Alert Integration URL**, copy it for later use, and you're done
7591
+
7592
+ </details>
7593
+
7594
+ #### Using Shared Integration
7595
+
7596
+ Choose this method when you need to route alerts to different channels based on the alert event's payload information.
7597
+
7598
+ <details>
7599
+ <summary>Expand</summary>
7600
+
7601
+ 1. Go to the Flashduty console, select **Integration Center => Alert Events** to enter the integration selection page
7602
+ 2. Select **Feishu Alert** integration:
7603
+ - **Integration Name**: Define a name for the current integration
7604
+ - **Message Type**: Select Feishu alert message type, currently only Text and Markdown are supported
7605
+ - **Push Mode**: Choose when to trigger or recover alerts for Feishu notifications
7606
+ 3. Copy the **Feishu Alert Integration URL** for later use
7607
+ 4. Configure the default route and select the corresponding channel (after integration creation, you can go to \`Routes\` to configure more routing rules)
7608
+ 5. Done
7609
+
7610
+ </details>
7611
+ </div>
7612
+
7613
+ ### Customize Feishu Alert Integration
7614
+
7615
+ #### Feishu Alert Integration URL
7616
+
7617
+ The system will generate a unique Feishu alert integration URL for you. This URL is compatible with Feishu robot message protocol. When platforms only support Feishu robot channels, you can use this URL to receive corresponding messages.
7618
+
7619
+ #### Push Mode
7620
+
7621
+ By default, the system always creates new alerts for each message, but you can switch to these modes:
7622
+
7623
+ 1. **Trigger or Update Alert Based on Message Title**: In this mode, when receiving a new message, the system searches for open alerts based on the message title. If an alert is found, it will be updated; otherwise, a new alert will be triggered.
7624
+ 2. **Trigger or Close Alert Based on Rules**: In this mode, when receiving a new message, the system matches messages according to your rules and triggers new alerts or closes existing alerts based on the matching results.
7625
+
7626
+ - You need to fill in at least one **trigger** rule
7627
+ - You must set up regex extraction rules for Alert Key. The system uses this field to find historical alerts for updates or closure. **If regex extraction fails, the system will use the message title to generate an Alert Key** to ensure alerts won't be lost due to configuration errors
7628
+ - You can choose whether to discard messages when none of the rules match
7629
+
7630
+ Configuration example:
7631
+
7632
+ - Receive all messages, close the alert when the message content contains **RESOLVED**, otherwise trigger a new alert
7633
+ - Extract Alert Key from message title using the rule **/(.*)/**.
7634
+
7635
+
7636
+ ### Notes
7637
+ - Feishu alert integration URL only supports Text and post message types; other message types cannot be received
7638
+ - When Feishu message type is Text, Flashduty will generate a default alert title "Feishu Alert"
7639
+
7640
+ ## Severity Mapping
7641
+ ---
7642
+
7643
+ Currently, all alerts pushed to Flashduty through Feishu Alert integration are set to Warning severity.
7644
+
7645
+ `,Link:`---
7646
+ title: "Link Integration"
7647
+ description: "Through Link integration, you can quickly access external links by obtaining key parameters from incident attributes, labels, and other information"
7648
+ date: "2025-05-19T10:00:00+08:00"
7649
+ url: "https://docs.flashcat.cloud/en/flashduty/link-integration-guide"
7650
+ ---
7651
+
7652
+ Through Link integration, you can quickly access external links by obtaining key parameters from incident attributes, labels, and other information
7653
+
7654
+ ## Configuration Guide
7655
+
7656
+ 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.
7657
+
7658
+ ### Opening Methods
7659
+
7660
+ #### 1. Pop-up Window
7661
+ Opens a window in the current incident details page, maintaining the original interface state, suitable for quick viewing or returning after operations
7662
+
7663
+ #### 2. New Tab
7664
+ Opens the link in a new browser tab, suitable for scenarios where you need to retain the current operation context while accessing external content
7665
+
7666
+ ### URL Configuration
7667
+
7668
+ 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
7669
+
7670
+ #### Retrieving from Incident Labels
7671
+ 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:
7672
+
7673
+ \`\`\`
7674
+ https://cmdb.com/vm?sn=\${labels.sn}
7675
+ \`\`\`
7676
+
7677
+ 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:
7678
+
7679
+ \`\`\`
7680
+ https://cmdb.com/vm?sn=VM123456
7681
+ \`\`\`
7682
+
7683
+
7684
+ #### Retrieving from Custom Fields
7685
+ 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:
7686
+
7687
+ \`\`\`
7688
+ https://cmdb.com/vm?sn=\${fields.sn}
7689
+ \`\`\`
7690
+
7691
+ 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:
7692
+
7693
+ \`\`\`
7694
+ https://cmdb.com/vm?sn=VM123456
7695
+ \`\`\`
7696
+
7697
+ ### Notes
7698
+
7699
+ 1. When referenced content does not exist, Link integration will still generate the corresponding link but will not be able to retrieve the value
7700
+ 2. Each channel can bind up to three Link integrations
7701
+ 3. Pay attention to reference syntax; improper variable reference formatting will result in failure to retrieve corresponding values
7562
7702
  `};n.FlashDocsEn=u})(window);
package/dist/iife/zh.js CHANGED
@@ -7853,6 +7853,146 @@ url: "https://docs.flashcat.cloud/zh/flashduty/dingtalk-alert-integration-guide"
7853
7853
  ## 严重程度映射关系
7854
7854
  ---
7855
7855
 
7856
- 当前邮件集成推送到 Flashduty 的告警等级均为Warning。
7856
+ 当前钉钉告警集成推送到 Flashduty 的严重程度均为Warning。
7857
+
7858
+ `,FeishuAlert:`---
7859
+ title: "飞书告警集成"
7860
+ description: "在 Flashduty 生成唯一的飞书机器人地址,通过飞书的方式将告警的发生与恢复同步到 Flashduty"
7861
+ date: "2025-05-19T10:00:00+08:00"
7862
+ url: "https://docs.flashcat.cloud/zh/flashduty/feishu-alert-integration-guide"
7863
+ ---
7864
+
7865
+ 在 Flashduty 生成唯一的飞书告警地址,通过飞书告警地址将告警的发生与恢复同步到 Flashduty。
7866
+
7867
+ <div class="hide">
7868
+
7869
+ ## 操作步骤
7870
+ ---
7871
+
7872
+ ### 创建飞书告警集成
7873
+
7874
+ 您可通过以下2种方式,获取一个飞书告警集成地址,任选其一即可。
7875
+
7876
+ #### 使用专属集成
7877
+
7878
+ 当您不需要将告警事件路由到不同的协作空间,优先选择此方式,更简单。
7879
+
7880
+ <details>
7881
+ <summary>展开</summary>
7882
+
7883
+ 1. 进入 Flashduty 控制台,选择 **协作空间**,进入某个空间的详情页面
7884
+ 2. 选择 **集成数据** tab,点击 **添加一个集成**,进入添加集成页面
7885
+ 3. 选择 **飞书告警** 集成,点击 **保存**,生成卡片。
7886
+ 4. 点击生成的卡片,可以查看到 **飞书告警集成地址**,复制备用,完成。
7887
+
7888
+ </details>
7889
+
7890
+ #### 使用共享集成
7891
+
7892
+ 当您需要根据告警事件的 Payload 信息,将告警路由到不同的协作空间,优先选择此方式。
7893
+
7894
+ <details>
7895
+ <summary>展开</summary>
7896
+
7897
+ 1. 进入 Flashduty 控制台,选择 **集成中心=>告警事件**,进入集成选择页面。
7898
+ 2. 选择 **飞书告警** 集成:
7899
+ - **集成名称**:为当前集成定义一个名称。
7900
+ - **消息类型**:选择飞书告警消息类型,目前仅支持 Text、Markdown。
7901
+ - **推送模式**:选择飞书告警在何种情况下触发或恢复告警。
7902
+ 3. 复制当前页面的 **飞书告警集成地址** 备用。
7903
+ 4. 配置默认路由,并选择对应的协作空间(集成创建后可以前往 \`路由\` 进行更多路由规则的配置)。
7904
+ 5. 完成。
7905
+
7906
+ </details>
7907
+ </div>
7908
+
7909
+ ### 定制飞书告警集成
7910
+
7911
+ #### 飞书告警集成地址
7912
+
7913
+ 系统会帮您生成一个唯一的飞书告警集成地址,该地址兼容飞书机器人消息的协议,在有的平台仅支持飞书机器人通道时,您可以使用该地址来接收对应的消息。
7914
+
7915
+ #### 推送模式
7916
+
7917
+ 默认系统总是为每一条消息创建新的告警,但您可以切换模式为:
7918
+
7919
+ 1. **根据消息标题触发或更新告警**:该模式下,每当接收到新消息,系统会根据消息标题查找未关闭告警。如果找到告警则进行更新,否则系统会触发一条新的告警。
7920
+ 2. **根据规则触发或关闭告警**:该模式下,每当接收到新消息,系统会根据您的规则进行消息匹配,匹配到的消息按照规则去触发新告警或关闭已有告警。
7921
+
7922
+ - 您至少需要填写一条**触发**规则;
7923
+ - 您必须设置 Alert Key 的正则提取规则。系统使用该字段来查找历史告警,以便对其进行更新或关闭;**如果正则提取失败,系统将使用消息标题来生成 Alert Key**,以确保告警不会因为配置错误而丢失;
7924
+ - 您可以选择,当所有的规则都不匹配时,是否丢弃消息。
7925
+
7926
+ 配置示例:
7927
+
7928
+ - 接收所有消息,当消息内容中包含 **RESOVED** 字样时,关闭告警,否则触发新告警;
7929
+ - Alert Key 从消息标题中提取,规则为 **/(.\\*)/**。
7930
+
7931
+
7932
+ ### 注意事项
7933
+ - 飞书告警集成地址仅支持接收文本、富文本中 text 和 markdown 的消息类型,其他消息无法接收。
7934
+ - 当飞书消息类型是Text 时,Flashduty 会生成默认告警标题 “飞书告警”。
7935
+
7936
+ ## 严重程度映射关系
7937
+ ---
7938
+
7939
+ 当前飞书告警集成推送到 Flashduty 的严重程度均为 Warning。
7940
+
7941
+ `,Link:`---
7942
+ title: "Link 集成"
7943
+ description: "通过 Link 集成,可直接从故障属性、标签等信息中获取访问外部链接所需的关键参数,实现快速访问"
7944
+ date: "2025-05-19T10:00:00+08:00"
7945
+ url: "https://docs.flashcat.cloud/zh/flashduty/link-integration-guide"
7946
+ ---
7947
+
7948
+ 通过 Link 集成,可直接从故障属性、标签等信息中获取访问外部链接所需的关键参数,实现快速访问
7949
+
7950
+ ## 配置说明
7951
+
7952
+ Link 集成功能支持从故障属性、标签等信息中提取关键参数,实现与外部系统的快速跳转。通过自动化填充和跳转,避免了手动输入,提高了问题定位与处理的效率。该功能适用于故障排查、性能监控和系统调试等场景,有助于优化运维流程,提升响应速度与准确性
7953
+
7954
+ ### 打开方式
7955
+
7956
+ #### 1. 弹窗
7957
+ 在故障详情的当前页面中弹出窗口,保持原有界面状态,适合快速查看或操作后返回
7958
+
7959
+ #### 2. 新标签页
7960
+ 在浏览器新标签中打开链接,适用于需要保留当前操作上下文并同时访问外部内容的场景
7961
+
7962
+ ### URL 配置
7963
+
7964
+ URL的参数引用内容为标签时以 labels. 开头;引用内容为自定义字段时,以 fields. 开头;引用内容为故障属性时,直接引用即可,如 .title、.severity 等
7965
+
7966
+ #### 故障标签中获取
7967
+ 支持通过 \${} 的方式从参数中动态取值,用于构造请求地址。例如参数值从故障标签(labels)中自动填充,无需手动输入:
7968
+
7969
+ \`\`\`
7970
+ https://cmdb.com/vm?sn=\${labels.sn}
7971
+ \`\`\`
7972
+
7973
+ 在上述示例中,\${labels.sn} 表示将故障中的 sn 标签值动态注入至 URL 中。如果故障数据中包含 sn=VM123456,则最终请求地址为:
7974
+
7975
+ \`\`\`
7976
+ https://cmdb.com/vm?sn=VM123456
7977
+ \`\`\`
7978
+
7979
+
7980
+ #### 自定义字段中获取
7981
+ 支持通过 \${} 的方式从参数中动态取值,用于构造请求地址。例如参数值从自定义字段(fields)中自动填充,无需手动输入:
7982
+
7983
+ \`\`\`
7984
+ https://cmdb.com/vm?sn=\${fields.sn}
7985
+ \`\`\`
7986
+
7987
+ 在上述示例中,\${fields.sn} 表示将故障中的 sn 自定义字段值动态注入至 URL 中。如果自定义字段数据中包含 sn=VM123456,则最终请求地址为:
7988
+
7989
+ \`\`\`
7990
+ https://cmdb.com/vm?sn=VM123456
7991
+ \`\`\`
7992
+
7993
+ ### 注意事项
7857
7994
 
7995
+ 1. 当引用的内容不存在时,Link 集成会正常生成对应的链接,但无法获取到值
7996
+ 2. 同一个协作空间至多绑定三个 Link 集成
7997
+ 3. 注意引用语法,如未按照要求进行书写引用变量,会导致无法正常获取对应值
7858
7998
  `};n.FlashDocsZh=t})(window);
package/dist/zh.d.ts CHANGED
@@ -1,3 +1,4 @@
1
+ /** ⬆️⬆️⬆️⬆️ Other ⬆️⬆️⬆️⬆️ */
1
2
  declare const docs: {
2
3
  CustomAlert: string;
3
4
  Email: string;
@@ -58,5 +59,7 @@ declare const docs: {
58
59
  Keep: string;
59
60
  ElastAlert2: string;
60
61
  DingtalkAlert: string;
62
+ FeishuAlert: string;
63
+ Link: string;
61
64
  };
62
65
  export default docs;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "flashduty-knowledge-base",
3
- "version": "1.2.6",
3
+ "version": "1.2.8",
4
4
  "description": "flashduty knowledge base",
5
5
  "type": "module",
6
6
  "engines": {