Video Streams Test

A/V conferencing enables real-time audio and video communications between the Microsoft Teams users. In environments where users use video streams for communication, it becomes mandatory for the administrator to check the quality of the video conferencing experience and the load on the Microsoft Teams so that administrators may proactively be alerted to abnormalities/technical glitches in the conferences. This is where the Video Streams test helps.

Using this test, you can easily figure out the total number of VBSS streams and the count of VBSS streams that were classified as poor, good and unclassified. Administrators can also figure out the reason on why the VBSS streams were classified as poor - is it due to high video frame rate? or high video local frame loss? or high video post Fec plr?

Target of the test : Microsoft Teams

Agent deploying the test : A remote agent

Outputs of the test : One set of results for the monitored Microsoft Teams

Configurable parameters for the test
Parameters Description

Test period

How often should the test be executed

Host

The host for which the test is to be configured. By default, this is portal.office.com

Tenant Name

Azure AD certificate-based authentication (CBA) enables customers to allow or require users to authenticate with X.509 certificates against their Azure Active Directory (Azure AD) for applications and browser sign-in.

This test requires a valid X.509 certificate, so that it can securely access the target tenant and its resources. For this purpose, you should do the following:

  1. Enable Azure AD Certificate-based authentication for the target O365 tenant; this can be achieved manually, via the Office 365 portal, or automatically, using Powershell scripts we provide. For the manual procedure, refer to Manually Enabling Certificate-based Authentication For an Office 365 Tenantunder Microsoft Office 365. For the automatic procedure, refer to Automatically Fulfilling Pre-requisites in a Modern Authentication-Enabled Environmentunder Microsoft Office 365.

    When enabling certificate-based authentication, an X.509 certificate will be generated for the target tenant.

  2. Configure the Tenant Name parameter with the name of the tenant for which certificate-based authentication is enabled. Using the tenant name, the test will be able to read the details of the X.509 certificate that is generated for that tenant, and use that certificate to access that tenant's resources. To determine the tenant name, do the following:

    • Log in to the Microsoft 365 Admin Center as an administrator.

    • Under Setup, click on Domains.

    • Find a domain that ends with .onmicrosoft.com - this is your Microsoft O365 tenant name.

O365 User Name, O365 Password, and Confirm Password

For execution, this test requires the privileges of an O365 user who has been assigned the Service support admin role and is vested with the View-Only Audit Logs and Team administrator permission. Configure the credentials of such a user against O365 User Name and O365 Password text boxes. Confirm the password by retyping it in the Confirm Password text box.

Domain Name, Domain User Name, Domain Password, and Confirm Password

These parameters are applicable only if the eG agent needs to communicate with the Office 365 portal via a Proxy server.

In this case, in the Domain text box, specify the name of the Windows domain to which the eG agent host belongs. In the Domain User Name text box, mention the name of a valid domain user with login rights to the eG agent host. Provide the password of that user in the Domain Password text box and confirm that password by retyping it in the Confirm Password text box.

On the other hand, if the eG agent is not behind a Proxy server, then you need not disturb the default setting of these parameters. By default, these parameters are set to none.

Proxy Host, Proxy Port, Proxy User Name, Proxy Password and Confirm Password

These parameters are applicable only if the eG agent needs to communicate with the Office 365 portal via a Proxy server.

In this case, provide the IP/host name and port number of the Proxy server that the eG agent should use in the Proxy Host and Proxy Port parameters, respectively.

If the Proxy server requires authentication, then specify the credentials of a valid Proxy user against the Proxy User Name and Proxy Password text boxes. Confirm that password by retyping it in the Confirm Password text box. If the Proxy server does not require authentication, then specify none against the Proxy User Name, Proxy Password, and Confirm Password text boxes.

On the other hand, if the eG agent is not behind a Proxy server, then you need not disturb the default setting of any of the Proxy-related parameters. By default, these parameters are set to none.

Show All Poor Streams

