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

# 提醒

> 为您的通话指标设置阈值规则——一旦出现异常，立即通过电子邮件、Slack 或您的 Webhook 发送通知。

告警规则会监控您组织的通话指标，并在超过阈值时通知您——例如过去一天的成功率低于 80%、一小时内超过 500 通电话，或测试套件出现回归。请在 **设置 → 组织 → 告警**
（`/dashboard/organization?tab=alerts`）下管理告警规则。管理告警规则需要 **admin** 或 **owner** 角色。

## 创建规则

点击 **创建规则**，然后填写：

| 字段                       | 选项                                      |
| ------------------------ | --------------------------------------- |
| **指标**                   | 成功率 · 失败率 · 平均评分 · 通话量 · 套件回归           |
| **条件**                   | 小于 · 不大于 · 大于 · 不小于                     |
| **阈值**                   | 用于比较的数值                                 |
| **窗口（小时）**               | 指标的回溯计算范围——1 至 720 小时                   |
| **电子邮件收件人**              | 以逗号分隔，最多 10 个地址                         |
| **Slack 传入 Webhook URL** | 可选——将告警消息发送到频道                          |
| **冷却时间（分钟）**             | 两次触发之间的最短静默时间（默认 60）                    |
| **发送至开发者 Webhook**       | 同时向您的 Webhook 端点发送 `alert.triggered` 事件 |
| **启用告警规则**               | 规则可以保存为禁用状态，之后再启用                       |

示例：*"过去 24 小时内成功率**小于** 80"*
会在最近 24 小时窗口内已评分通话的成功率低于 80% 时触发。

<Note>
  **失败率统计的不仅是“未成功”通话。** 告警指标会将所有未达到成功结果的通话——包括完全没有对话的通话（立即挂断、连接失败）——视为失败。控制台中的 **未成功** 磁贴仅统计被评为
  `unsuccessful` 的通话。因此，即使控制台磁贴显示的数量很低，失败率告警也可能触发；这是预期行为，并非数据不一致。
</Note>

## 触发机制

规则会根据您配置的最近窗口进行评估。满足条件时，规则会**触发一次**，随后在冷却期内保持静默，即使指标仍然超出阈值也是如此——因此，一个异常小时只会产生一次通知，而不是每次评估都产生一次通知。每次触发都会记录指标值、阈值和时间。

## 发送渠道

单条规则可以同时通过全部三个渠道通知：

* **电子邮件**——向每位列出的收件人发送消息，其中包含规则名称、
  指标、数值、阈值和窗口。
* **Slack**——通过您的 Slack 传入 Webhook URL 发布相同的消息。
* **开发者 Webhook**——向您组织的 [Webhook 端点](/zh/webhooks/overview)发送
  `alert.triggered` 事件，以便将告警接入 PagerDuty、值班工具或您自己的系统。

任何一个渠道发送失败都不会阻止其他渠道。

## 管理规则

“告警”标签页会列出每条规则的启用/禁用状态以及其上次触发时间。您可以直接切换规则的启用状态，点击 **编辑** 修改任意字段，或删除不再需要的规则。页面还会显示最近的告警活动，方便您确认规则是否按预期触发。

## 后续步骤

<CardGroup cols={2}>
  <Card title="可观测性" icon="chart-line" href="/zh/guides/observability">
    支持这些相同指标的控制台。
  </Card>

  <Card title="Webhook" icon="webhook" href="/zh/webhooks/overview">
    在您自己的系统中接收 alert.triggered（以及所有其他事件）。
  </Card>
</CardGroup>
