在今年 10 月，我们上线了水晶球 3.0 版本，包含了正式版的实时监控与告警通知。我们在发布的内容中只是简单介绍了「告警通知」的功能。告警通知为客户提供了更加灵活的监控方式，能更及时地掌握项目运行情况。用户可以根据需求自定义告警规则、告警方式。不过这个告警规则如何设置？我们这篇就简要介绍一下。
首先，告警通知属于付费功能，需要邮件联系 sales@agora.io或者拨打 400 632 6626 开通。开通之后可以通过两种路径进入「告警通知」。
一种是直接通过 Console 后台，点击水晶球-告警通知访问。
还有一种路径，我们可以从「实时监控」页面看到告警历史。当然，首次使用时，告警通知肯定是空白的（如下图）。
▲图：测试项目的告警通知
点击「查看更多报警历史」，就可以进入「告警历史列表」。
在设置告警规则之前，首先我们需要先添加几个告警联系人。这样一来，在不同的告警触发时，可以通知到必要的联系人，可以是负责该业务的运营的人员、工程师、项目经理等。具体添加方式如截图，非常简单，就不做赘述了。
根据我们对现有实时互动场景的了解，我们将告警分为了两类：
1. 指标告警：针对音频卡顿率、视频卡顿率、在线用户人数、网络延迟率四个指标，支持频道与用户级别指标设置告警；
2. 事件告警：针对发送端帧率异常、Wi-Fi 信号不佳等几个影响体验的事件，来设定告警。
首先我们讲讲指标告警。这里的指标是针对你要监测告警的对象而言的。我们可以设置对频道进行监测告警，也可以设置针对用户做监测告警，即在频道发生异常情况时告警，或在用户遇到异常情况时告警。
当监测对象为频道时，指标包括：在线用户数、音频卡顿率、视频卡顿率、网络延迟率。
当监测对象为用户时，指标包括：音频卡顿率、视频卡顿率、网络延迟率。
你会看到在“规则描述”中，有多个告警规则可以设置，我们在这里简单设置一条，你就能明白他们之间的逻辑关系了。假设我们“规则描述”设置成上图中的样子，那么翻译一下就是：每 20 秒统计一次音频卡顿率数据，如果音频卡顿率连续一次大于等于 10%，就出发告警通知。
在这里，你可以设定多个规则，监控多个不同指标。多条规则之间可以是“与”、“或”关系。如下图所示。
对于刚刚设置的“规则”，你可以设置一个“沉默周期”，在这个周期内，相同的告警持续发生时，不论出发多少次告警，告警联系人只会收到一次通知（邮件）。所有规则的范围，可以是针对该项目的所有频道和用户，也可以只监测自定义名单内的用户。另外，也可以通过自定义正则表达式来设定规则适用范围，具体可参考声网文档。
设置好以上规则之后，最后就是设定告警级别、通知方式。目前「告警通知」支持通过告警回调接口、邮箱、企业微信机器人通知告警联系人。
「事件告警」的规则有所不同。它的规则都与实际用户体验相关，比如视频发送无帧率、音频发送/接受无声等，具体类型如下图所示。
在设定事件告警规则的时候，有一点需要注意。通常来讲，很多的体验问题大多数是因为发送端的网络、设备性能等原因造成的。所以，如果要设定「规则范围」为自定义名单，建议主要监测身份是主播端的用户，其次才是观众端。
事件告警的通知方式与指标告警一样，可以根据需要来设定。
最后，还有一项设置，就是高级过滤条件。它的作用就是减少不重要的告警，其中的参数都是可以自定义的（如下图所示）。
例如，你可以设定当前在线人数只有 1 人或 2 人的时候，如果出现质量问题，就不需要发出告警通知。或者，有频道持续时间不足 300 秒，那么出现问题也不需要告警，因为这些频道有可能是联调设备、用户出现反复进入等情况，那么告警的意义就不大。又或者，频道在线人数字比较这一行，通过当前和最大在线人数的比值，可以判断出这个频道所处阶段是刚开始还是快结束了，那么可以过滤不重要的时段，如刚刚开始，就出现了质量问题，可能是对方还在调整设备，那么这时候告警必要性就不太大。不过，以上这些筛选条件，还是要根据各自业务情况来灵活调整。
关于水晶球的更多指标或使用信息，可访问「声网文档中心」。如果你在使用水晶球的过程，遇到问题，可以在声网开发者社区论坛发帖提问：rtcdeveloper.com