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

# SolarWinds 告警事件

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

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

  ***

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

  ### 使用专属集成

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

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

  ### 使用共享集成

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

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

## 在 SolarWinds

***

<div className="md-block">
  ## 一、SolarWinds 告警推送配置

  ### 步骤1：配置 FlashDudy 告警通道

  **前提说明**

  1. SolarWinds 的告警类型有五种（Anomaly、Entity、Event、Log、Metric Group），每种类型对应不同的告警通道，所以需要创建五个告警通道，以便在不同告警类型中使用。
  2. 在创建 Webhook 通道过程中，其中 Name 字段建议使用： 类型\_Flashduty 组合的形式，例如：Anomaly\_Flashduty。
  3. 在选择 **Select Custom Body Template Based On The Alert Types** 时，系统会默认生成相应的 **HTTP POST Body**， **生成的模版内容请不要修改**。

  **开始创建**

  1. 登录您的 SolarWinds 控制台。
  2. 在左侧导航栏找到 `Settings` ，选择 `Notification Services` 并点击 `Webhook` 进入到新建告警通道页面。

  <img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/sw-1.png" />

  3. 点击 `CREATE CONFIGURATION` 进行创建相应的告警通道。
  4. 在 `Method` 处选择 **POST** ，`Name` 处可以根据前提说明中的建议进行命名，例如：Anomaly\_Flashduty。
  5. `Destination URL` 填写集成的推送地址（当前页面填写集成名称，保存后即可生成地址）。
  6. `Content Type` 选择 **application/json**。
  7. `Select Custom Body Template Based On The Alert Types` 选择需要创建的类型，例如：Anomaly Based Alert。
  8. `HTTP POST Body` 不需要修改，使用系统默认生成的即可。
  9. 配置完成后，点击 `CREATE` 保存即可。

  <img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/sw-2.png" />

  10. 如需创建其他类型的 Webhook 通道，重复以上步骤即可。

  ### 步骤2：在告警策略中使用步骤1创建的告警通道

  1. 在左侧导航栏找到 `Alerts`，选择 `Alert Settings`。
  2. 创建或编辑已有的策略（告警规则按需配置即可，此处省略告警规则的配置）。
  3. 在配置策略页面的 `Actions` 部分中，`Services` 选择 **Webhook** 。
  4. `Configuration` 选择步骤1创建的 Anomaly\_Flashduty 通道。
  5. `Send an additional notification when the Alert is cleared` 保持开启状态。

  <img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/sw-4.png" />

  6. 其他配置完成后，点击 `Save` 保存即可。
</div>

## 二、状态对照

<div className="md-block">
  | SolarWinds | Flashduty | 状态 |
  | ---------- | --------- | -- |
  | Critical   | Critical  | 严重 |
  | Warning    | Warning   | 警告 |
  | Info       | Info      | 提醒 |
</div>
