> ## 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.

# 阿里云 SLS集成

> 通过 webhook 的方式同步阿里云日志服务 SLS 监控告警事件到 Flashduty On-call，实现告警事件自动化降噪处理

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

  ***

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

  ### 使用专属集成

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

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

  ### 使用共享集成

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

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

## 在阿里云 SLS

***

**步骤 1：配置 Webhook**

<div className="md-block">
  1. 登录您的阿里云控制台，选择日志服务 SLS 产品，选择一个 Project
  2. 进入 `告警`->`告警管理`->`Webhook集成` 页面，单击 `新建` 按钮，开始编辑

  <img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/integration/aliyun-sls/aliyun-sls-alert-management.jpg" />

  3. 如图，`类型`选择“通用 Webhook”，`请求方法`选择 POST，`请求地址`填写集成的推送地址（保存后得到）

  <img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/integration/aliyun-sls/aliyun-sls-create-webhook.jpg" />

  4. 点击`确认`按钮，提交保存
</div>

**步骤 2：配置内容模板**

<div className="md-block">
  1. 切换到`内容模板`页面，点击`添加`按钮，开始编辑
  2. 进入`Webhook-自定义`配置项，`发送方式`选择“逐条发送”，`发送内容`复制以下内容：

  ```
  {{ alert | to_json}}
  ```

  <img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/integration/aliyun-sls/aliyun-sls-create-template.jpg" />

  3. 点击`确认`按钮，提交保存
</div>

**步骤 3：配置行动策略**

<div className="md-block">
  1. 切换到`行动策略`页面，点击`添加`按钮，开始编辑
  2. 进入`第一行动列表`配置项，点击添加一个`行动组`节点。
  3. `渠道`选择“通用 Webhook”，`选择Webhook`和`内容模板`使用前边创建的对象，`发送时段`选择“任意”

  <img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/integration/aliyun-sls/aliyun-sls-create-action-policy.jpg" />

  4. 点击`结束`，完成第一行动列表创建
  5. 点击`确认`按钮，提交保存
</div>

**步骤 4：配置监控规则**

<div className="md-block">
  1. 切换到`规则/事务`页面，点击`新建告警`按钮或选择一个已有的告警进行更新编辑
  2. 进入`告警规则`编辑页面，`告警策略`。
  3. `告警策略`选择“普通模式”，`行动策略`使用前边创建的对象

  <img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/integration/aliyun-sls/aliyun-sls-update-alert-rule.jpg" />

  4. 点击`确定`按钮，提交保存
  5. 针对所有其他规则，重复上述步骤，可以将全部告警推送到 Flashduty
</div>

## 状态对照

***

<div className="md-block">
  阿里云SLS监控到 Flashduty 告警等级映射关系：

  | 阿里云 SLS 监控 | Flashduty | 状态 |
  | ---------- | --------- | -- |
  | 10         | Critical  | 严重 |
  | 8          | Critical  | 严重 |
  | 6          | Warning   | 警告 |
  | 4          | Warning   | 警告 |
  | 2          | Info      | 提醒 |
</div>
