All Products
Search
Document Center

ApsaraVideo Live:Data statistics

Last Updated:Aug 22, 2024

This topic describes how to query data that is generated during stream ingest and streaming in ApsaraVideo Live.

Log on to the ApsaraVideo Live console. In the left-side navigation pane, click Data Center and then click Billing or Monitoring to query the corresponding data.

  • On the Statistics-Usage page, you can query the usage data, such as the streaming bandwidth and traffic, ingested streams, transcoding duration, and snapshots. For more information, see Usage statistics.

  • On the Operational Analysis page, you can query data, such as the bandwidth and traffic, back-to-origin bandwidth and traffic, unique visitors (UVs), and user distribution. For more information, see Resource monitoring.

  • On the Real-time Monitoring page, you can query the monitoring data, such as the stream ingest bandwidth and traffic. For more information, see Real-time monitoring.

You can also query data by calling the following API operations:

Query the data generated during stream ingest

Monitoring stream ingest in real time can help you diagnose live streaming issues such as stuttering and high latency. The monitoring data is returned every second in real time, including the frame rates of received audio and video from a streamer to points of presence (POPs), audio and video timestamps, sequence headers, audio and video bitrates (in Kbit/s), maximum audio and video frame intervals (in milliseconds), error codes for interrupted stream ingest, and real-time logs. You can monitor a live stream in real time by checking the status of the stream every second to determine the stability of stream ingest. This reduces issues that are caused by video stuttering.

Note

You can perform the following steps to check the stream ingest quality in the ApsaraVideo Live console. You can also call the DescribeLiveDomainFrameRateAndBitRateData operation to query the bitrates and frame rates of ingested streams in real time.

Procedure

  1. Log on to the ApsaraVideo Live console.

  2. In the left-side navigation pane, choose Data Center > Monitoring > Real-time Monitoring.

  3. Specify the domain name, time period, application name, and stream name. Then, click Search.

    • To query the real-time monitoring data, select Last 10 Minutes. The monitoring data can be queried 3 minutes after events occur.

    • To query the earlier monitoring data, select Last 30 Minutes or Last 1 Hour. You can also select Custom to specify a custom time period. The monitoring data of up to the last 24 hours can be queried.

The following tables describe the metric details.

Stream details

Metric

Description

Scenario

Ingest URL

The ingest URL of the streamer. Format: rtmp://domainName/appName/streamName.

View the ingest URL.

AppName

The name of the application to which the stream belongs.

View the application name.

StreamName

The name of the stream that is ingested by the streamer.

View the stream name.

Start At

The start time when the streamer ingests the stream.

View the start time of stream ingest.

Finish At

The end time when the streamer ingests the stream.

View the end time of stream ingest.

Streamer IP Address

The IP address of the streamer that ingests the stream.

Monitor the IP address of the streamer.

Encoding

The metadata of the stream that is ingested by the streamer. Format: {Video codec ID}{Resolution}/{Audio codec ID}{Audio sampling rate}. The server collects the video codec ID, resolution, audio codec ID, and audio sampling rate from the videocodecid, frame_rate, audiocodecid, and aac headers in the metadata.

Monitor the encoding information of the stream.

Activity Log

The records of stream ingest and interrupted stream ingest that are generated by the stream.

Monitor the point in time when stream ingest or interrupted stream ingest occurs.

Frame rates of received audio and video from a streamer to POPs

Metric

Description

Scenario

Video Frame Rate

The number of received video frames, the statistics of which are collected by the server per second.

Monitor the stability of the upstream video frame rate from the streamer to the server.

Audio Frame Rate

The number of received audio frames, the statistics of which are collected by the server per second.

Monitor the stability of the upstream audio frame rate from the streamer to the server.

Audio and video timestamps

Metric

Description

Scenario

Video Timestamp

The timestamp of the last video frame, the statistics of which are collected by the server per second, in milliseconds.

Note

If no video frames are received in a second, the value is -1.

Monitor the monotonicity of video timestamps.

Audio Timestamp

The timestamp of the last audio frame, the statistics of which are collected by the server per second, in milliseconds.

Note

If no audio frames are received in a second, the value is -1.

Monitor the monotonicity of audio timestamps.

Difference Between Audio and Video Timestamps

The difference between the audio and video timestamps, in milliseconds.

Determine whether the audio and video timestamps are synchronized during live streaming by monitoring the difference trend of audio and video timestamps.

Sequence headers

Metric

Description

Scenario

AVC

The cumulative number of AVC sequence headers ingested by the streamer, the statistics of which are collected by the server.

Monitor the number of AVC sequence headers that are ingested by the streamer.

AAC

The cumulative number of AAC sequence headers ingested by the streamer, the statistics of which are collected by the server.

