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

# 火山引擎日志服务 TLS 告警事件

> 通过 webhook 的方式同步火山引擎日志服务 TLS 告警事件到 Flashduty On-call，实现告警事件自动化降噪处理

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

  ***

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

  ### 使用专属集成

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

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

  ### 使用共享集成

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

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

## 在火山引擎

***

<div className="md-block">
  ## 一、火山引擎日志服务 TLS 告警推送配置

  ### 步骤1：创建 Flashduty 告警通道

  1. 登录您的火山引擎控制台，检索 `TLS`日志服务产品，并进入对应产品控制台。
  2. 在左侧导航栏选择 `日志告警=>通知管理`。
  3. 选择 `webhook 告警集成`，并点击 `创建 webhook 告警集成`。

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

  4. 在弹出的编辑框中填写相应的信息，名称填写 `Flashduty`。
  5. 类型选择 `自定义 Webhook`，请求方法选择 `POST`。
  6. 请求地址填写**集成的推送地址**（当前页面填写集成名称，保存后即可生成地址）。
  7. 请求头保持默认的即可，配置完成点击 `创建`。

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

  ### 步骤2：创建内容模版

  1. 回到 `通知管理` 页面。
  2. 选择 `内容模版`，并点击 `创建内容模版`。
  3. 在创建模版页面中填写相关信息，模版名称填写 `Flashduty`。
  4. 其他类型的通道内容可为空，在 `自定义Webhook` 的通知内容处，填写以下模版内容。

  ```
  {
  	"AccountID":"{{AccountID}}",
  	"ProjectName":"{{ProjectName}}",
  	"AlarmTopicName":"{{AlarmTopicName}}",
  	"Region":"{{Region}}",
  	"Alarm":"{{Alarm}}",
  	"AlarmID":"{{AlarmID}}",
  	"Duration":"{{Duration}}",
  	"Condition":"{{Condition}}",
  	"HappenThreshold":"{{HappenThreshold}}",
  	"Topics":"{{Topics|join:','}}", 
  	"NotifyTimeUnix":"{{NotifyTimeUnix}}",
  	"NotifyType":"{{NotifyType}}",
  	"Severity":"{{Severity}}",
  	"ConsecutiveAlertNums":"{{ConsecutiveAlertNums}}",
  	"TriggerParams":{{toJson(TriggerParams)|safe}}, 
  	"ExecuteQuery":{{toJson(ExecuteQuery)|safe}},
  	"DetailUrl":"{{DetailUrl}}",
  	"FireResultsCount":"{{FireResultsCount}}"
  }
  ```

  5. 点击 `确认` 即可完成内容模版的创建。

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

  ### 步骤3：创建通知组

  1. 回到 `通知管理` 页面。
  2. 选择 `通知组`，并点击 `创建通知组`。
  3. 在编辑通知组页面中填写相关信息，通知组名称填写 `Flashduty`。
  4. 通知规则和其他配置可按需配置（此处略过）。
  5. 在通知渠道配置中，接收渠道的 `自定义webhook` 保持勾选状态。
  6. `Webhook` 选择**步骤1**创建的 **FlahDuty** 通道。
  7. `内容模版` 选择**步骤2**创建的 **FlahDuty** 模版。
  8. 其他配置完成后点击 `保存` 即可。

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

  ### 步骤4：配置告警策略

  1. 在左侧导航栏选择 `日志告警=>告警策略`。
  2. 创建或编辑已有的告警策略。
  3. 告警规则可按需配置（此处略过）。
  4. 在 `通知组` 处，点击 `关联通知组`。
  5. 在弹出的选择框中，选择**步骤3**创建的 **Flashduty** 通知组，选择好后，点击 `关联`。
  6. 配置好其他内容后，点击 `创建/保存` 即可完成。

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

## 二、状态对照

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