# 告警通知 (/zh-CN/realtime-media/usage-analytics/build/monitor-call-quality/alarm)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## 告警通知简介 [#告警通知简介]
水晶球的告警通知服务对声网 RTC 项目的异常指标和事件提供告警。你可以通过邮件、接口回调等多种方式接收告警通知,及时采取应对措施。
### 功能概述 [#功能概述]
告警通知服务提供以下功能:
- 基于预定义指标配置告警。
- 支持通过多种渠道发送告警通知给多个联系人。
- 存储最近 7 天的告警历史。
- 与水晶球的通话调查、数据洞察服务共享数据,方便深入调查问题。
### 如何开通 [#如何开通]
请[联系销售](https://www.shengwang.cn/contact-sales/)开通告警通知服务和咨询计费。
## 告警规则 [#告警规则]
告警规则包含关联产品、规则配置、通知方式三个组成部分。
本节介绍告警规则的常用操作,并提供告警回调的参数说明。
### 创建告警规则 [#创建告警规则]
参考如下步骤创建告警规则:
1. 登录[控制台](https://console.shengwang.cn/),在左侧菜单栏中点击**水晶球** > **告警通知**,然后在页面上方点击**告警规则**。
2. 在页面左上方的下拉菜单中选择需要创建告警规则的项目。
3. 点击页面右上角的**创建规则**,在**创建告警规则**弹窗中配置以下信息:
| 配置项 | 说明 | 限制 |
| --- | --- | --- |
| 关联项目 | 当前告警规则适用的 RTC 项目。 | 一条规则只能有一个关联项目。 |
| 规则名称 | 自定义名称。 | 同一关联项目下的规则名称必须唯一。 |
| 告警类型 | [alarm-markdown-0-3-1 details](#table-slot-alarm-markdown-0-3-1) | / |
| 告警粒度 | [alarm-markdown-0-4-1 details](#table-slot-alarm-markdown-0-4-1) | 对于事件告警,告警粒度只能设为用户。 |
| 规则描述 | [alarm-markdown-0-5-1 details](#table-slot-alarm-markdown-0-5-1) | 最多添加 20 条规则。 |
| 沉默周期 | 已针对某条规则发送告警通知后,如果在沉默周期内再次触发同一告警规则,将不会发送告警通知。同一告警规则指的是告警粒度和规则描述的配置都相同。 | / |
| 生效时间 | 只有生效时间内发生的异常情况才会触发告警规则。 | / |
| 规则范围 | [alarm-markdown-0-8-1 details](#table-slot-alarm-markdown-0-8-1) | / |
| 高级过滤条件 | 在规则描述的基础上,增加过滤条件可以提高告警的准确度。点击**设置高级过滤条件**,可以修改或关闭默认设置。 | / |
| 告警级别 | 包括 Critical、Warning、Info 三个级别。 | / |
| 告警方式 | [alarm-markdown-0-11-1 details](#table-slot-alarm-markdown-0-11-1) | 每个声网控制台账户一天最多发送累计 500 封的告警通知邮件。例如:某条告警规则在一天内触发了 20 次,有两个告警联系人,则累计发送了 40 封邮件。 |
| 邮件备注 | 告警通知邮件中的备注信息。 | 告警方式设为邮箱时,该配置项才会出现。 |
| 企业微信机器人 | 企业微信机器人的 webhook 地址。 | 告警方式设为企业微信机器人时,该配置项才会出现。 |
| 告警联系人 | 接收告警通知的对象。 | 一条规则最多可以选 5 个告警联系人。 |
| 告警语言 | 告警通知内容的语言。 | / |
| 告警时区 | 告警通知内容中显示的时区。 | / |
| 告警回调 | 接收告警通知的可访问的公网 URL。你可以参考[告警回调参数](/zh-CN/realtime-media/usage-analytics/build/monitor-call-quality/alarm),基于接收到的告警通知做进一步的处理。 | 详见[告警回调参数](/zh-CN/realtime-media/usage-analytics/build/monitor-call-quality/alarm)。 |
**alarm-markdown-0-3-1 details**
支持以下两种:
- 指标告警:在指标数值高于或低于阈值时告警。
- 事件告警:在特定事件出现时告警。
**alarm-markdown-0-4-1 details**
支持以下两种:
- 频道:在频道发生异常情况时告警。
- 用户:在用户遇到异常情况时告警。
**alarm-markdown-0-5-1 details**
由逻辑关系、指标或事件、计算周期、持续周期、比较关系、阈值或布尔值组成。
例如:指标为音频卡顿率、计算周期为 20 s 周期、持续周期为持续 2 个周期、比较关系为 >=、阈值为 10%,代表的含义为:每 20 秒统计一次音频卡顿率数据,如果音频卡顿率连续两次大于等于 10%,则触发告警。
如果需要监控多个指标或多个事件,可以添加多条规则。多条规则之间的关系可以设置为“与”和“或”。
**alarm-markdown-0-8-1 details**
支持以下三种:
- 全部用户或全部频道。
- 自定义名单:频道或用户名单,每条数据之间需要换行。
- 自定义正则表达式:例如,将规则应用到所有以 “aa” 开头的频道,正则表达式可设为 “aa.*”。
**alarm-markdown-0-11-1 details**
支持以下两种:
- 邮箱:所选告警联系人的对应邮箱。
- 企业微信机器人:企业微信机器人回调。
### 启用告警规则 [#启用告警规则]
新创建的告警规则默认不会启用。参考如下步骤启用告警规则:
1. 登录[控制台](https://console.shengwang.cn/),在左侧菜单栏中点击**水晶球** > **告警通知**,然后在页面上方点击**告警规则**。
2. 选择需要启用的告警规则,点击**操作**下面的**启用**,在弹窗中点击**确定**。
启用告警规则支持批量操作。
### 修改告警规则 [#修改告警规则]
参考如下步骤修改告警规则:
1. 登录[控制台](https://console.shengwang.cn/),在左侧菜单栏中点击**水晶球** > **告警通知**,然后在页面上方点击**告警规则**。
2. 选择需要修改的告警规则,点击**操作**下面的**编辑**。
如果这条规则是由他人创建的,你会看到一个弹窗。阅读弹窗信息,然后点击**确定**。
3. 在弹窗中修改配置信息,修改完后点击**确定**。
### 删除告警规则 [#删除告警规则]
参考如下步骤删除告警规则:
1. 登录[控制台](https://console.shengwang.cn/),在左侧菜单栏中点击**水晶球** > **告警通知**,然后在页面上方点击**告警规则**。
2. 找到需要删除的告警规则,点击**操作**下面的**删除**。
3. 阅读弹窗信息,点击**确定**。
删除告警规则支持批量操作。
### 告警回调参数 [#告警回调参数]
在告警规则被触发时,告警回调会将通知消息发送到你提供的 URL 地址。告警回调目前具有以下限制:
- 没有认证机制,暂不支持 HTTP 认证。
- 告警推送失败最多重试 2 次,每次推送请求的超时等待时间为 2 秒。
- 告警规则每次被触发时,均会推送告警通知到回调服务接口。
- 水晶球告警回调 API 的出方向 IP 可能发生变化,声网建议:
- 在安全组上配置 80 端口全放通策略。
- 如果无法配置 80 端口全放通,声网可以向您提供告警服务出方向 IP,但会存在 IP 切换的可能性,需要你配合做生产切换。
告警回调通过 HTTP 的 POST 请求发送 JSON 格式的数据,参数说明和示例如下。
**指标告警**
告警粒度为频道:
```json
{
"alertTime":"1631703720000", //发送告警通知的时间戳,单位为秒
"timeZone":"UTC+8", //你在规则中设置的时区
"projectName":"test", //RTC 项目名称
"cname":"d1********02", //频道名称
"enContent":"video freeze rate≥85%", //告警信息(cnContent代表中文,enContent 代表英文)
"currentUserNum":"2", //频道当前在线用户数
"currentHostNum":"1", //频道当前在线主播数
"callId":"61********e5", //通话 ID
"url":"https://console.shengwang.cn/analytics/call/qoe?id=61********e5", //对应通话调查页面的链接
"remark":"email note" //你在规则中设置的邮件备注
}
```
告警粒度为用户:
```json
{
"alertTime":"1631780400000", //发送告警通知的时间戳,单位为秒
"timeZone":"UTC+8", //你在规则中设置的时区
"projectName":"test", // RTC 项目名称
"cname":"97********e1", //频道名称
"uid":"95****96", //用户 ID
"enContent":"video freeze rate≥10%", //告警信息(cnContent代表中文,enContent 代表英文)
"currentUserNum":"2", //频道当前在线用户数
"currentHostNum":"2", //频道当前在线主播数
"callId":"61********0e", //通话 ID
"url":"https://console.shengwang.cn/analytics/call/qoe?id=61********0e", //对应通话调查页面的链接
"remark":"email note" //你在规则中设置的邮件备注
}
```
**事件告警**
```json
{
"alertTime":"1631785450000", // 发送告警通知的时间戳,单位为秒
"timeZone":"UTC+8", //你在规则中设置的时区
"projectName":"test", // RTC 项目名称
"cname":"t****e", //频道名称
"uid":"67****91", //用户 ID
"enContent":"no frame sending,no voice sending,no voice receiving", //告警信息(cnContent代表中文,enContent 代表英文)
"currentUserNum":"100", //频道当前在线用户数
"currentHostNum":"1", //频道当前在线主播数
"callId":"61********f5", //通话 ID
"url":"https://console.shengwang.cn/analytics/call/qoe?id=61********f5", //对应通话调查页面的链接
"remark":"" //你在规则中设置的邮件备注
}
```
## 告警联系人 [#告警联系人]
所有告警规则的联系人都会列在**告警联系人**中。某条告警规则触发后,只有与其绑定的告警联系人会收到通知。
本节介绍如何创建、修改和删除告警联系人。
### 创建联系人 [#创建联系人]
参考如下步骤创建告警联系人:
1. 登录[控制台](https://console.shengwang.cn/),在左侧菜单栏中点击**水晶球** > **告警通知**,然后在页面上方点击**告警联系人**。
2. 点击页面右上角的**创建联系人**。
3. 在弹窗中输入名字和邮箱。输入有效的邮箱地址后,点击**获取验证码**。
4. 输入验证码,点击**确定**,完成联系人的创建。
创建告警联系人时有以下限制:
- 一个邮箱只能用于创建一个联系人。
- 一个邮箱每天最多可以获取 5 次验证码。
### 编辑联系人 [#编辑联系人]
参考如下步骤编辑告警联系人:
1. 登录[控制台](https://console.shengwang.cn/),在左侧菜单栏中点击**水晶球** > **告警通知**,然后在页面上方点击**告警联系人**。
2. 找到需要修改的告警联系人,点击**操作**下面的**编辑**。
3. 在弹窗中修改信息,修改完后点击**确定**。
### 删除联系人 [#删除联系人]
参考如下步骤删除告警联系人:
1. 登录[控制台](https://console.shengwang.cn/),在左侧菜单栏中点击**水晶球** > **告警通知**,然后在页面上方点击**告警联系人**。
2. 找到需要删除的告警联系人,点击**操作**下面的**删除**。
3. 阅读弹窗信息,点击**确定**。
删除联系人支持批量操作。
## 告警历史 [#告警历史]
告警历史提供过去 7 天内所有告警规则的通知消息。
本节介绍如何查看和管理告警历史。
### 查看告警历史 [#查看告警历史]
参考如下步骤查看告警历史:
1. 登录[控制台](https://console.shengwang.cn/),在左侧菜单栏中点击**水晶球** > **告警通知**,然后在页面上方点击**告警历史**。
2. (可选)添加以下筛选条件:
- 按关联项目筛选:在页面左上方的下拉菜单中选择项目。
- 按时间范围筛选:在页面上方选择开始日期和结束日期。
- 按告警粒度、告警级别、状态筛选:在列表首行点击对应的漏斗图标。
### 管理告警历史 [#管理告警历史]
参考如下步骤管理告警历史:
1. 登录[控制台](https://console.shengwang.cn/),在左侧菜单栏中点击**水晶球** > **告警通知**,然后在页面上方点击**告警历史**。
2. 找到要处理的告警历史,点击**状态**下面的选择框,修改状态:
- 如果对应的异常情况已经处理完毕,在下拉列表中选择**已处理**。
- 如果没有出现对应的异常情况,在下拉列表中选择**忽略**。
4. (可选)如果某条告警历史需要进一步分析,可以点击**操作**下面的**前往调查**,跳转到对应的[通话调查](/zh-CN/realtime-media/usage-analytics/build/investigate-call-problems/overview)页面。
5. (可选)如果某条告警历史对应的告警规则需要修改,点击**操作**下面的**调整规则**,可以直接在弹窗中修改规则配置。
告警历史的状态修改和删除支持批量操作。