- Print
- DarkLight
- PDF
Microsoft Teams Scout
- Print
- DarkLight
- PDF
The Microsoft Teams Scout requires Custom Hive version 1198 or higher. Learn how to upgrade your Custom Hives.
The Microsoft Teams Scout lets you test the connection to Microsoft Teams servers to ensure that users in your network are able to access Teams and have a high call quality.
For example, you can use this Scout to be alerted whenever Teams servers are unavailable from your network, or when the call quality drops below an acceptable threshold.
How it Works
On each test run, the Scout performs two different tests of Microsoft Teams servers:
- An HTTPS request to the Teams network edge (https://teams.microsoft.com). The network edge test is successful if it returns the HTTP status code
200
. A connection to the Teams network edge is required to use the Teams application and initiate calls. - A call quality test to the Teams relay server (worldaz.tr.teams.microsoft.com) to measure the packet loss, jitter, and latency. The relay server test is successful if the packet loss is less than the percentage that you set in the Scout configuration. A lower packet loss from the relay server indicates a higher quality Teams call. The Scout first connects to the relay server using UDP over port 3478. If no packets are received using UDP, then the Scout connects using TCP over port 443.
By default, the Scout fails if either the edge test or the relay server test fails. Change the Scout fails if parameter if you want the Scout to fail only when both the edge test and relay server test fail.
Create a Microsoft Teams Scout
In the Scoutbees top bar, click Create Scout to open the Add New Scout window.
From the Applications tab, select Microsoft Teams as the Scout Type.
Select the locations (Hives) from which you want to test the connection to Teams.
Enter a Name for the Scout.
Select how often you want the Scout to run a test using the Run Every slider.
Optionally, attach Labels to your Scout. Labels are key-value pairs which can be used to organize your Scouts. Learn more about Scout Labels.
Optionally, click Show Additional Parameters to configure the following:
- Teams Edge Address - If you don't want to use the default edge address, then you can enter a different address. It is unlikely that you have to change this parameter.
- Teams Relay Server Address - If you don't want to use the default relay server address, then you can enter a different address. It is unlikely that you have to change this parameter.
- Relay server test is successful if packet loss is - Sets the required packet loss to the relay server for the relay server test to succeed. A lower packet loss percentage indicates a better call quality.
- Scout fails if - Sets which network tests to Teams servers can cause the Scout to fail a test run. By default, the Scout fails a test run if either the edge test or the relay server test fails. Change this parameter to Edge test fails AND relay server test fails if you want the Scout to fail a test run only if both Teams server tests fail.
Click Next: Alert Policy to set up alerts and notifications on the Scout before saving it. See the table below for a full list of the metrics that the Scout collects. Some of those metrics can be used as conditions when configuring an alert policy. Learn more about alert policies.
Test Results
The test results show you information about the connection to the Teams network edge and relay server.
Metrics
The metrics below are saved on each Scout test run.
Metric name | Description |
---|---|
Relay Avg. Latency | The average latency to the relay server in ms. |
Failure Reason | The reason that the Scout failed. |
Relay FQDN | The FQDN of the relay server. |
Relay IP | The IP address of the relay server. |
Relay Protocol | The transport layer protocol used for the relay server test (either UDP or TCP). Read How it Works for details. |
Relay Port | The port used for the relay server test. The port depends on the protocol used (UDP or TCP). Read How it Works for details. |
Relay Packets Sent | The number of packets sent to the relay server. |
Relay Packets received | The number of packets received from the relay server. |
Relay Packets loss | The packet loss percentage to the relay server. The packet loss can cause the Scout to fail a test run based on the Scout's configuration. |
Relay Jitter | The jitter to the relay server in ms. |
Relay Test Duration | The duration of the relay server test. |
Edge Destination | The address of the Teams edge server. |
Edge Response Body Size | The size of the response body from the http request to the edge server in bytes. |
Edge Certificate Expiration Days | The number of days until the edge server SSL certificate expires. |
Edge Connect Time | The time it took to establish a connection to the edge server in ms. |
Edge Health Failure Reason | The failure reason for the edge test. |
Edge Total Duration | The total http request and response time for the edge test in ms. |
Edge Name Lookup Time | The domain name lookup time for the edge test in ms. |
Edge Redirects | The number of redirects for the edge test. |
Edge Redirects Time | The redirect time for the edge test. |
Edge Response Time | The time of the response phase of the http request to the edge server in ms. |
Edge Health Test Status | The result of the edge test. The edge test result affects the overall Scout test result based on how you set the Scout fails if parameter in the Scout configuration. |
Edge Status Code | The http status response code for the edge test. |
Edge TLS Handshake Time | The TLS handshake time for the edge test. |
Edge Response Size | The size of the response from the http request to the edge server in bytes. |
Edge Time to First Byte | The time to first byte for the edge test in ms. |