监控告警平台支持对StreamLake播放器 SDK指标进行监控,自定义设置告警规则进行告警,方便您及时发现和了解数据异常情况。
首次使用您可通过如下流程进行配置:(前提条件您需接入播放器 SDK并有数据上报)
添加告警联系人—>添加告警规则—>查看告警历史
登陆点播控制台后,左侧导航找到【质量平台】-【监控告警】点击进入告警规则列表页。
首次登录,规则列表为空,您可单击「添加告警规则」按钮,进入告警规则设置页面。
设置规则后,在告警规则列表页您可查看、添加、编辑、启用、禁用、复制和删除告警规则,并支持搜索和按照应用设置筛选查找。
单击「添加告警规则」按钮,进入告警规则设置页面。告警规则设置包含基础信息设置、告警规则设置、生效条件设置、告警方式设置四个部分。
详细配置的参数说明如下:
参数 | 说明 |
告警名称 | 自定义告警的名称,最大不能超过 64 个字符。 |
告警级别 | 支持单级别和双级别设置 |
指标名称 | 下拉列表,选择具体需要监控的指标及监控条件,指标名称支持的选择:播放量、实际播放量、播放失败率等多种播放指标。 支持同时配置5个指标,设置且/或情况条件(且/或条件不可同时出现)。 |
监测频率 | 每隔多长时间检测一次 |
连续周期 | 按照检测频率,连续N个周期满足条件,触发告警 |
生效期间 | 监控生效的时间段,比如每周一到周五的 20:00-24:00 |
生效维度 | 支持多种维度的生效范围限制:
|
告警方式 | 告警方式支持短信/邮件/接口通知等几种类型。
|
沉默告警周期 | 告警发生后,如未恢复正常,则间隔一个沉默告警周期后,再次发送告警。沉默告警周期默认值为 30 分钟,支持选择 1 小时和 6 小时。 |
双级别设置注意事项:
当需要配置不同的告警等级时,当前支持双级别告警配置:P0-紧急,P1-告警。
P0比P1更紧急,其指标条件需严格对齐,改动P0指标条件后,P1会随之保持同步,阈值需最少保障有1个不同,才可生效成功。
点击「告警历史」Tab,进入告警历史页面,进行历史信息的筛选、查询、查看详情等操作。
时间:支持历史365天的信息搜索,跨度最大为31天。
查找:支持按照应用名称筛选,按策略名称搜索。
操作:查看具体告警详情,支持删除对应记录,删除后不可恢复。
点击「告警联系人」Tab,进入告警联系人页面,可查看告警联系人列表,以及新增和维护人员信息。
参数 | 说明 |
姓名 | 必填项,根据辨别需求起名,必须是字母开头支持英文和数字。 |
手机 | 必填项,必须是正确的手机号码。 |
邮箱 | 必填项,必须是正确的邮箱地址。 |
关于webhook告警通知接口配置参考如下:
告警回调信息体:
字段 | 类型 | 示例 | 描述 |
eventId | String | 事件id | |
historyId | String | 历史id | |
alarmId | String | 告警规则id | |
ruleName | String | 告警规则名称 | |
alertLevel | String | 告警等级 | |
alarmTime | String | 告警时间 | |
effectiveDimension | Object | 生效维度 | |
silenceTime | Integer | 静默时间 | |
silenceTimeUnit | String | 静默时间单位 m - 分钟 h - 小时 | |
evalMatchInfos | Array of Object | 告警匹配信息体 |
effectiveDimension
字段 | 类型 | 示例 | 描述 |
terminal | List<String> | [] | 事件id |
productName | String | "ks691021069819064807" | 历史id |
product | String | "VOD_SDK" | 告警规则id |
platform | List<String> | [] | 告警规则名称 |
customLabels | List<String> | [] | 自定义标签 |
sdkVersion | Object | sdk版本 |
evalMatchInfos
字段 | 类型 | 示例 | 描述 |
match | boolean | true | 是否报警匹配 |
index | Integer | 2 | 告警指标索引 |
value | Long | 1234 | 告警值 |
metric | String | PlayerFirstScreen | 告警指标 |
sdkVersion
字段 | 类型 | 示例 | 描述 |
comparisonOperator | String | 逻辑运算符 | |
value | String | 1.2.3.4 | 版本值 |
{
"eventId":"0bfbc99e-a317-11ee-80b6-1e0359b85620",
"historyId":"cb389bcbfc3d2aa5f42e4322d54f5eb8",
"alarmId":"d4819c8278ff75a61153987f5ed32293",
"ruleName":"lxn--2告警链路",
"alertLevel":"P0",
"alarmTime":1703502987000,
"effectiveDimension":{
"terminal":[
"mobile"
],
"productName":"ks691021069819064807",
"product":"VOD_SDK",
"platform":[
"ANDROID_PHONE",
"IPHONE",
"IPAD"
],
"customLabels":null,
"sdkVersion":{
"comparisonOperator":"<=",
"value":"1.7.10.2"
}
},
"silenceTime":5,
"silenceTimeUnit":"m",
"evalMatchInfos":[
{
"match":"true",
"index":0,
"value":532,
"metric":"AverageCodeRate"
},
{
"match":"true",
"index":1,
"value":32,
"metric":"BlockDurationHundredSeconds"
},
{
"match":"true",
"index":2,
"value":26,
"metric":"BlockRate"
},
{
"match":"true",
"index":3,
"value":-5,
"metric":"BlockTimesHundredSeconds"
},
{
"match":"true",
"index":4,
"value":-1,
"metric":"FaultAfterPlayRate"
},
{
"match":"true",
"index":5,
"value":75,
"metric":"FrameLossHundredSeconds"
},
{
"match":"true",
"index":6,
"value":0,
"metric":"FrameLossRate"
},
{
"match":"true",
"index":7,
"value":48248,
"metric":"PlayCount"
},
{
"match":"true",
"index":8,
"value":225,
"metric":"PlayerFirstScreen"
},
{
"match":"true",
"index":9,
"value":0,
"metric":"VSF"
}
]
}
matric 指标枚映射参考如下:
序号 | 指标名称 | 指标 | 单位 |
1 | 播放量 | PlayCount | 次 |
2 | 播放器首屏 | PlayerFirstScreen | ms |
3 | 开播失败率 | VSF | % |
4 | 丢帧率 | FrameLossRate | % |
5 | 百秒丢帧次数 | FrameLossHundredSeconds | 次 |
6 | 视频平均码率 | AverageCodeRate | kbps |
7 | 卡顿率 | BlockRate | % |
8 | 百秒卡顿次数 | BlockTimesHundredSeconds | 次 |
9 | 百秒卡顿时长 | BlockDurationHundredSeconds | ms |
10 | 开播后故障率 | FaultAfterPlayRate | % |
11 | 排重设备数 | DeviceNum | 个 |
12 | 设备均播放次数 | AvgPlayNumByDevice | 次 |
13 | 播放总时长 | TotalPlayDuration | min |
14 | 次均播放时长 | AvgPlayDuration | s |
15 | 设备均播放时长 | AvgPlayDurationDevice | s |
16 | 完播率 | CompleteRate | % |
17 | 播放完成率 | PlayCompleteRate | % |