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

# AWS EventBridge 告警事件

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

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

  ***

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

  ### 使用专属集成

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

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

  ### 使用共享集成

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

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

## 在 AWS EventBridge

***

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

  <span id="1" />

  ### 步骤1：在 API destinations 中创建 Connerction

  1. 登录您的 AWS 控制台，检索 `Amazon Eventbridge` 产品，并进入对应产品控制台。
  2. 在左侧导航栏选择 `Integration=>API destinations`。
  3. 点击 `connection`，并点击 `Create connection` 创建链接。

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

  4. 在 `Connection details` 部分中，`Connection name` 处填写 `Flashduty`。
  5. 在 `Authorization` 部分中，`Destination type` 选择 `Other`。
  6. `Authorization type` 选择 `API Key`。
  7. `API key name` 填写 `Flashduty`，`Value` 填写集成推送地址的 `integration_key`。
  8. 点击 `Create` 保存即可。

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

  ### 步骤2：创建 API destination

  1. 回到 `API destinations` 界面，并点击 `Create API destination`。

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

  2. 在 `API destination detail` 编辑界面填写相关信息，`Name` 填写 `Flashduty` 。
  3. `API destination endpoint` 填写集成的推送地址（当前页面填写集成名称，保存后即可生成地址）。
  4. `HTTP method` 选择 `POST`。
  5. `Connection type` 选择 `Use an existing connection` 并在列表中选择步骤1添加的 `Flashduty` Connection。
  6. 点击 `Create` 保存即可。

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

  ### 步骤3：在 EventBridge Rules 中使用步骤2创建的 API destination

  1. 登录您的 AWS 控制台，检索 `Amazon Eventbridge` 产品，并进入对应产品控制台。
  2. 在左侧导航栏选择 `Buses=>Rules`，创建或编辑已有的规则。
  3. 此处省略其他配置。
  4. 在 `Target types` 处，选择 `EventBridge API destination` 作为目标类型。
  5. 在 `API destination` 中选择 `Use an existing API destination`，并在下拉框中选择步骤2创建的 `Flashduty` API destination。
  6. `Next` 后按需配置，并保存即可。

  <img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/aws-eb-7.png" />
</div>

## 二、状态对照

<div className="md-block">
  1. 由于 AWS EventBridge 的事件并没有严重等级，所以推送至 Flashduty 的事件等级均为 Warning。
  2. AWS EventBridge 的事件只有触发，没有恢复，所以 Flashduty On-call 接收到的事件也不会自动关联恢复。
</div>