If you use ApsaraVideo Player SDK to play videos in your application, you can monitor the playback quality of your application based on playback statistics. The playback quality monitoring feature is implemented based on the event tracking data collected from ApsaraVideo Player SDK. You can use this feature to view playback quality metrics such as failure rate, instant startup rate, and stuttering rate. This topic describes how to view playback data.
How it works
The playback data is collected based on the event tracking points embedded in the ApsaraVideo Player SDK. The following diagram illustrates the event tracking points in the playback workflow.
Usage notes
You must use ApsaraVideo MediaBox SDK. Make sure that the license is valid and the log reporting feature is enabled.
Native RTS SDK V5.4.9.2 and later are supported.
ApsaraVideo Player SDK for Web V2.16.0 and later are supported.
For more information about how to download ApsaraVideo Player SDK, see SDK overview and download. For more information about how to apply for SDK licenses, see Manage a license.
View playback data
- Log on to the ApsaraVideo Live console.
In the left-side navigation pane, choose .
On the Playback Statistics tab, select an application from the drop-down list and click Query to view the data.
NoteThe application name must be the name of an application for which you apply for an ApsaraVideo Player SDK license. If you enter an invalid application name, no data is returned.
You can filter data based on the following conditions:
You can filter data based on the client type, system type, resolution, and network type.
You can query data in the last 3 days. The custom time range for each query must be less than 24 hours.
You can filter data based on the SDK version, encoding format, video format, decoding method (software decoding or hardware decoding), Internet service provider (ISP), domain name, and province. You can click New Filter Condition to create a custom condition and save it for subsequent use.
View the following Quality of service (QoS) metrics on the Playback Statistics tab. QoS metrics reflect the playback quality of your application.
NoteThe Average Frame Rate metric is available only to video scenarios. Other metrics are available to audio and video or audio-only scenarios.
Metric
Description
Average First Frame Duration (Millisecond)
The duration from the time when you initiate a playback request to the time when the first frame is played.
Stuttering Rate (%)
The percentage of the total duration during which stuttering occurs to the total playback duration.
Average Frame Rate (fps)
The frame rate at which videos are rendered during playback.
Outgoing Bitrate (Kbps)
The outbound network transmission rate during playback.
Instant Startup Rate (%)
The percentage of live streams that start playback within 1 second. It is equal to the number of live streams that start playback within 1 second divided by the number of all live streams that are played.
Slow Startup Rate (%)
The percentage of live streams that start playback after 3 seconds. It is equal to the number of live streams that start playback after 3 seconds divided by the number of all live streams that are played.
Playback Success Rate (%)
The percentage of playback successes. Calculation formula: Playback successes/All playbacks.
CPU Usage (%)
The CPU usage during playback.
Single-point Tracing
If an error occurs with ApsaraVideo Player SDK, you can use the single-point tracing feature to query playback details at the session and user levels, and trace playback exceptions in all links. This helps improve troubleshooting efficiency and viewer experience.
- Log on to the ApsaraVideo Live console.
In the left-side navigation pane, choose .
Click the Single-point Tracing tab. Enter the TraceID or UUID passed through when the player was created.
Click View Details in the Actions column of a playback session to view its data.