All Products
Search

This Product

    ApsaraVideo Live:SDK quality monitoring

    Document Center

    ApsaraVideo Live:SDK quality monitoring

    Last Updated:Sep 04, 2024

    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.

    Usage notes

    1. You must use ApsaraVideo MediaBox SDK. Make sure that the license is valid and the log reporting feature is enabled.

    2. Native RTS SDK V5.4.9.2 and later are supported.

    3. ApsaraVideo Player SDK for Web V2.16.0 and later are supported.

    4. 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

    1. Log on to the ApsaraVideo Live console.

    2. In the left-side navigation pane, choose Data Center > Monitoring > SDK Quality Monitoring. The SDK Quality Monitoring page appears.

    3. On the Playback Statistics tab, select an application from the drop-down list and click Query to view the overview data of the application.

      Note

      The 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. You can specify a custom time range that is less than a day for each query.

      • 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.

    4. View the following Quality of service (QoS) metrics on the Playback Statistics tab. QoS metrics reflect the playback quality of your application.

      Note

      The 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. Playback failures are indicated by error code 4001.

      CPU Usage (%)

      The CPU usage during playback.

    Single-point Tracing

    If an error occurs when you use ApsaraVideo Player SDK 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.

    1. Log on to the ApsaraVideo Live console.

    2. In the left-side navigation pane, choose Data Center > Monitoring > SDK Quality Monitoring. The SDK Quality Monitoring page appears.

    3. Click the Single-point Tracing tab. On this tab, you can query playback sessions.

      image

      • In the search box, you can enter a TraceID or UUID that is used to identify a user when you create the player.

      • You can filter playback sessions based on conditions such as the time range (in the last 3 days), playback type, and status (playback completed, playing, or playback failed).

    4. Click View Details in the Actions column of a playback session to view the details of the playback session.