By default, this flag is set to No indicating that the detailed diagnosis for all the measures of this test will show only the Top N poor streams configured against the Show N Poor Streams parameter. Set this flag to Yes if you wish to view the detailed diagnosis of all poor streams identified by this test.

Show N Poor Streams

By default, this parameter is set to 10, indicating that the detailed diagnostics will report the top-10 poor streams. You can change the 'N' in Show N Poor Streams by specifying any number of your choice in this text box.

DD Frequency

Refers to the frequency with which detailed diagnosis measures are to be generated for this test. The default is 1:1. This indicates that, by default, detailed measures will be generated every time the test runs, and also every time the test detects a problem. You can modify this frequency, if you so desire. Also, if you intend to disable the detailed diagnosis capability for this test, you can do so by specifying none against DD Frequency.

Detailed Diagnosis

To make diagnosis more efficient and accurate, the eG Enterprise embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the detailed diagnosis capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option. The option to selectively enabled/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled:

  • The eG manager license should allow the detailed diagnosis capability
  • Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.
Measurements made by the test
Measurement Description Measurement Unit Interpretation

Poor streams due to high video post FECPLR

Indicates the number of video streams where the Video Post FECPLR exceeded the pre-defined thresholds.

Number

 

Poor streams due to high video local frame loss

Indicates the number of video streams that were classified as poor owing to Video Local Frame Loss.

Number

 

Poor streams due to high video frame rate

Indicates the number of video streams that were classified as poor owing to high video frame rate.

Number

The detailed diagnosis of this measure lists the start time, end time, first UPN, second UPN, first IP address, second IP address, conference ID and the number of video streams classified as poor due to high video frame rate.

Unclassified streams

Indicates the number of video streams that did not have sufficient data to be classified as good or poor.

Number

A stream is marked Unclassified when Interactive Connectivity Establishment (ICE) connectivity fails or when all the metrics required to compute the stream classification are not reported.

If ICE connectivity succeeded for an Unclassified stream, the stream is likely considered Unclassified because key stream metrics were not reported. There are a few reasons these metrics may not be reported:

  • QoE reports were not received
  • Short calls
  • Low packet utilization

Total video streams

Indicates the total number of video streams.

Number

 

Poor streams

Indicates the number of video streams that were classified as poor.

Number

The detailed diagnosis of this measure lists the start time, end time, first UPN, second UPN, first IP address, second IP address, conference ID and the count of poor video streams.

Poor video streams percentage

Indicates the percentage of video streams that were classified as poor.

Percentage

 

Good streams

Indicates the number of video streams that were classified as good.

Number

 

Avg video received frame rate

Indicates the average frames per second received for all video streams computed over the duration of the session for streams.

Frames/second

 

Avg video post FECPLR

Indicates the average of packet loss rate after FEC has been applied across all video streams and codecs for streams, expressed in percentage.

Percentage

 

Avg fraction of packets lost

Indicates the average fraction of packets lost, as specified in RFC3550, computed over the duration of the session for streams, in percentage.

Percentage

 

Low video frame rate

Indicates the average frames per second received for a video stream, computed over the duration of the session, expressed in percentage.

Percentage

 

Avg video frames lost

Indicates the average percentage of video frames lost as displayed to the user.

Percentage

 

Avg video dynamic capability percent

Indicates the average of percentage of time that the client is running < 70% of the expected video processing capability for each type of CPU for streams.

Milliseconds

 

The detailed diagnosis of the Poor streams measure lists the start time, end time, first UPN, second UPN, first IP address, second IP address, conference ID and the count of poor video streams.

Poor Streams Measure Detailed Diagnosis

Figure 1 : The detailed diagnosis of the Poor streams measure

The detailed diagnosis of the Poor streams due to high video frame rate measure lists the start time, end time, first UPN, second UPN, first IP address, second IP address, conference ID and the number of video streams classified as poor due to high video frame rate.

High Video Frame Rate Measure Detailed Diagnosis

Figure 2 : The detailed diagnosis of the Poor streams due to high video frame rate measure