质量平台支持对接入点播 SDK 的项目进行指标监控，并根据设定的告警规则进行告警，方便您及时获取业务指标的变化情况。

配置流程

首次使用视频点播的监控告警功能，可按照如下流程进行配置。

前提条件

• 已完成创建应用。
• 已集成播放器 SDK 并配置日志上报。日志上报请参考 Android 集成准备和 iOS 集成准备中的添加 SDK 依赖 - RangersAppLog SDK 依赖。

告警规则

在告警规则页面，您可以查看、添加、编辑、启用、禁用、复制和删除告警规则。

进入添加告警规则页面

1. 单击左侧导航栏质量平台 > 告警管理。
2. 选择告警规则页签。
3. 单击添加告警规则按钮。根据页面提示配置告警规则。包含 5 个模块的参数信息配置：告警设定、监控规则、告警规则、告警指标预览和告警方式。

配置告警设定

详细的参数说明如下表所示。

配置监控规则

详细的参数说明如下表所示。

配置告警规则

支持 2 种告警选择：智能告警、自定义告警。

• 选择告警类型为智能告警，支持的操作如下所示：

  • 设置总量阈值：在告警设定中，选择不同的指标类型，对应设置的告警规则不同。
    • 设置播放总量阈值：指标类型选择视频点播，播放总量低于阈值的曲线不检测，不填或为 0 算法将自适应阈值。默认值为 0。
    • 设置上传总量阈值：指标类型选择视频上传，上传总量低于阈值的曲线不检测，不填或为 0 算法将自适应阈值。默认值为 0。
  • 设置生效范围：默认全选。匹配的开始时间到结束时间，默认为 00:00-23:09。支持的取值范围为[00:00,23:59]
  • 选择异常波动：向上波动只关注指标突增异常，向下波动只关注指标突降异常，上下波动突增突降都关注。支持的选项有：
    • 指标向上突增波动
    • 指标上下突增突降波动
    • 指标向下突降波动

  

• 选择告警类型为自定义告警，您可以明确设置规则，配置多条告警规则，操作如下所示：

  • 选择阈值：设置告警阈值和连续周期，当设置的监控指标超过该阈值时，将触发告警；设置的连续周期的取值范围为[1,3]。例如，卡顿率选择告警阈值为 >2%，连续 3 个周期，则当连续 3 次检测卡顿率 >2% 时，将会收到告警。选择阈值时，会有指标的近 1 天的监控图，以供设定参考。
  • 选择波动：设置波动的同比、百分比和连续周期，当波动超过设置的比例时，将触发告警。对应的取值范围分别为
    • 同比：[1,3]
    • 百分比：[0,100]
    • 连续周期：[1,3]
  • 选择趋势告警：设置指标的趋势，可选择递增或递减，设置的连续周期的取值范围为[1,3]。当趋势符合告警规则时，将触发告警。

  

预览告警指标

配置完成告警设定和告警规则后，对应展示告警指标预览图表。支持关闭或者展开的操作。

配置告警方式

详细的参数说明如下表所示。

配置飞书群告警

添加 webhook 地址，需要在接收告警的群中添加自定义机器人，详情请参考飞书通知使用说明。

在飞书群添加 webhook 地址后，若触发告警信息，您会接收到告警消息卡片，示例样式如下：

配置告警回调

当报警规则被触发时，质量平台 > 告警管理会将报警消息发送到您指定的 URL 地址，消息会以 HTTP 的 POST 请求发送。

请求的 Content-Type 是 application/json，发送的 POST 请求内容如下表所示。

告警回调示例

{
    "RuleID": 13**2,
    "AlertID": 53**26,
    "Name": "测试",
    "Metric": "cnt",
    "Subscriber": [],
    "AggrInterval": 300,
    "Filters": [],
    "Dimension": {
        "os": "Android"
    },
    "Timestamp": 1701235200,
    "MetricValue": 3233,
    "Count": -1,
    "Prediction": 1,
    "Duration": 6300,
    "HistoryCount": 21,
    "Reason": "实际值 [3233.0000] 比预期值 [1.0000] 高 3232.0000",
    "DetailURL": "https://console.volcanicengine.com/vod/quality_control/alarm/historyDetail/?ruleId=13**2&alertId=53**26&alertTime=1701235200&AppId=100***29&Service=vplay_tob_hupuvod_test&Metric=cnt&Channel=&Region=cn&OS=&ServiceType=vplay&AppName=测试&Platform=mobile",
    "AlertMsg": "【质量平台点播测试（100***29）-视频点播质量监控】测试 在 2023-11-29 13:20:00 因实际值 [3233.0000] 比预期值 [1.0000] 高 3232.0000告警，具体信息请登录<a href=\"https://console.volcanicengine.com/vod/quality_control/alarm/historyDetail/?ruleId=13**2&alertId=53**26&alertTime=1701235200&AppId=100***29&Service=vplay_tob_hupuvod_test&Metric=cnt&Channel=&Region=cn&OS=&ServiceType=vplay&AppName=测试&Platform=mobile\">火山引擎控制台</a>查看。",
    "AppID": "100***29",
    "OS": "Android",
    "Platform": "mobile"
}

管理告警规则

完成添加告警规则的参数配置后，单击保存按钮，支持在告警规则列表中查看新增的告警、当前告警规则数、启用数和禁用数量。

详细的操作说明如下表所示。

告警历史

1. 单击左侧导航栏质量平台 > 告警管理，进入告警管理页面。
2. 切换告警历史页签，支持查看各业务的告警历史。
   • 支持按照应用名称进行筛选后，同时输入告警规则名称查询告警历史。
   • 支持快速查看近 1 天、近 15 天和近 30 天的告警历史。
   • 支持查看告警详情，查看该次告警的详细信息。
     

告警联系人

1. 单击左侧导航栏质量平台 > 告警管理，进入告警管理页面，切换告警联系人页签。

2. 根据自身业务需求，下拉选择应用名称。

3. 单击新增告警联系人按钮，在告警联系人信息的对话框中，根据提示填写告警联系人信息。
   
   详细的参数说明如下所示。

   参数	说明
   姓名	必填项，根据自身需求，填写对应的名称，姓名长度为 1~13 位。
   手机号码	必填项，请填写正确的手机号码。
   邮箱	必填项，请填写正确的邮箱格式。
   分组	选填项，单击 按钮，填写新分组名称。 说明 暂不支持创建多个分组。

4. 创建完成后，在告警联系人页签下方，显示新增的列表，支持的操作：

   • 支持按照姓名或者分组，进行模糊匹配查询。
   • 支持编辑和删除操作。