单点追查功能提供用户、播放会话粒度的播放行为查询服务,通过对异常播放行为全链路追踪改善播放体验治理效率。当使用阿里云播放器播放视频发生异常时,可借助单点追查功能快速定位问题。

前提条件

使用单点追查功能之前,您需要作如下准备:
  • 集成5.4.9.2及以上版本的阿里云移动端播放器SDK(Android播放器SDK或iOS播放器SDK),最新版本的播放器SDK下载请参见播放器SDK
  • 集成移动端播放器SDK后,需要开启播放器SDK的埋点上报功能,并在创建播放器时将用户或设备标识符透传至traceId参数。透传方式请参见Android播放器基础功能iOS播放器基础功能
重要 系统播放器、第三方(非阿里云)播放器、阿里云播放器非Android或iOS端均不支持单点追查功能。

使用限制

  • 仅支持5.4.9.2及以上版本的阿里云移动端播放器SDK(Android播放器SDK或iOS播放器SDK)产生的播放数据的上报和追查。
  • 当前仅支持查询最新10000条会话,超出部分则不会在控制台显示。
  • 仅支持查询最近3日内的播放数据。

操作步骤

  1. 登录视频点播控制台
  2. 在点播控制台左侧导航栏的数据中心区域,单击监控统计 > 单点追查,进入单点追查页面。
  3. 查询播放会话记录。
    单点追查
    • 请输入客户追踪号输入框中,输入TraceID(优先)或UUID,精确查询某条播放会话记录。
      TraceID和UUID可以从播放器的埋点日志中获取,其字段分别为traceIduuid。各字段的含义解释如下:
      字段 说明
      traceId 业务方可将标识符传入该字段用以标识用户身份。
      uuid 播放器SDK针对设备生产的唯一标识符,若业务方有自有用户标识符,可以透传至traceId进行追溯。
    • 通过时间(最近3日内)、播放类型(点播和直播)、状态(播放完成、播放中、播放异常)等筛选查询播放会话记录。
  4. 单击查看详情,查看播放会话的详细信息。
    播放详情