Monitor the number of AAC sequence headers that are ingested by the streamer.

Audio and video bitrates

Metric

Description

Scenario

Video Bitrate

The video bitrate, the statistics of which are collected by the server per second, in Kbit/s.

Monitor the video bitrate of the stream that is ingested by the streamer.

Audio Bitrate

The audio bitrate, the statistics of which are collected by the server per second, in Kbit/s.

Monitor the audio bitrate of the stream that is ingested by the streamer.

Maximum audio and video frame intervals

Metric

Description

Scenario

Video Frame Interval

The maximum interval for capturing video frames, the statistics of which are collected by the server per second.

Monitor whether the timestamp of video frames jumps.

Audio Frame Interval

The maximum interval for capturing audio frames, the statistics of which are collected by the server per second.

Monitor whether the timestamp of audio frames jumps.

Error codes for interrupted stream ingest

Metric

Description

Scenario

Error Code

The error code of interrupted stream ingest, the statistics of which are collected by the server per second.

Monitor the reason why stream ingest is interrupted. The following common error codes may be returned:

  • 2: The stream ingest client closes the connection.

  • 1, 3, 4, or 6: The connection request that is sent from the client times out.

  • 101: The ingested stream is disabled.

  • 103: No data is sent from the stream ingest client for more than 10 seconds.

  • 104 or 106: The chunk stream ID exceeds 32.

  • 105: The size of an ingested stream frame exceeds 5,242,880 bytes.

  • 122 or 123: The stream ingest authentication fails.

  • 125: An ingested stream with the same name already exists in the live center.

  • Other error codes: If other error codes are returned, submit a ticket with snapshots. For more information about how to submit a ticket, see Contact us.

Real-time logs

Real-time log delivery allows you to collect logs within seconds after they are generated. This way, you can know the details of live stream ingest and access in real time.

Procedure

  1. Log on to the ApsaraVideo Live console.

  2. In the left-side navigation pane, choose Data Center > Monitoring > Log Management.

  3. Specify the domain name and date. Then, click Search to query the logs of the domain name on the specified date.

  4. For more information about the log fields of ingested streams, see Log management.

Analyze the data generated during streaming

You can analyze the data that is generated during streaming based on the bandwidth and traffic, HTTP status codes, number of unique visitors, and user distribution.

Tab

Description

Query method

(Real-time) Streaming Bandwidth/Traffic

Displays the real-time traffic and bandwidth of a streaming domain within a specific time period for each provider in a region.

Note

You can perform the following steps to query the data in the ApsaraVideo Live console. You can also call the DescribeLiveDomainRealTimeTrafficData operation to query the data.

  1. Log on to the ApsaraVideo Live console.

  2. In the left-side navigation pane, choose Data Center > Monitoring > Real-time Monitoring.

  3. On the Playback Statistics tab of the Real-time Monitoring page, click the Streaming Bandwidth/Traffic tab.

  4. Specify the streaming domain, provider, region, and time period. Then, click Search.

Streaming Bandwidth/Traffic

Displays the traffic and bandwidth usage of a specific domain name.

Note

You can perform the following steps to query the data in the ApsaraVideo Live console. You can also call the DescribeLiveDomainRealTimeBpsData operation to query the data.

  1. Log on to the ApsaraVideo Live console.

  2. In the left-side navigation pane, choose Data Center > Billing > Statistics-Usage.

  3. Specify the domain name, region, and time period to query the traffic and bandwidth usage of the domain name. To specify a time period, select Today, Yesterday, Last 7 Days, Last 30 Days, or Custom.

HTTP Status Codes

Displays the returned HTTP status codes.

Note

You can perform the following steps to query the data in the ApsaraVideo Live console. You can also call the DescribeLiveDomainRealTimeHttpCodeData operation to query the data.

  1. Log on to the ApsaraVideo Live console.

  2. In the left-side navigation pane, choose Data Center > Monitoring > Operational Analysis.

  3. Click the HTTP Status Codes tab.

  4. Specify the domain name and time period, and click Search.

User Distribution

Displays the distribution of regions in which the video users reside.

Note

You can perform the following steps to query the data in the ApsaraVideo Live console. You can also call the DescribeLiveDomainPvUvData operation to query the data.

  1. Log on to the ApsaraVideo Live console.

  2. In the left-side navigation pane, choose Data Center > Monitoring > Operational Analysis.

  3. Click the Unique Visitors (UV), User Distribution, or Domain Ranking tab to view the corresponding data.

  4. Specify the domain name and time period, and click Search.

Domain Ranking

Displays the visit rankings of accelerated domain names.

Unique Visitors (UV)

Displays the number of independent requests from IP addresses under a domain name within a specific time period.