全部產品
Search
文件中心

ApsaraVideo VOD:單點追查

更新時間:Jun 11, 2025

當使用阿里雲播放器SDK播放視頻發生異常時,可藉助單點追查功能針對具體某個使用者或某次播放會話的異常播允許存取為進行全鏈路追蹤,以便您能快速診斷問題原因,可有效改善播放體驗治理效率。

前提條件

使用單點追查功能之前,您需要作如下準備:

  • 僅支援下述版本的阿里雲播放器SDK使用單點追查功能:5.4.9.2及以上版本的Android播放器SDK或iOS播放器SDK、2.16.0及以上版本的Web播放器SDK。立即下載播放器SDK

  • Android、iOS、Web播放器SDK需要擷取有效License,詳情請參見擷取License

  • 請確保阿里雲播放器SDK的埋點日誌上報功能已開啟,正常情況下,阿里雲播放器SDK的埋點日誌上報功能為預設開啟的。

  • 務必要在建立播放器時就透傳traceId,用於識別使用者身份,否則將無法使用單點追查功能。透傳方式請參見Android播放器基礎功能iOS播放器基礎功能Web播放器介面說明

重要

系統播放器、第三方(非阿里雲)播放器、阿里雲播放器非Android或iOS端或Web端均不支援單點追查功能。

使用限制

  • 當前僅支援查詢最新10000條會話,超出部分則不會在控制台顯示。

  • 僅支援查詢最近3日內的播放資料。

操作步驟

  1. 登入ApsaraVideo for VOD控制台

  2. 在點播控制台左側導覽列的資料中心地區,單擊單點追查,進入單點追查頁面。

  3. 查詢播放會話記錄。

    單點追查

    • 請輸入客戶追蹤號的輸入框中,輸入建立播放器時透傳的用於標識使用者的traceId,精確查詢某個使用者或某台裝置的播放會話記錄。

    • 通過時間(最近3日內)、播放類型(點播和直播)、狀態(播放完成、播放中、播放異常)等篩選查詢播放會話記錄。

  4. 單擊查看詳情,查看播放會話的詳細資料。

    播放詳情

相關文檔

更多關於使用阿里雲播放器SDK的常見問題及修複建議,請參見播放器SDK常見問題