Function Introduction
With Dimensional Analysis, you can analyze various metrics from different dimensions, including user experience, service quality, and business scale. For each metrics, you can also view the corresponding detailed data, from the specific user, stream, and room levels, to assist in analyzing and solving push/pull stream problems.
Overview
Dimensional Analysis includes 3 sub-pages, each of which carries different functions:
| Sub-page | Function |
|---|---|
| Dashboard Page | You can select metrics from different categories within a certain period of time, such as user experience, service quality, and business scale, and display them in time trend charts to help you find problems. For the selected metrics, you can also analyze and view them through comparison and filtering to further analyze the reasons for the problems. |
| Multi-dimensional Analysis Page | Display the distribution of metrics in different dimensions, including data distribution, country/region, network type, platform system, SDK version, pull source, and operator, to help you conduct metrics drilling to trace the cause and lock in the root of the problem。 |
| Data Detail Page | Used to further view the specific user, stream, or room information of the metrics in the selected time and dimension, to quickly obtain analysis examples and assist in problem solving. |
Access Steps
- Log in to the ZEGOCLOUD Console, and enter Analytics Dashboard from the left navigation bar.
- Subscribe to the package plan, and activate the "Dimensional Analysis" function.
- Click "Dimensional Analysis" in the navigation bar, and you can access the "Dashboard Page".
Dashboard Page
Sample Page
Function Introduction
Select the metrics to analyze
Select AppID and time range, click "Add analysis metrics", and you can select the metrics you need to analyze, up to 5 at most. After determining the metrics, you can view the overall situation (mean/total value) of the selected metrics, and the trend of each metric over time.
Some metrics also support adding auxiliary metrics. When only one such metrics is selected, you can check whether to "Add frequantly used auxiliary metrics".
The metric cards of each metric and the support for auxiliary metrics are shown in the following table:
| Category | Analysis Metric | Metric Card Calculation Method | Auxiliary Metric |
|---|---|---|---|
| User Experience | Audio Stutter Rate | Mean | Total Audio Pull Stream Duration |
| Video Stutter Rate | Mean | Total Video Pull Stream Duration | |
| Audio First Frame Delay | Mean | Effective First Frame Count | |
| Video First Frame Delay | Mean | Effective First Frame Count | |
| Enter Room Delay | Mean | Login Request Count | |
| End-to-End Delay | Mean | Total Pull Stream Duration | |
| Upstream Delay | Mean | Total Pull Stream Duration | |
| Downstream Delay | Mean | Total Pull Stream Duration | |
| End-to-End Packet Loss | Mean | Total Pull Stream Duration | |
| Upstream Packet Loss | Mean | Total Pull Stream Duration | |
| Downstream Packet Loss | Mean | Total Pull Stream Duration | |
| Business scale | Audio Effective First Frame Count | Total | / |
| Video Effective First Frame Count | Total | / | |
| Login Request Count | Total | / | |
| Push Stream Request Count | Total | / | |
| Pull Stream Request Count | Total | / | |
| Service-side Mix Stream Request Count | Total | / | |
| Client-side Mix Stream Request Count | Total | / | |
| Room Concurrent Count | Peak | / | |
| Push Stream Concurrent Count | Peak | / | |
| Pull Stream Concurrent Count | Peak | / | |
| Mix Stream Task Concurrent Count | Peak | / | |
| Total Audio Pull Stream Duration | Total | / | |
| Total Video Pull Stream Duration | Total | / | |
| Total Pull Stream Duration | Total | / |
Configure the display style of the metrics
All metrics display metrics trend charts, among which, the user experience metrics can be switched to interval distribution charts to display.
At the same time, each chart can also zoom in/out the selected range of the chart, or click the "Download" icon to download the data details.
Select the metrics to filter dimensions
Click "Filtering Dimensions", you can add countries/regions, network types, platform systems, SDK versions, push targets, pull sources, and operators as well as the corresponding filter options. After adding, only the metrics data of the selected dimension items is displayed.
When the selected analysis metrics does not support a certain dimension, a prompt will be displayed next to the dimension name.
The analysis dimensions supported by each metrics are shown in the following table:
| Category | Analysis metrics | Supported Items |
|---|---|---|
| User Experience | Audio Stutter Rate | Pull Source, Platform System, Country/Region, SDK Version, Network Type, Internet Service Provider |
| Video Stutter Rate | Pull Source, Platform System, Country/Region, SDK Version, Network Type, Internet Service Provider | |
| Audio First Frame Delay | Pull Source, Platform System, Country/Region, SDK Version, Network Type, Internet Service Provider | |
| Video First Frame Delay | Pull Source, Platform System, Country/Region, SDK Version, Network Type, Internet Service Provider | |
| Enter Room Delay | Platform System, Country/Region, SDK Version, Network Type, Internet Service Provider | |
| End-to-End Delay | Pull Source, Platform System, Country/Region, SDK Version, Network Type, Internet Service Provider | |
| Upstream Delay | Push Target, Platform System, Country/Region, SDK Version, Network Type, Internet Service Provider | |
| Downstream Delay | Pull Source, Platform System, Country/Region, SDK Version, Network Type, Internet Service Provider | |
| End-to-End Packet Loss | Pull Source, Platform System, Country/Region, SDK Version, Network Type, Internet Service Provider | |
| Upstream Packet Loss | Push Target, Platform System, Country/Region, SDK Version, Network Type, Internet Service Provider | |
| Downstream Packet Loss | Pull Source, Platform System, Country/Region, SDK Version, Network Type, Internet Service Provider | |
| Service Quality | Login Success Rate | Platform System, Country/Region, Network Type, SDK Version, Internet Service Provider |
| Login Success Rate within 5s | Platform System, Country/Region, Network Type, SDK Version, Internet Service Provider | |
| Push Stream Success Rate | Platform System, Country/Region, Network Type, Push Target, Internet Service Provider | |
| Pull Stream Success Rate | Platform System, Country/Region, Network Type, Pull Source, Internet Service Provider | |
| Service-side Mix Stream Request Success Rate | / | |
| Client-side Mix Stream Request Success Rate | Platform System, Country/Region, Network Type, SDK Version, Internet Service Provider | |
| Business scale | Audio Effective First Frame Count | Pull Source, Platform System, Country/Region, SDK Version, Network Type, Internet Service Provider |
| Video Effective First Frame Count | Pull Source, Platform System, Country/Region, SDK Version, Network Type, Internet Service Provider | |
| Login Request Count | Platform System, Country/Region, SDK Version, Network Type, Internet Service Provider | |
| Push Stream Request Count | Platform System, Country/Region, SDK Version, Push Target, Network Type, Internet Service Provider | |
| Pull Stream Request Count | Platform System, Country/Region, SDK Version, Pull Source, Network Type, Internet Service Provider | |
| Service-side Mix Stream Request Count | / | |
| Client-side Mix Stream Request Count | Platform System, Country/Region, Network Type, SDK Version, Internet Service Provider | |
| Room Concurrent Count | / | |
| Push Stream Concurrent Count | Push Target | |
| Pull Stream Concurrent Count | Pull Source | |
| Mix Stream Task Concurrent | / | |
| Total Audio Pull Stream Duration | Pull Source, Platform System, Country/Region, SDK Version, Network Type, Internet Service Provider | |
| Total Video Pull Stream Duration | Pull Source, Platform System, Country/Region, SDK Version, Network Type, Internet Service Provider | |
| Total Pull Stream Duration | Pull Source, Platform System, Country/Region, SDK Version, Network Type, Internet Service Provider |
Compare different time/dimension metrics
Click "Comparison Mode", you can add comparison lines on the trend chart, including Time Period Comparison, Compared with Total Value, Compared with All Filters three types of comparison.
The time period comparison can compare yesterday/last week/last month. For example, when the time period comparison-comparison yesterday is selected, at the same time point, both the current day and the previous day's metrics values will be displayed.
The comparison related to the filter dimension (comparison total, comparison each filter option) needs to select the dimension first before comparison. For example, when the filter dimension selects Android and iOS as the platform systems, and compares each filter option, at the same time point, the metrics values of different platform systems will be displayed at the same time.
Multi-dimensional Analysis Page
Sample Page
Click the data point on the chart, you can see the multi-dimensional analysis entry, click to open the multi-dimensional analysis page, and display the distribution of the metrics at different dimensions at the clicked time point.
Function Introduction
Multi-dimensional Overview
The chart shows the sample size (sampling duration or sampling point count) and metrics value of the metrics under different dimensions in the selected time period in the form of a pie chart or bubble chart. By providing an overview of the metrics in different dimensions, it helps quickly determine the influence of different factors on the metrics, providing a direction for troubleshooting and problem solving. Click the right upper corner to switch forward/backward in time.
Data Distribution
The metrics values are divided into different distribution intervals, and the sample size of each interval is displayed to help users understand the data concentration of the metrics and judge the severity of the problem. Only user experience metrics have this dimension.
Below shows the data details of different distribution intervals, supports sorting and downloading. Some metrics support viewing data details, and can click "View details" to jump to view the detailed information of the users/rooms/streams in the specified interval.
The metrics belonging to the user experience and service quality categories support viewing data details, and can click "View details" to jump to view the detailed information of the users/rooms/streams in the specified interval.
Country/Region
Displays the sample size distribution of this metric under different countries, to evaluate whether different countries affect the final quality. When a metric supports the country/region dimension, you will see this entry.
- The left chart uses the color depth to represent the sample size, the darker the color, the larger the sample size. Selecting different regions can view the metrics values of the region.
- The right chart shows the top 10 country distribution of the metrics sample size, used to understand the main countries/regions affected by the appid and the current status of the metrics.
- Below shows the data details of different countries/regions. Some metrics support viewing data details, and can click "View details" to jump to view the detailed information of the users/rooms/streams in the specified region.
Network Type
Displays the metrics values and sample sizes for different network types such as WIFI, 2G, 3G, 4G, and 5G, which helps determine user experience under different network conditions and assess their impact. When a metric supports the network type dimension, you will see this entry. Below shows the data details of different network types, supports sorting and downloading. The metrics belonging to the user experience and service quality categories support viewing data details, and can click "View details" to jump to view the detailed information of the users/rooms/streams in the specified network.
Platform System
Displays the sample size distribution of this metric under different platform systems such as Web and iOS, to evaluate whether different platform systems affect the final quality. When a metric supports the platform system dimension, you will see this entry.
Below shows the data details of different platform systems, supports sorting and downloading. The metrics belonging to the user experience and service quality categories support viewing data details, and can click "View details" to jump to view the detailed information of the users/rooms/streams in the specified platform system.
SDK Version
Displays the sample size distribution of this metric under different SDK versions, to evaluate whether different SDK versions affect the final quality. When a metric supports the SDK version dimension, you will see this entry.
Below shows the data details of different SDK versions, supports sorting and downloading. The metrics belonging to the user experience and service quality categories support viewing data details, and can click "View details" to jump to view the detailed information of the users/rooms/streams in the specified SDK version.
Internet Service Provider
Displays the sample size distribution of this metric under different Internet Service Provider, to evaluate whether different Internet Service Provider affect the final quality. When a metric supports the operator dimension, you will see this entry.
Below shows the data details of different Internet Service Provider, supports sorting and downloading. The metrics belonging to the user experience and service quality categories support viewing data details, and can click "View details" to jump to view the detailed information of the users/rooms/streams in the specified operator.
Pull Source
Displays the sample size distribution of this metric under different pull sources such as RTC and L3, to evaluate whether different pull sources affect the final pull quality. When a metric supports the pull source dimension, you will see this entry.
Below shows the data details of different pull sources, supports sorting and downloading. The metrics belonging to the user experience and service quality categories support viewing data details, and can click "View details" to jump to view the detailed information of the users/rooms/streams in the specified pull source.
Push Target
Displays the metrics values and sample sizes for pushing streams to targets such as RTC and CDN. Only metrics related to stream pushing have this dimension, which is used to evaluate the stream quality of different push methods. When a metric supports the push target dimension, you will see this entry.
Below shows the data details of different push targets, supports sorting and downloading. The metrics belonging to the user experience and service quality categories support viewing data details, and can click "View details" to jump to view the detailed information of the users/rooms/streams in the specified push target.
Data Detail Page
Sample Page
The data detail page has two entrances, one is to click the data point on the chart, you can see the data detail entry, click to open the data detail page; the other is to enter through the "details" button on the multi-dimensional analysis page.
Only metrics belonging to the user experience and service quality categories support viewing data details.
Function Introduction
Data Detail List Display
The data detail page displays the metrics values of each user/room/stream in detail, up to 500 samples at most, supports sorting and downloading, to help locate the samples that are closest in time, or the worst quality, or the longest duration, to find the most suitable samples for problem analysis.
Further View the Complete Information of the User/Room/Stream
Click "View details", you can further jump to the call insight/user monitoring/room overview etc. page, to obtain the more complete information of the user/room/stream.
Error Code Proportion Description
When viewing the data details related to the success rate, the page will first show the proportion distribution of various error codes, to help users understand the overall success rate situation. For the error codes that need to be analyzed, you can further click "Unfold" to view the user/room/stream details.
