If an error occurs when you use Alibaba Cloud Player SDK to play videos, you can use the single-point tracing feature to trace the abnormal playback behavior of a specific user or playback session from end to end. This helps you quickly diagnose the root cause and manage the playback experience more efficiently.
Prerequisites
Before you use the single-point tracing feature, ensure that the following conditions are met:
-
The single-point tracing feature is available only for the following Alibaba Cloud Player SDK versions: 5.4.9.2 or later for Android and iOS, and 2.16.0 or later for Web. Download the SDK.
ApsaraVideo Player SDK for Android, iOS, and Web requires a valid license. For more information, see Obtain a license.
-
Make sure that log reporting is enabled for Alibaba Cloud Player SDK. By default, this feature is enabled.
-
You must pass the traceId parameter when you create the player. Without this parameter, the single-point tracing feature is unavailable. For more information about how to pass the parameter, see Basic features of Alibaba Cloud Player SDK for Android, Basic features of Alibaba Cloud Player SDK for iOS, and Web player API reference.
The single-point tracing feature is not supported for native system players, third-party players, or the Alibaba Cloud Player SDK on platforms other than Android, iOS, and Web.
Limitations
-
You can query only the 10,000 most recent sessions.
-
You can query playback data for the last three days only.
Procedure
-
Log on to the Alibaba Cloud VOD console.
-
In the left-side navigation pane, choose Data Center > Single-point Tracing.
-
Query playback sessions.
-
In the Enter a traceId field, enter the traceId provided during player creation to query playback sessions for a specific user or device.
-
Filter playback sessions by time (within the last 3 days), playback type (on-demand or live stream), and status (Playback Completed, Playing, or Playback Failed).
-
-
Click View Details to view the detailed information of a playback session.
The playback details page contains three sections. The Basic information section displays fields such as App name, Playback time, client IP, OS, Network type, Device type, SessionId, and SDK version. The Playback information section displays metrics such as time to first frame, Rebuffering count, Rebuffering duration, status, Codec standard, hardware decoding, Playback progress on exit, resolution, frame rate, and video bitrate. The event list at the bottom records playback events in chronological order, with columns such as Topic, Event, Duration (ms), Time, and Details.
Related documents
For information about common issues and solutions when using Alibaba Cloud Player SDK, see Player SDK FAQ.