All Products
Document Center

ApsaraVideo VOD:Single-point tracing

Last Updated:Dec 26, 2023

If an error occurs when you use ApsaraVideo Player to play videos, you can use the single-point tracing feature to locate the cause of the error. The single-point tracing feature allows you to query playback details at the session and user levels and improves the efficiency of playback management by tracing playback exceptions in all links.


Before you use the single-point tracing feature, make sure that the following conditions are met:

  • ApsaraVideo Player SDK for Android or iOS V5.4.9.2 or later, or ApsaraVideo Player SDK for Web V2.16.0 or later is integrated. For more information about how to download the latest version of ApsaraVideo Player SDK, see ApsaraVideo Player SDK.

  • A valid license is obtained if you use ApsaraVideo Player SDK for Android or iOS. For more information, see Obtain a license. If you use ApsaraVideo Player SDK for Web, you must submit a request on Yida to enable the playback quality monitoring feature.

  • The log reporting feature is enabled. By default, the feature is enabled for ApsaraVideo Player SDKs.

  • The traceId parameter is passed when you create the player. The traceId parameter is used for user identification. If you do not pass the traceId parameter, you cannot use the single-point tracing feature. For more information about the parameter pass-through method, see Basic features of ApsaraVideo Player SDK for Android, Basic features of ApsaraVideo Player SDK for iOS, and API operations.


The system player, third-party players, and ApsaraVideo Player that is not on an Android, iOS, or web client do not support the single-point tracing feature.


  • You can query only the most recent 10,000 sessions. Earlier sessions are not displayed.

  • You can query only the playback data generated in the last three days.


  1. Log on to the ApsaraVideo VOD console.

  2. In the left-side navigation pane, choose Data Center > Single-point Tracing.

  3. Query playback sessions.


    • In the Enter a traceId field, enter the traceId that you passed when you create the player. This way, you can query playback sessions of a specific user or device.

    • You can query playback sessions that were created within the last three days and specify conditions such as the time range, file type (on-demand audio and video files or live streams), and status (playback completed, playing, or playback failed) to filter playback sessions.

  4. Click View Details to view the details of the playback session.



For more information about frequently asked questions about ApsaraVideo Player SDK and their solutions, see FAQ about ApsaraVideo Player SDK.