> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flashcat.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# 蓝鲸智云集成

> 通过 webhook 的方式同步蓝鲸智云监控事件到 Flashduty On-call，实现告警事件自动化降噪处理

<div className="hide">
  ## 在 Flashduty On-call

  ***

  您可通过以下2种方式，获取一个集成推送地址，任选其一即可。

  ### 使用专属集成

  当您不需要将告警事件路由到不同的协作空间，优先选择此方式，更简单。

  <AccordionGroup>
    <Accordion title="展开">
      1. 进入 Flashduty 控制台，选择 **协作空间**，进入某个空间的详情页面
      2. 选择 **集成数据** tab，点击 **添加一个集成**，进入添加集成页面
      3. 选择 **蓝鲸智云** 集成，点击 **保存**，生成卡片。
      4. 点击生成的卡片，可以查看到 **推送地址**，复制备用，完成。
    </Accordion>
  </AccordionGroup>

  ### 使用共享集成

  当您需要根据告警事件的 Payload 信息，将告警路由到不同的协作空间，优先选择此方式。

  <AccordionGroup>
    <Accordion title="展开">
      1. 进入 Flashduty 控制台，选择 **集成中心=>告警事件**，进入集成选择页面。
      2. 选择 **蓝鲸智云** 集成：
         * **集成名称**：为当前集成定义一个名称。
      3. 配置默认路由，并选择对应的协作空间（集成创建后可以前往 `路由` 进行更多路由规则的配置）。
      4. 点击 **保存** 后，复制当前页面的新生成的 **推送地址** 备用。
      5. 完成。
    </Accordion>
  </AccordionGroup>
</div>

## 在蓝鲸智云

***

以下内容已经在`蓝鲸V6/7版本`完成验证，V5 及以下版本官方已不再支持，建议您升级。

蓝鲸告警策略可以触发`处理套餐`，处理套餐可与周边系统打通，来完成复杂功能。我们首先创建一个处理套餐，配置 Flashduty 的回调地址，然后编辑告警策略，关联动作到该处理套餐，实现告警变更自动推送到 Flashduty。具体步骤如下：

#### 步骤 1、创建处理套餐

<div className="md-block">
  1. 登录您的蓝鲸智云桌面，进入`监控平台`；
  2. 进入`配置-处理套餐`页面，单击`添加套餐`按钮，开始创建处理套餐；
  3. 填写名称为`Send To Flashduty`，套餐类型选择`HTTP回调`，推送方式选择`POST`，并填写集成的推送地址（保存集成后获得），如下图所示：

  <img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/integration/tencent-bk/create_package.jpg" />

  4. 切换到`主体`，选择`JSON`类型，消息体复制并填入以下信息（实际产生告警时，蓝鲸会渲染变量内容作为 Payload 推送到目标回调地址）：

  ```
  {{alarm.callback_message}}
  ```

  5. 保存套餐，完成创建。
</div>

#### 步骤 2、编辑告警策略

<div className="md-block">
  1. 进入`配置-告警策略`页面，选择一个已有的策略进行编辑，或新建一个告警策略；
  2. 下拉到`告警处理`部分，三种场景均选择`Send To Flashduty`处理套餐，并关闭`防御规则`，如下图：

  <img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/integration/tencent-bk/update_alert_rule.jpg" />

  3. 提交保存，完成；
  4. 对于其他想要推送到 Flashduty 的告警，重复以上步骤。
</div>

## 状态对照

***

<div className="md-block">
  蓝鲸智云到 Flashduty 告警等级映射关系：

  | 蓝鲸智云 | Flashduty | 状态 |
  | ---- | --------- | -- |
  | 致命   | Critical  | 严重 |
  | 预警   | Warning   | 警告 |
  | 提醒   | Info      | 提醒 |
</div>
