ThousandEyes Documentation
  • ThousandEyes Documentation
  • What's New
    • Changelog
    • Naming and Navigation Menu Changes - Summary List
  • Product Documentation
    • Getting Started
      • Getting Started with Account Setup
      • Getting Started with Cloud and Enterprise Agents
      • Getting Started with Cloud and Enterprise Agent Tests
      • Getting Started with Endpoint Agents
      • Getting Started with Transactions
      • Getting Started with Dashboards
      • Getting Started with Alerts
      • Getting Started with Internet Insights
      • Getting Started with the ThousandEyes API
      • Getting Started with API Tests
      • Getting Support from ThousandEyes
      • Notification of Upgrades, Maintenance and Outages
      • New User FAQ
      • ThousandEyes Glossary
    • Global Vantage Points
      • Cloud Agents
        • Where Are Cloud Agents Available?
        • Webex Cloud Agents
        • AWS Wavelength Cloud Agents
        • Cloud Agent with Local Problems
      • Enterprise Agents
        • Getting Started
          • Where Can I Get the Account Group Token?
        • Installing
          • Enterprise Agent System Requirements
            • Enterprise Agent Support Lifecycle
          • Appliances
            • How to Set Up the Virtual Appliance
            • Enterprise Agents: Hypervisor Installation
            • Installing Enterprise Agent on VirtualBox
            • Enterprise Agent Deployment Using ThousandEyes Virtual Appliance (Hyper-V)
            • Enterprise Agent Deployment Using ThousandEyes Virtual Appliance (OVA)
            • Custom Virtual Appliances
            • Installing a Physical Appliance
            • Installing an Enterprise Agent on a Raspberry Pi Device
          • Cisco Devices
            • Catalyst Switching
            • Catalyst Routing
            • Nexus Switching
            • Service Routing
            • Meraki MX Appliances
            • Cisco Enterprise NFV Infrastructure Software
            • Installation Methods
              • Installing Enterprise Agents on Cisco Nexus Switches with Application Hosting
              • Installing Enterprise Agents on Cisco Nexus Switches with Guestshell
              • Installing Enterprise Agents on Cisco Routers using SD-WAN Manager Feature Templates
              • Installing Enterprise Agents on Cisco Routers using the SD-WAN Manager ThousandEyes Workflow
              • Installing Enterprise Agents on Cisco Switches with Docker
              • Installing Enterprise Agents on Cisco Routers with Docker
              • Installing Enterprise Agents on Cisco Switches with the DNA Center
          • Linux Packages
            • Enterprise Agent Deployment Using Linux Package Method
            • Installing the Enterprise Agent with BrowserBot on Oracle Linux Server 7
          • Docker Agents
            • Installing Enterprise Agents with Docker
          • Cloud Templates
            • Installing Enterprise Agents with Microsoft Azure
          • Docker Agent Configuration Options
          • Missing Dependencies for Enterprise Agent on Redhat Enterprise Linux RHEL 7 Installation
          • Migrating ThousandEyes Appliance or Package-Based Enterprise Agent to Docker
        • Configuring
          • Password Reset on the Virtual Appliance
          • Configuring rDNS Lookups for Enterprise Agents
          • Connecting to the ThousandEyes Virtual Appliance Using SSH (Mac/Linux)
          • Connecting to the ThousandEyes Virtual Appliance Using SSH (Windows)
          • Static IP Addresses for ThousandEyes Repositories
          • Firewall Configuration for Enterprise Agents
          • Enterprise Agent Port Forwarding
          • Security Policy and Public NTP Servers on Enterprise Agents
          • Secure Access to ThousandEyes Appliances
          • Disabling the Web Server of a Virtual Appliance
          • NAT Traversal for Agent-to-Agent Tests
          • Enterprise Agent on Docker Advanced Networking
        • Managing
          • Cisco Devices
            • Disable, Restart, or Uninstall the Enterprise Agent via DCNM
          • Docker Agents
            • Add/Remove BrowserBot from Existing Docker Enterprise Agents
          • Upgrading Operating Systems for Enterprise Agents
          • Backup and Restore Your Enterprise Agent Configuration
          • Upgrade Ubuntu 20.04 Focal-Based ThousandEyes Appliances
          • Crash Reporting for Enterprise Agents
          • Configuring a Local Mirror of the ThousandEyes Package Repository
          • Resetting an Enterprise Agent
          • Working with Enterprise Agent Clusters
          • Replacing an Enterprise Agent Using the Agent Clustering Method
          • Replacing an Enterprise Agent Using Agent Identity Files
          • Unlocking the ThousandEyes Appliance
          • Uninstalling the Enterprise Agent (Linux Package)
        • Proxy Environments
          • Installing Enterprise Agents in Proxy Environments
          • Configuring an Enterprise Agent to Use a Proxy Server
          • Writing and Testing Proxy Auto-Configuration (PAC) Files
        • Troubleshooting
          • How to Generate Packet Captures
          • Troubleshooting Automatic-Update Problems on Enterprise Agents
          • Troubleshooting Time Synchronization on Enterprise Agents
          • Installing CA Certificates on Enterprise Agents
          • Agent Unable to Trace Path to Destination?
          • BrowserBot Installation Fails on Red Hat or CentOS in Amazon EC2
          • What to Do If te-agent Stops Running Due to a VACUUM Error
        • Enterprise Agents: What Information Do We Collect?
        • What Is BrowserBot?
        • Upgrading to BrowserBot 2
        • Upgrading to BrowserBot 2.6+ (Chromium 97)
        • Enterprise Agent Utilization
        • Network Utilization from Enterprise Agent Test Traffic
        • Enterprise Agent Interface Selection
        • ThousandEyes Product Lifecycle Policy
      • Endpoint Agents
        • Installing
          • System Requirements
          • Download the Endpoint Agent Installer
          • Install the Endpoint Agent
          • Reinstall the Endpoint Agent
          • Install the Endpoint Agent Browser Extension
          • Install Endpoint Agents for Windows via Group Policy
          • Installing Browser Extensions for Windows via Group Policy
          • Guidance for Windows Software Deployment Teams
          • Install Endpoint Agents for macOS using Munki and the Managed Software Center
          • Deploy an MSI package to Intune for Windows Devices
          • Endpoint Agent Installation on Cisco Webex Devices (RoomOS)
          • Endpoint Agent Installation on Cisco Phone Devices (PhoneOS)
          • Uninstall or Delete an Endpoint Agent
          • Endpoint Agent Installation Reference
          • NPCAP Driver Upgrade Management
        • Configuring
          • Configure Endpoint Agent Labels
          • Endpoint Agent Proxy Configuration for Scheduled Tests
        • Managing
          • Manage Endpoint Agent Settings
        • How Does the Endpoint Agent Work
        • Cisco Secure Client ThousandEyes Endpoint Agent Module
        • Endpoint Agent Licensing
        • Assigning tests to an Endpoint Agent
        • Data Collected by Endpoint Agent
        • Reporting on data collected by Endpoint Agent
        • Endpoint Agent VPN Support
        • Endpoint Agent TCP Support
        • Endpoint Agent End-user Experience
        • Endpoint Agent FAQ
      • Working with Agent Settings
      • Obtaining a list of ThousandEyes Agent IP Addresses with te-iplist
    • Tests
      • HTTP Server Tests
        • Collecting Proxy Metrics
        • POSIX Extended Regular Expression Syntax (Quick Reference)
        • POSIX Extended Regular Expression Syntax
        • Custom User-Agent Strings in a Web Test
        • Two-Step HTTP Testing (OAuth)
      • Web-Layer Tests
      • Network Tests
        • Network Tests Explained
        • Agent-to-Agent Test Overview
        • DSCP Options in Network Tests
      • DNS Tests
      • Voice Tests
        • SIP Server Test Settings
        • RTP Stream Test Settings
        • Using the SIP Server View
        • Using the RTP Stream View
      • BGP Tests
        • Inside-Out BGP Visibility
        • Using the BGP Route Visualization View
        • Using the BGP Updates Table
        • Working with Raw BGP Data
        • Reasons for Failure of Private Peering with ThousandEyes
        • RPKI
      • API Tests
        • Using the API Test Step Builder
      • Templates
        • User-defined Templates
      • Recommendations
        • Associated Service Recommendations
        • AWS Test Recommendations
      • ThousandEyes Metrics: What Do Your Results Mean?
      • Sharing Test Data
      • Working with Test Settings
      • Scheduled Versus Instant Tests
      • Working with Instant Tests
      • Working with Labels for Agent and Test Groups
      • Multi-Service Views
      • Identifying Traffic from ThousandEyes Agents
      • Excluding ThousandEyes Agents from Google Analytics
    • Internet and WAN Monitoring
      • Path Visualization
        • How Path Trace Works
        • MPLS Tunnel Inference Using Deep Path Analysis
        • Troubleshooting
          • Reasons for Missing Information on the Visualization View
          • Virtual Machine with NAT Breaks Path Visualization
          • Cisco ASA Breaks Path Visualization
          • Path Visualization: Edge Firewall Incorrectly Shows a Single Hop to the Destination
          • Network Overview Shows Packet Loss That Does Not Appear in Path Visualization
      • Views
        • Using the Network Overview
        • Using the FTP Server View
        • Using the HTTP Server View
        • Using the DNS Server View
        • Using the DNS Domain Trace View
        • Using the DNSSEC Trace View
        • Using the API Test Views
      • Troubleshooting
        • CLI Network Troubleshooting Utilities
        • HTTP Server Test Fails with SSL Error
        • HTTP Server Test Fails with SSL Error: OpenSSL SSL_connect: SSL_ERROR_SYSCALL
        • HTTP Server Test Error "dh Key Too Small"
    • Browser Synthetics
      • Browser Synthetics Test Types
      • Browser Synthetics Disambiguation
      • Test Settings for Page Load and Transaction Tests
      • Navigating Waterfall Charts for Page Load and Transaction Tests
      • Using Round Robin Test Scheduling
      • What Information Is Transmitted in a Page Load or Transaction Test?
      • Transaction Test SSO Support
        • Implementing SSO in Transaction Scripts
        • Caveats for NTLM/Kerberos Authentication
        • TOTP Examples for SSO
      • Page Load Tests
        • When to Use a Page Load Test
        • Creating a Page Load Test
        • Using the Page Load View
        • How to Generate a HAR File
        • Migrating to Single Interval for Page Load Tests
        • Creating a Page Load Test that Uses SSO
      • Transaction Tests
        • Getting Started With Transaction Tests
          • When to Use a Transaction Test
          • Transaction Tests Compared With Other Test Types
          • ThousandEyes Recorder
          • ThousandEyes Recorder Permissions
          • Working With Web Development Tools
          • Working With Secure Credentials
          • Transaction Test Table Tab View
          • Transaction Metrics on Alerts and Dashboards
          • Screenshots in Transaction Test Views
        • Transaction Test Development Guide
          • Creating Robust Transaction Scripts
            • Optimizing and Troubleshooting Transaction Scripts
            • Transaction Scripting Tips and Tricks
          • Transactions – Executing Custom JavaScript Code
        • Use Cases | Code Examples
          • Uploading or Downloading Files in a Script
            • Transaction Scripting Examples for File Downloads
          • Include API Calls in a Transaction Test
            • Using the node-fetch module
            • Using the net module
            • Using the tls module
        • Transaction Scripting Reference
      • Dual Chromium Option
        • Why Are Regular Chromium Upgrades Needed?
        • Configuring Dual Chromium
        • Working With Dual Chromium
        • Chromium Update History
        • Chromium Upgrade Known Issues
    • Endpoint Experience
      • Test Settings
        • Monitoring an Application using Synthetic Tests
        • Configuration Options for Synthetic Tests
        • Managing Synthetic Tests
        • Real User Tests
      • Viewing Data
        • Endpoint Agent Scheduled Tests View
        • Endpoint Agent Real User Tests View
        • Endpoint Agent Local Networks View
        • Endpoint Agent Dynamic Tests View
        • Endpoint Agent Views
        • Endpoint Views Reference
      • Troubleshooting
        • Step-by-Step Guide to Troubleshooting Endpoint Agent Problems
        • Troubleshooting Endpoint Agent Issues
    • Connected Devices
      • Connected Devices Tests
        • Routing
          • Traceroute
        • Network
          • Speed Tests
          • Latency, Loss, Disconnections, and Jitter Tests
          • Responsiveness (Latency under Load) Tests
        • DNS
          • DNS Resolution Tests
        • Web
          • Web Browsing Lite Tests
          • Generic Streaming (HLS/DASH) Tests
        • Voice
        • Dynamic Application Test Suites
          • Gameplay Test Suite
          • Video Conferencing Test Suite
          • Social Media Test Suite
          • Game Store Test Suite
          • Video Streaming Test Suite
            • Netflix Streaming Tests
            • YouTube Streaming Tests
            • BBC iPlayer Streaming Tests
          • Content Delivery Network (CDN) Test Suite
        • Local Network Information
          • Data Usage
      • Test Management
        • Test Triggers
          • Scheduled Tests
          • Instant Tests
        • Testing Thresholds
        • Test Targets
          • Test Server Methodology
        • Automatic Test Configuration Retrieval
      • Device Agents
        • Router Agents
          • Router Agent Device Support
        • Connected Devices Agent Release Versions
      • Usage Guides
        • Viewing Charts
        • Configuring Charts
        • Using Maps
        • Exporting Data
        • Importing Metadata
        • Managing Metadata
        • Creating Reports
        • Viewing Agents
        • Using Test Schedules
        • Accessing Your APIs
        • Using ConstantCare
      • Cisco Real Speed
    • Cloud Insights
      • Integrations
      • Views
      • Settings
    • Traffic Insights
      • Traffic Insights System Requirements
      • Traffic Insights Configuration Guide
      • Traffic Insights Views and Settings
      • Traffic Insights FPS Monitoring
    • WAN Insights
      • WAN Insights Quick Start
        • How to Activate ThousandEyes WAN Insights
        • WAN Insights Introductory Tour, Part 1
        • WAN Insights Introductory Tour, Part 2
        • WAN Insights Introductory Tour, Part 3
      • Introducing WAN Insights
        • What Is WAN Insights?
        • WAN Insights Value-Add
        • Why Use WAN Insights?
        • Using WAN Insights Together With ThousandEyes Network Assurance
        • Using WAN Insights Together with vAnalytics and vManage
        • WAN Insights Key Components
        • Enabling WAN Insights
        • Getting Support for WAN Insights
      • WAN Insights Terminology and Reference
      • WAN Insights Technical Overview
        • Application Categories
        • Sites, Routers, Paths, and Interfaces
        • Application Traffic Types
        • Estimating User Counts
        • Estimating Throughput
        • Capacity Planning
        • Understanding Quality
        • Life of a Recommendation
        • Understanding Recommendations
        • WAN Insights and ThousandEyes Alerts
      • WAN Insights User Interface
        • Logging In for the First Time
        • WAN Insights Screens and Workflows
        • Recommendations Screen
        • Recommendation Cards, Explained
        • Recommendation Details Modal
        • Endpoint-Pair Quality Comparison
        • Site Details Screen
        • Capacity Planning Screen
        • Capacity Detail Modal
        • Enter or Upload Bandwidth Data
      • Common Tasks
        • Adding Business-Critical Applications to WAN Insights
        • Email Notifications
        • Adding and Managing WAN Insights Users
        • Applying WAN Insights Recommendations
    • Internet Insights
      • Internet Insights Terminology
      • Limited Outage Map
      • Internet Insights Screens
        • Overview Screen
        • Internet Insights Service Views Screen
        • Application Outages
        • Network Outages
        • Catalog Settings Screen
      • Saving and Sharing from Internet Insights
      • Configuring Internet Insights
      • Provider Labels
      • Using Alerts and Dashboards With Internet Insights
        • My Affected Tests
        • Setting Up Alert Rules for Internet Insights
        • Using the Internet Insights Built-In Dashboard
    • Event Detection
    • Alerts
      • Creating and Editing Alert Rules
        • Global and Location Alert Conditions
        • Alert Rule Severity
        • Adaptive Alert Detection
        • Dynamic Baselines
        • Transport Layer Security (TLS) Alerts
        • Alert Rules for Devices
        • Alert Metrics Reference
      • Default Alert Rules
      • Viewing Alerts
      • Alert Clearing
        • Alert Suppression Windows
      • Alert Notifications
      • Standard Notification Methods
        • Alert Notifications via Email
        • Alert Notifications via SMS
        • Classic Webhooks for Alert Notifications
    • Dashboards
      • Using the Dashboard
      • Customizing Your Dashboard
      • Using the Dashboard Templates
      • Dashboard Widgets
      • Embedding Dashboard Widgets in External Web Sites
      • Excluding Periods of Data From a Dashboard
      • Dashboard Sharing and Snapshots
      • Dashboard Labels
      • Troubleshooting with Dashboard Drill Down
      • Tailoring Dashboards with Dashboard Filters
    • Device Layer
      • Discovering Device-Layer Devices
      • Device Discovery Results
      • Using the Device Layer View
    • Account Management
      • User Registration
        • SAML JIT Provisioning
        • ThousandEyes Support for SCIM
          • How to Configure SCIM with Azure Active Directory
          • How to Configure SCIM with Okta
      • Authorization
        • Role-Based Access Control
          • Role-Based Access, Explained
          • Built-In Roles and Permissions
        • Account Groups
          • What is an Account Group?
          • Working with Account Settings
          • Users in Multiple Organizations
          • Changing Ownership of a Test
          • Working with Time Zone Settings
        • OAuth 2.0 with ThousandEyes
          • Integrations with OAuth 2.0
        • Adding a Profile Image with Gravatar
      • Authentication
        • Logging In
        • How to Configure Single Sign-On
      • User Activity
        • Working with the Activity Log
        • ThousandEyes User Session Timeouts and Terminations
        • How Long is my Data Accessible via ThousandEyes?
        • Retaining Data Beyond the 90-Day Limit
        • Multi-Region Cloud Support
      • Usage-Based Billing
        • About Our Consumption Model
          • Device Agent Consumption Model
        • About Units
        • Test Type Layers and Units
        • Setting Quotas
        • Calculating Units
        • FAQs: Usage
      • Customer Security and Privacy Responsibilities
    • Integrations
      • Custom Webhooks
        • Using OAuth 2.0 Authentication for Your Custom Webhook
        • Webhook Variables
      • Custom Webhook Examples
        • Microsoft Teams for Alert Notifications
        • Cisco Webex for Alert Notifications
        • Google Chat for Alert Notifications
        • Event-Driven Ansible for Alert Notifications
        • Splunk Alert Notification
      • Custom-Built Integrations
        • PagerDuty for Alert Notifications
        • ServiceNow for Alert Notifications
          • Incident Management
        • Slack for Alert Notifications
        • AppDynamics for Alert Notifications
        • AppDynamics for Test Recommendations
        • AWS for Test Recommendations
        • AWS for Cloud Insights
          • AWS for Cloud Insights Using CLI
        • Meraki for Data Enrichment
        • Webex Control Hub Integration
        • Microsoft Teams Integration
        • ThousandEyes for OpenTelemetry
          • Configuring ThousandEyes for OpenTelemetry
            • Configuring ThousandEyes for OpenTelemetry Using the API
            • Configuring ThousandEyes for OpenTelemetry Using the UI
          • Configuring ThousandEyes for Splunk Cloud or Enterprise
            • Configuring ThousandEyes for Splunk Cloud or Enterprise using the API
            • Configuring ThousandEyes for Splunk Cloud or Enterprise using the UI
          • ThousandEyes for OpenTelemetry Data Model
            • ThousandEyes for OpenTelemetry Data Model v1
              • OpenTelemetry Collector Data v1 Example
            • ThousandEyes for OpenTelemetry Data Model v2
              • ThousandEyes for OpenTelemetry Data Model v2 - Metrics
                • OpenTelemetry Collector Data v2 Metrics Example
                • ThousandEyes for OpenTelemetry Data Model Metrics - Migration from v1 to v2
              • ThousandEyes for OpenTelemetry Data Model v2 - Traces
                • OpenTelemetry Collector Data v2 Traces Example
          • OpenTelemetry Collector Configuration
          • Automatic Disabling of Failing Streaming Integrations
        • Cisco ThousandEyes App for Splunk
          • Configuration
          • Inputs
          • Dashboards
          • Troubleshooting
    • Best-Practices Guides
      • Choosing the Right Test Protocol for Network & App Synthetics Tests
      • Optimizing SYN vs SACK Probing Methods to Avoid Unexplainable Packet Loss
      • Using Dashboards to Tell a Story
      • Best Practices for Implementing Account Groups
      • Monitoring Microsoft 365
      • Monitoring Microsoft Teams
      • Monitoring Salesforce
      • Monitoring Slack
      • Monitoring Webex Meetings with Endpoint Agents
      • Monitoring Webex Calling
      • Monitoring Webex Meetings with Cloud and Enterprise Agents
      • Monitoring Zoom
    • API
      • Create/Update/Delete Tests Using the ThousandEyes API
      • Obtaining a List of ThousandEyes Agent IP Addresses
      • Writing JSON to API Produces HTTP 406 Response Code
    • Privacy-Related
      • Authorized Subprocessors for ThousandEyes Network Intelligence Platform
    • Archived Documentation
      • Archived - Displaying and Alerting for Unit Consumption
      • Archived - Dependency Tree for ThousandEyes Enterprise Agent Software
      • Archived - Getting Started with ThousandEyes
      • Archived - Sending ThousandEyes Alerts to AppDynamics
      • Archived - ThousandEyes Infrastructure Changes
      • Archived - Using the Transactions (Classic) View
      • Archived - Transaction Test Migration Workflow
      • Archived - Instructions for Mitigating Meltdown and Spectre on Enterprise Agents
      • Archived - Bash (ShellShock) Security Notice
      • Archived - Endpoint Installation using Customized Installers
      • Archived - Configuring Endpoint Agent Setup
      • Archived - Creating Scheduled Tests on Endpoint Agents
      • Archived - Managing the Endpoint Agent
      • Archived - Enterprise Agent Installation on Juniper NFX Routers
      • Archived - Installing and Removing ThousandEyes X Virtual Framebuffer on Enterprise Agents
      • Archived - Permitted Content Types for Page Load Tests
  • Archived Release Notes
    • 2024
      • Release Notes: January 2024
      • Release Notes: February 2024
      • Release Notes: March 2024
      • Release Notes: April 2024
      • Release Notes: May 2024
      • Release Notes: June 2024
      • Release Notes: July 2024
      • Release Notes: August 2024
    • 2023
      • Release Notes: January 2023
      • Release Notes: February 2023
      • Release Notes: March 2023
      • Release Notes: April 2023
      • Release Notes: May 2023
      • Release Notes: June 2023
      • Release Notes: July 2023
      • Release Notes: August 2023
      • Release Notes: September 2023
      • Release Notes: October 2023
      • Release Notes: November 2023
      • Release Notes: December 2023
    • 2022
      • Release Notes: January 2022
      • Release Notes: February 2022
      • Release Notes: March 2022
      • Release Notes: April 2022
      • Release Notes: May 2022
      • Release Notes: June 2022
      • Release Notes: July 2022
      • Release Notes: August 2022
      • Release Notes: September 2022
      • Release Notes: October 2022
      • Release Notes: November 2022
      • Release Notes: December 2022
    • 2021
      • Release Notes: January 2021
      • Release Notes: February 2021
      • Release Notes: March 2021
      • Release Notes: April 2021
      • Release Notes: May 2021
      • Release Notes: June 2021
      • Release Notes: July 2021
      • Release Notes: August 2021
      • Release Notes: September 2021
      • Release Notes: October 2021
      • Release Notes: November 2021
      • Release Notes: December 2021
    • 2020
      • Release Notes: January 2020
      • Release Notes: February 2020
      • Release Notes: March 2020
      • Release Notes: April 2020
      • Release Notes: May 2020
      • Release Notes: June 2020
      • Release Notes: July 2020
      • Release Notes: August 2020
      • Release Notes: September 2020
      • Release Notes: October 2020
      • Release Notes: November 2020
      • Release Notes: December 2020
    • 2019
      • Release Notes: 2019-01-08
      • Release Notes: 2019-02-06
      • Release Notes: 2019-02-20
      • Release Notes: 2019-03-06
      • Release Notes: 2019-03-19
      • Release Notes: 2019-04-02
      • Release Notes: 2019-04-30
      • Release Notes: 2019-05-14
      • Release Notes: 2019-05-30
      • Release Notes: 2019-06-11
      • Release Notes: 2019-07-23
      • Release Notes: 2019-08-06
      • Release Notes: 2019-08-20
      • Release Notes: 2019-09-03
      • Release Notes: 2019-09-17
      • Release Notes: 2019-10-03
      • Release Notes: 2019-10-15
      • Release Notes: 2019-10-29
      • Release Notes: 2019-11-12
      • Release Notes: 2019-11-26
      • Release Notes: 2019-12-10
    • 2018
      • Release Notes: 2018-01-10
      • Release Notes: 2018-01-17
      • Release Notes: 2018-01-31
      • Release Notes: 2018-02-14
      • Release Notes: 2018-03-07
      • Release Notes: 2018-03-14
      • Release Notes: 2018-03-28
      • Release Notes: 2018-04-11
      • Release Notes: 2018-04-25
      • Release Notes: 2018-05-09
      • Release Notes: 2018-05-23
      • Release Notes: 2018-06-06
      • Release Notes: 2018-06-20
      • Release Notes: 2018-07-03
      • Release Notes: 2018-07-18
      • Release Notes: 2018-08-01
      • Release Notes: 2018-08-15
      • Release Notes: 2018-08-29
      • Release Notes: 2018-09-12
      • Release Notes: 2018-09-26
      • Release Notes: 2018-10-10
      • Release Notes: 2018-10-23
      • Release Notes: 2018-11-13
      • Release Notes: 2018-11-27
      • Release Notes: 2018-12-18
    • 2017
      • Release Notes: 2017-01-04
      • Release Notes: 2017-01-18
      • Release Notes: 2017-02-01
      • Release Notes: 2017-02-16
      • Release Notes: 2017-03-02
      • Release Notes: 2017-03-15
      • Release Notes: 2017-03-29
      • Release Notes: 2017-04-12
      • Release Notes: 2017-04-26
      • Release Notes: 2017-05-10
      • Release Notes: 2017-05-24
      • Release Notes: 2017-06-06
      • Release Notes: 2017-06-21
      • Release Notes: 2017-07-07
      • Release Notes: 2017-07-19
      • Release Notes: 2017-08-02
      • Release Notes: 2017-08-16
      • Release Notes: 2017-08-30
      • Release Notes: 2017-09-13
      • Release Notes: 2017-09-27
      • Release Notes: 2017-10-12
      • Release Notes: 2017-10-25
      • Release Notes: 2017-11-08
      • Release Notes: 2017-11-29
      • Release Notes: 2017-12-13
    • 2016
      • Release Notes: 2016-01-06
      • Release Notes: 2016-01-20
      • Release Notes: 2016-02-03
      • Release Notes: 2016-02-17
      • Release Notes: 2016-03-02
      • Release Notes: 2016-03-16
      • Release Notes: 2016-03-30
      • Release Notes: 2016-04-13
      • Release Notes: 2016-04-27
      • Release Notes: 2016-05-11
      • Release Notes: 2016-05-25
      • Release Notes: 2016-06-08
      • Release Notes: 2016-06-22
      • Release Notes: 2016-07-06
      • Release Notes: 2016-07-20
      • Release Notes: 2016-08-03
      • Release Notes: 2016-08-17
      • Release Notes: 2016-08-31
      • Release Notes: 2016-09-14
      • Release Notes: 2016-09-28
      • Release Notes: 2016-10-12
      • Release Notes: 2016-10-26
      • Release Notes: 2016-11-09
      • Release Notes: 2016-11-23
      • Release Notes: 2016-12-07
      • Release Notes: 2016-12-21
    • 2015
      • Release Notes: 2015-01-07
      • Release Notes: 2015-01-21
      • Release Notes: 2015-02-04
      • Release Notes: 2015-02-18
      • Release Notes: 2015-03-04
      • Release Notes: 2015-04-01
      • Release Notes: 2015-04-15
      • Release Notes: 2015-04-29
      • Release Notes: 2015-05-13
      • Release Notes: 2015-05-27
      • Release Notes: 2015-06-10
      • Release Notes: 2015-06-24
      • Release Notes: 2015-07-08
      • Release Notes: 2015-07-22
      • Release Notes: 2015-08-05
      • Release Notes: 2015-08-19
      • Release Notes: 2015-09-16
      • Release Notes: 2015-09-30
      • Release Notes: 2015-10-14
      • Release Notes: 2015-10-28
      • Release Notes: 2015-11-11
      • Release Notes: 2015-12-02
      • Release Notes: 2015-12-16
    • 2014
      • Release Notes: 2014-01-09
      • Release Notes: 2014-01-22
      • Release Notes: 2014-02-05
      • Release Notes: 2014-03-05
      • Release Notes: 2014-03-19
      • Release Notes: 2014-04-09
      • Release Notes: 2014-04-30
      • Release Notes: 2014-06-04
      • Release Notes: 2014-06-11
      • Release Notes: 2014-06-26
      • Release Notes: 2014-07-09
      • Release Notes: 2014-07-23
      • Release Notes: 2014-08-20
      • Release Notes: 2014-09-04
      • Release Notes: 2014-09-17
      • Release Notes: 2014-10-01
      • Release Notes: 2014-10-15
      • Release Notes: 2014-10-29
      • Release Notes: 2014-11-12
    • 2013
      • Release Notes: 2013-01-08
      • Release Notes: 2013-02-27
      • Release Notes: 2013-03-20
      • Release Notes: 2013-04-02
      • Release Notes: 2013-04-17
      • Release Notes: 2013-05-01
      • Release Notes: 2013-05-21
      • Release Notes: 2013-06-11
      • Release Notes: 2013-06-18
      • Release Notes: 2013-07-10
      • Release Notes: 2013-07-24
      • Release Notes: 2013-08-07
      • Release Notes: 2013-09-05
      • Release Notes: 2013-09-18
      • Release Notes: 2013-10-02
      • Release Notes: 2013-10-30
      • Release Notes: 2013-11-13
      • Release Notes: 2013-11-27
    • 2012
      • Release Notes: 2012-03-28
      • Release Notes: 2012-04-11
      • Release Notes: 2012-04-24
      • Release Notes: 2012-05-22
      • Release Notes: 2012-06-05
      • Release Notes: 2012-06-20
      • Release Notes: 2012-08-01
      • Release Notes: 2012-08-28
On this page
  • Audience Prerequisites
  • Introduction
  • Microsoft Teams Architecture
  • Microsoft Teams Meeting and Call Flow for Internal Users One-on-One
  • Microsoft Teams Meeting and Call Flow for Users Who Cannot Connect Directly
  • Monitoring Microsoft Teams with Cloud and Enterprise Agents
  • Network Performance Requirements Edge-to-Edge
  • Agent Placement and Selection
  • Microsoft Teams Test Template
  • Microsoft Teams Health Dashboard
  • Microsoft Teams Health Overview - By Service
  • Monitoring Microsoft Teams with Endpoint Agents
  • Synthetic Tests
  • Real-User Tests
  • Monitoring Microsoft Teams with Internet Insights
  • Package Selection
  1. Product Documentation
  2. Best-Practices Guides

Monitoring Microsoft Teams

PreviousMonitoring Microsoft 365NextMonitoring Salesforce

Last updated 1 month ago

Due to recent platform-wide naming, navigation, and URL changes in the product, you may notice some discrepancies between the product and the screenshots displayed in our technical documentation. The instructions and actual pages in the product are still valid and haven’t changed. Please bear with us as we update our screenshots to better match the in-product experience. See the full scope of changes on .

This best-practices guide is intended for readers who already have some proficiency in ThousandEyes and are ready to delve into more advanced guidance. It assumes a basic understanding of networking concepts, an understanding of how Microsoft Teams is used for collaboration, as well as familiarity with the ThousandEyes platform. If you are new to ThousandEyes, we recommend starting with our to establish a solid foundation.

This article describes monitoring for a third-party application, and might not apply to all use cases. Because the third-party company updates their application separately from ThousandEyes, the information outlined here might not represent the application's latest architecture. ThousandEyes will provide best-effort support for these solutions.

Audience Prerequisites

To effectively follow this guide, you should be:

  • Familiar with the and the test types for and .

  • Familiar with ThousandEyes’ settings to ensure your user account has the necessary permissions.

  • Able to deploy Enterprise Agents and/or Endpoint Agents, if they’re not already deployed.

  • Aware of your organization’s available licenses for Endpoint Agents and Internet Insights, and available units for Cloud and Enterprise Agents. For information on your organization’s usage and capacity, see the articles in the section.

  • Proficient in Microsoft Teams collaboration concepts and .

  • Comfortable with networking concepts, such as:

    • TCP/IP, HTTP, DNS, and how they relate to the ThousandEyes platform

    • Content delivery networks (CDNs)

    • (QOS) settings and DSCP

    • The difference between DNS resolvers (recursive DNS servers) and authoritative DNS nameservers. To learn more, see the .

    • Hub-and-spoke WAN architecture vs. direct internet egress

Introduction

This guide will walk you through how to monitor your workforce digital experience for Microsoft Teams. To accomplish this, you'll use multiple features within ThousandEyes, including:

  • ThousandEyes Cloud and Enterprise Agents

  • ThousandEyes Endpoint Agents

  • ThousandEyes Internet Insights

Microsoft Teams Architecture

Microsoft Teams is a cloud-based unified communication and collaboration platform that combines persistent workplace chat, video meetings, file storage (including collaboration on files), and application integration into a single workspace. The Teams service integrates with the company's Microsoft 365 subscription office productivity suite, previously known as Office 365, and features additional extensions that can integrate with non-Microsoft products. In order to effectively monitor a SaaS collaboration solution like Microsoft Teams, it is important to understand its architecture: where and how the services are hosted, and how your users reach those locations.

Microsoft Teams is designed to provide a reliable and scalable platform for global collaboration. The solution is:

  • Based on identities stored in Azure Active Directory (Azure AD) and provides users with access to critical services, such as chat, video conferencing, and file sharing, regardless of their location in the world.

One of the key technologies is front-end optimization, which places servers as close to users as possible. This helps to reduce latency and improve performance. Microsoft Teams uses a global network of front-end servers to provide users with access to the service from all over the world.

Another key technology that Microsoft Teams uses is the Azure content delivery networks (CDNs) that are distributed around the world. Azure CDNs are used to cache static content, such as images, documents, CSS, and JavaScript files. This helps to improve performance and reduce bandwidth usage. Microsoft Teams uses Azure CDNs to deliver static and streaming content to users from the server that is closest to them.

In addition to front-end optimization and Azure CDNs, Microsoft Teams also uses several other technologies to ensure global access to critical services, such as:

  • Load balancing to distribute traffic across multiple servers, to improve performance and reliability.

  • Redundancy to ensure that critical services are always available. Microsoft Teams leverages multiple servers that can provide the same service so that if one server fails, the other servers can continue to provide the service.

  • Multi-geo capabilities that enable Microsoft Teams chat data to be stored at rest in a specified Macro Region Geography or Local Region Geography location. Chat data consists of chat messages, including private messages, channel messages, and images used in chats.

  1. A Microsoft Teams conference is hosted by Microsoft 365 in the same region where the first participant joined.

  2. Media traffic for peer-to-peer calls takes the most direct route that is available, assuming that the call doesn't mandate a media endpoint in the cloud (see #2 above). The preferred route is direct to the remote peer (client), but if that route isn't available, then one or more Transport Relays will relay traffic. It is recommended that media traffic should not be routed through packet shapers, VPN servers, and so on, since this will impact the media quality.

  3. Signaling traffic from the user always goes to the closest server.

Microsoft Teams Meeting and Call Flow for Internal Users One-on-One

The illustration below shows a one-to-one Microsoft Teams call flow for internal users who can connect directly.

  1. Teams User 1 sends a call invitation to Teams User 2 via Microsoft Teams

  2. Microsoft Teams notifies Teams User 2 of call invitation from Teams User 1

  3. The system attempts to connect Teams User 1 and Teams User 2 directly (detecting if it's possible)

  4. Direct connection prefers UDP for voice and video traffic, but will use TCP 443 as a fallback. This is also ThousandEyes' testing strategy, as it takes the same network path.

Microsoft Teams Meeting and Call Flow for Users Who Cannot Connect Directly

The illustration below shows an example for users who connect through a Microsoft Teams Transport Relay.

  1. Teams User 1 connects to Microsoft Teams (TCP/443) to send a call invitation to Teams User 2.

  2. Microsoft Teams notifies Teams User 2 of the call invitation from Teams User 1.

  3. Teams User 2 connects to Microsoft Teams (TCP/443) and answers the call invitation.

  4. The client for Teams Users 1 and 2 detects that a direct connection is not possible, and connects using the Microsoft Teams Transport Relay.

  5. Conversation starts between Teams User 1 and Teams User 2 using the Transport Relay. It will prefer UDP for voice and video traffic, but will fall back to TCP 443 (which is ThousandEyes' testing strategy).

In order to provide high-quality, low-latency connectivity to achieve the best call quality within Microsoft Teams, Microsoft recommends that you:

  • Bypass devices that affect latency, such as proxies and DPI.

  • Use the path to the Microsoft edge closest to your network.

  • Use UDP for voice and video traffic as preferred, but fall back to TCP 443 - which is the same as the ThousandEyes testing strategy, since the network traffic will take the same path.

  • Ensure that DNS resolves in the local network.

  • Measure and calculate delay, loss, jitter, and required bandwidth to Microsoft 365 in advance.

The illustrations above show the sequence of how users connect for a Microsoft Teams call. The two illustrations below show the two prevailing enterprise network architectures.

On the left, branch offices must backhaul through a central internet egress point at the head office, leading to a worse user experience because traffic is not routed to the nearest Microsoft Teams front door for all users. On the right, branch offices have local internet breakout, and can directly reach the nearest Microsoft Teams service front door.

The primary region will be based on where the initial user initiates the Microsoft Teams meeting.

Monitoring Microsoft Teams with Cloud and Enterprise Agents

To monitor Microsoft Teams, use ThousandEyes Enterprise Agents from within your own secure networks, and use ThousandEyes Cloud Agents to monitor from outside of your own networks. This section includes: where to locate your ThousandEyes agents, Microsoft's network performance requirements, and what to test from each vantage point.

Network Performance Requirements Edge-to-Edge

To ensure a good meeting and collaboration experience for your users, connectivity between your company’s own network edge and the Microsoft network edge must meet the network performance requirements and thresholds shown in the table below. The ThousandEyes tests that will be set up using the Microsoft Teams template will provide you with an easy way to visualize the network performance and quickly isolate issues, whether it’s an internal issue, external ISP problem, or Microsoft’s network.

See these additional resources for more information:

Metric

Target

Latency (one way)

< 30ms

Latency (RTT)

< 60ms

Burst packet loss

<1% during any 200 ms interval

Packet loss

<0.1% during any 15s interval

Packet inter-arrival jitter

<0.01% out-of-order packets

Agent Placement and Selection

Use ThousandEyes Enterprise Agents to proactively monitor your Microsoft Teams collaboration experience from vantage points within your enterprise WAN. This is known as “inside-out” testing.

  • At a minimum, place an Enterprise Agent at each internet egress point.

  • For hub-and-spoke network architectures with centralized egress, the recommended best practice is to also test from Enterprise Agents at each “spoke” user location. Spokes are typically branch offices.

  • Enterprise Agents are used to monitor DNS resolution (either internal resolvers or public resolvers), and to monitor Microsoft Teams application performance.

Enterprise Agents are required in 8 of the 14 tests included in the Microsoft Teams test template. If you want to deploy the Microsoft Teams test template without any Enterprise Agents, you must:

  • Select any Cloud Agent in the Which Enterprise Agents should we run tests from? agent selector.

    The template requires that all user input fields be filled. If you disable all the "Internal" tests, you must nevertheless make a selection in the Which Enterprise Agents field. Your selection will not be used in any of the deployed tests; it is only required because of user input validation.

Use ThousandEyes Cloud Agents in order to:

  • Monitor public DNS infrastructure and Microsoft’s authoritative nameservers.

  • Establish a baseline for web application performance outside of the enterprise network.

It is recommended that you select at least one Cloud Agent for each region where you have an internet egress and an Enterprise Agent. Additionally, Cloud Agents can be added based on where you have a concentration of users connecting to Microsoft Teams. These Cloud Agents provide an external baseline.

Note on Proxies

Microsoft Teams Test Template

ThousandEyes provides a single test template that includes Cloud and Enterprise Agent tests for comprehensive monitoring of the following Microsoft Teams critical services:

  • Microsoft Teams Relay

  • The Microsoft Teams application portal

  • The Microsoft online login service (a common shared service)

Included Tests

There are four types of ThousandEyes test included in the Microsoft Teams test template. The tests leverage Cloud Agents (marked “external” in the template) and Enterprise Agents (marked “internal” in the template):

  • HTTP server tests run from both ThousandEyes Enterprise Agents and Cloud Agents. HTTP server tests are used to monitor the performance, reachability, and availability of the Microsoft Teams landing page and Microsoft login site. The test template includes Enterprise Agents tests and a separate set of tests sourced from the selected Cloud Agents and targeting the following sites:

    • https://teams.microsoft.com

    • https://login.microsoftonline.com

  • Network agent-to-server tests run from both ThousandEyes Enterprise Agents and Cloud Agents. These tests are used to monitor the Microsoft Teams Transport Relay. If you have QoS enabled for Microsoft Teams, the tests for audio and video are preconfigured with the appropriate DSCP settings and should be enabled. This will show where in your network DSCP values are not being honored or where they get changed. Otherwise, you can use a single network test which will be applied to your Enterprise Agents (“internal”). There is also a network test that is applied to Cloud Agents (“exernal”) so you can quickly see if the issue is internal versus external. The following endpoint is the test target for the Microsoft Teams Transport Relay:

    • worldaz.tr.teams.microsoft.com

  • DNS server tests run from ThousandEyes Enterprise Agents (“internal”). These tests monitor network connectivity to your DNS recursive resolvers (public or internal) and DNS resolution performance. The following domains are included in the test template to ensure the health of DNS for the Microsoft Teams service:

    • teams.microsoft.com

    • login.microsoftonline.com

    • worldaz.tr.teams.microsoft.com

  • DNS trace tests run from ThousandEyes Cloud Agents (“external”). DNS trace tests monitor the DNS from the root nameservers, through the top-level domain (TLD) nameservers, and down to the Microsoft Teams authoritative nameservers. The following domains are included in the test template:

    • teams.microsoft.com

    • login.microsoftonline.com

    • worldaz.tr.teams.microsoft.com

Monitoring DNS in addition to HTTP for application availability and performance is crucial because DNS is critical for translating domain names to IP addresses. Any issues or delays in DNS resolution can significantly impact the accessibility and performance of a web application, even if the HTTP service itself is functioning properly. DNS is especially important for Microsoft Teams due to the large anycast DNS architecture, the use of low time-to-live values (i.e, minimal caching and frequent lookups), and because DNS is used to direct users to the best service front door.

Note that the Microsoft Teams test template includes two HTTP server tests for each of the target services: one HTTP server test is sourced from Enterprise Agents (the “internal” tests) and a second HTTP server test sourced from Cloud Agents (the “external” tests).

This configuration consumes the same number of units as if the HTTP server tests were combined into a single test from both types of agent. However, it is more flexible in terms of visualizing the data in dashboards and test views, and for fine-tuning alert rules. For example, you may decide to disable alert rules for the tests that only run from external vantage points and only treat alerts from internal vantage points as actionable.

A high-level diagram is shown for each of these test types below, in the next section. When you deploy the test template, you will have the opportunity to deselect any of the tests you do not want to include in your Microsoft Teams test suite.

HTTP Server Test Deployment

The diagram below shows HTTP server testing from Cloud Agents and Enterprise Agents. As described previously, Enterprise Agents should be placed at each internet egress point – in the diagram below, this includes the branch office shown at the top, and the head office. If any branch offices do not have direct internet egress and instead backhaul through an enterprise WAN, Enterprise Agents should also be deployed at the branch office location if possible. The Enterprise Agent HTTP server tests monitor each site’s network path and quality to the Microsoft Teams service front doors, Microsoft Login application performance, and availability metrics.

The Cloud Agent HTTP server tests provide a baseline and reference point to complement your own Enterprise Agent tests. The combined visibility of internal and external vantage points allows you to quickly and easily identify the scope of any issues, such as:

  • Issues solely within your enterprise network or network edge (e.g., one or more Enterprise Agents affected, no Cloud Agents affected)

  • Issues within regional transit providers (e.g., multiple Enterprise Agents and Cloud Agents affected within a particular region or ISP)

  • Issues within Microsoft Teams itself (e.g., all Enterprise Agents and Cloud Agents affected, either within a region or globally)

Network Agent to Server Test Deployment

As described previously, Enterprise Agents should be placed at each internet egress point – in the diagram below, this includes the branch office shown at the top, and the head office. If any branch offices do not have direct internet egress and instead backhaul through an enterprise WAN, Enterprise Agents should also be deployed at the branch office location if possible. The Enterprise Agent network agent-to-server tests monitor each site’s network path and quality to the Microsoft Teams Transport Relay service front doors.

DNS Server Test Deployment

The diagram below shows DNS server testing from Enterprise Agents. When your users try to access Microsoft Teams, their device must be able to resolve the hostname (e.g, teams.microsoft.com) to the IP address for the service front door. There are three critical components to this operation:

  • The device’s configured DNS resolver

  • The public DNS infrastructure (including root nameservers and top-level domain nameservers)

  • The authoritative nameservers for Microsoft Teams

The purpose of the DNS server tests from your Enterprise Agents is to monitor your own organization’s DNS resolvers.

Your organization may use internal DNS resolvers or public DNS resolvers, or sometimes both. Common public DNS resolvers include Google DNS, Cloudflare DNS, Quad9, and Cisco Umbrella (formerly OpenDNS). To deploy the Microsoft Teams test template, you will need to know the IP addresses or hostnames of the DNS resolvers that your organization uses. If you do not know your organization’s DNS resolvers, you should ask your network team or DNS team, if your organization has one.

In this template, DNS server tests are only run from Enterprise Agents to accommodate use cases where none of your resolvers are public and are therefore unreachable from Cloud Agents.

If your organization uses public DNS resolvers, you may add Cloud Agents to the DNS server tests from the Cloud & Enterprise Agents > Test Settings page after you deploy the template.

DNS Trace Test Deployment

Using the Microsoft Teams Template

Now that we've discussed all the tests, agents, and targets in the ThousandEyes Microsoft Teams test template, we are ready to use this template to deploy our tests.

To begin deploying a template:

  1. In the dropdown menu, click Add From Template.

The Deploy Template dialog opens. At the top of the Deploy Template dialog:

  1. Type “Microsoft Teams” in the Search box to filter the list of available templates

  2. Click the Microsoft Teams template in the list to proceed to configure the tests

After clicking the Microsoft Teams template, the dialog moves forward to Step 2 of 3 - Configure tests and shows the template’s Global Settings. This test template requires you to:

  • Select the Enterprise Agents for the internal tests

  • Select the Cloud Agents for the external tests

  • Select a testing interval (recommended: 1 or 2 minutes, no greater than 5 minutes)

  • Enter your DNS resolvers, see note below

  • Provide a name for your test suite to easily identify which tests were deployed from this template. This name is arbitrary, but note that:

    • The name will be prefixed to all of the tests’ names, and long names may be harder to discern or distinguish in dashboards and test views

    • A label will be created with this same name and applied to all the tests

Note on Entering DNS Resolvers

By default, the template will automatically look up the authoritative DNS servers for the Microsoft Teams targets. As described above, the DNS server tests are intended to monitor your DNS resolvers, not the authoritative nameservers (DNS trace tests are used for that instead).

To enter your DNS resolvers, first click the “x” at the right side of the DNS resolvers input field to clear the servers that were automatically identified.

Next, place your cursor in the text input field and type the IP address or hostname of your DNS resolver, and press your enter key. Repeat for each of your DNS resolvers.

Excluding Tests from the Template Deployment

Before proceeding to review your template deployment, you may want or need to exclude some of the tests in the template from the deployment.

By default all tests will be enabled. If you do not have any Enterprise Agents deployed, you must exclude the "Internal" tests. To exclude a test, click the toggle switch next to the test’s name.

Once you have provided the necessary details in the template’s Global Settings, you should be able to proceed to review the template deployment by clicking the Review button.

The deployment process may take a few minutes to complete. When it has finished, the dialog shows a success message and includes two links:

  • Clicking Go to Test Settings will navigate to the Cloud & Enterprise Agents > Test Settings page, filtered to show only the tests included in this deployment

  • Clicking Go to Dashboards will navigate to the dashboard created by the template

Microsoft Teams Health Dashboard

This section describes the dashboard that is included in the Microsoft Teams test template. The dashboard is designed with the highest-level information shown at the top, with increasing service granularity in the widgets as you navigate down the page.

Microsoft Teams Health Overview - By Service

This dashboard provides a service-oriented health overview for Microsoft Teams. The widgets in this dashboard are primarily grouped by service, highlighting issues that affect one or more of the individual Microsoft Teams services.

The first three rows of the service-oriented dashboard show alerts activity, web app health summary, and network health summary, aggregated for all Microsoft Teams tests in your deployment. This top third of the dashboard, shown in the image above, is intended as a default "NOC view" from which you can easily glean the health status of Microsoft Teams overall.

When Microsoft Teams is healthy, expect to see No Alert Activity in the alerts widget, and green number cards in the web app health and network app health widgets. When problems arise, alerts will show in the alerts widget, and the web app health and network app health widgets will change from green to yellow to orange to red, depending on the scope and severity of the performance degradation.

Enterprise agents provide an internal vantage point of Microsoft Teams and the map view, shown above, helps isolate where users are having high latency resulting in audio, video and screen sharing delays.

The middle section of the service-oriented dashboard, shown above, begins to break down the metrics and groups them by Microsoft Teams services, such as the landing page for meetings, Microsoft Login, and Transport Relay. This allows you to easily see if user experience for an individual service is impacted. Additionally, each row in this section contains two columns:

  • On the left, the widgets are filtered to show data from Enterprise Agents, i.e, tests run from within your environment

  • On the right, the widgets are filtered to show data from Cloud Agents, i.e, tests run from outside your environment

This allows you to quickly compare the experience from your enterprise network versus the baseline from external vantage points.

The bottom widgets of the service-oriented dashboard shows each of your Microsoft Teams tests, along with their current alert status, the most recent test measurements, and the trends of those measurements over the last 12 hours. You can click on any of the tests in this list to open the test view. The test widgets are filtered based on internal versus external tests to provide a quick visual of the service health and baseline.

Monitoring Microsoft Teams with Endpoint Agents

In addition to the Cloud and Enterprise Agent test template described above, you can use ThousandEyes Endpoint Agents for real user monitoring of Microsoft Teams combined with scheduled synthetic testing for proactive monitoring. ThousandEyes recommends the following synthetic tests and real user tests described below.

Synthetic Tests

Synthetic tests are a combination of scheduled and dynamic tests designed for end-user monitoring to gain visibility into the user experience.

The Endpoint Agents run tests at set times without needing user input. This helps with troubleshooting. The dynamic test allows the Endpoint Agent to monitor and identify the changing network connections between a user's Microsoft Teams application and the destination node (host server). This gives detailed network information to help find and fix issues. The tests are based on the destination used for the Microsoft Teams meeting and are stopped when the session ends.

Configure Synthetic Tests

You must have the Edit endpoint tests permission to configure synthetic tests.

ThousandEyes provides a pre-defined (but customizable) synthetic test template for Microsoft Teams comprising the required tests configured with the options and values making it efficient and easier to deploy.

To configure the synthetic test:

  1. Click the Monitor Application button and select the Microsoft Teams template.

  1. Click Review to review the test configuration.

  2. After reviewing the test configuration, click Deploy Now to monitor Microsoft Teams.

Real-User Tests

Configure real-user monitoring for Microsoft Teams by including the most important domains in the monitored domain set for your Endpoint Agents. Real-user tests provide detailed session information when users navigate their web browser to the associated monitored domain including page load elements, detailed endpoint information, and network statistics. ThousandEyes recommends including the following Microsoft Teams Monitored Domain Set in your real-user test configuration:

Microsoft Teams Monitored Domain Set:

  • teams.microsoft.com

  • microsoftonline.com

  • msidentity.com

  • msftidentity.com

The Edit endpoint agent monitored domain sets permission is required to configure real user tests.

Configure the real-user test Monitored Domain Set as described in the steps below:

  1. Click Add New Monitored Domain Set.

  2. Configure the basic settings for the session.

  3. Add the domains above to the Monitored Domains input field (Note: You must enter each domain one at a time, you cannot copy and paste the full list)

    • teams.microsoft.com

    • microsoftonline.com

    • msidentity.com

    • msftidentity.com

  4. Agents select All agents, Specific agents or use Agent labels (ThousandEyes recommends selecting All agents unless you have a specific use case)

  5. Click Add New Monitored Domain Set to save so that the selected agents will monitor the domains

The browser plugin must be installed and active for the ThousandEyes Endpoint Agent to capture browser statistics.

Monitoring Microsoft Teams with Internet Insights

When a critical service is disrupted, it's common to wonder if you're the only one affected by the outage or if the issue is larger in scope or scale. Internet Insights collects data from a diverse set of vantage points across the globe to offer visibility into service providers, including Azure and Microsoft Teams. Internet Insights is built upon ThousandEyes’ collective data set -- billions of probes across the Internet to websites, apps, and API endpoints every day -- combined with outage detection to provide a macro-scale view into network and application outages. The intelligence derived from this data enables operations teams to quickly identify and resolve issues with providers using concrete Internet telemetry data.

ThousandEyes recommends selecting the following packages in your Internet Insights Catalog Settings configuration to enable you to understand if these services are affected by disruptions.

Package Selection

  • SaaS package in each region from which your users work (for example, “North America SaaS Providers”), which includes:

    • Microsoft

    • Microsoft Online

    • Microsoft 365

  • UCaaS package in each region from which your users work (for example, “North America SaaS Providers”), which includes:

    • Microsoft Teams

  • IaaS package in each region from which your users work (for example, “North America IaaS Providers”), which includes:

    • Azure

Internet Insights packages are a pre-set collection of service providers categorized by geographic region and provider type. Here, we recommend the selection of the “SaaS” and “UCaaS” packages because they identify application outages with Microsoft Teams and its common shared underlying services with Microsoft 365.

We also recommend the “IaaS” packages, because they identify application and network outages within Azure, upon which Microsoft Teams services are built and hosted.

If possible, all should be activated. However, if your licensed capacity limits you to choosing only one, we recommend the UCaaS and SaaS packages over the IaaS packages because they are more specific to Microsoft Teams.

To activate a package for Internet Insights when you have available licenses for it:

  1. Verify that the Available counter shows one or more licenses

  2. Find the row with the package that you want to add

  3. In the Included column, click the Active slider to add the package

To activate a package when you have no available licenses, you can purchase an additional license by contacting your customer success manager. Or, you can first deactivate a package, then activate the desired package in its place. To deactivate an Internet Insights package:

  1. Find the row with the package that you want to remove

  2. In the Included column, click the Active slider to remove the package

Microsoft 365, previously known as Office 365, is not included in this article. See our guide.

Built on Microsoft 365 groups, , and the same enterprise-level security, compliance, and manageability as the rest of Microsoft 365.

Hosted on Azure virtual machines in and uses many features of Microsoft Azure.

to prioritize critical traffic, such as chat and video conferencing. This helps to ensure that users have a good experience with the service, even when there is high traffic on the network.

There are multiple domains and subnets associated with Microsoft Teams, all managed by Microsoft. The domain's authoritative name servers are hosted in Azure DNS. These name servers use an IP addressing scheme. Anycast networking allows DNS queries to automatically route to the “closest” name servers for the “best possible performance” as described in , but it doesn’t always work as intended when internet routing paths are suboptimal.

The answers supplied by the authoritative nameservers may also be anycast IP addresses – the regional authoritative nameserver may also respond with a unicast IP address within the same region, or within a different region. DNS resolution is a way Microsoft steers users to healthy service instances. Service health status can be viewed on the page.

These four general principles will help you understand :

A Microsoft Teams media endpoint in Microsoft 365 is used based on media-processing needs, and not based on call type. See and .

For more information on Microsoft’s recommendations, see .

Microsoft’s documentation provides more details on the network requirements.

Microsoft has a that can help with your network performance analysis.

, a private blog describing in detail the differences between the previous and current assessment tools.

In the default template configuration, you must have Enterprise Agents in order to deploy the Microsoft Teams test template. If you have not yet installed any Enterprise Agents, see the section of the Enterprise Agent documentation.

Exclude all of the "Internal" tests from the template, as described in section in later in this article.

Since Microsoft Teams media traffic is already encrypted, passing this traffic through a proxy server doesn't make the traffic any more secure. Proxies can cause performance problems with latency, incorrect traffic routing, and packet loss when Microsoft Teams traffic is routed through a proxy server. Microsoft recommends that Microsoft Teams traffic bypass any proxy server infrastructure, including SSL inspection. You can find more information in .

The Microsoft Teams template does not include site-to-site testing with Enterprise Agents using RTP or agent-to-agent UDP testing. But these could be used to provide more visibility into your internal network health and performance. Additionally, you could run agent-to-agent UDP tests from Enterprise Agents to the closest .

The HTTP server, network agent-to-server, and DNS server test types are multi-layer: they automatically include network tests towards their targets, measuring packet loss, latency, jitter, and identifying the network path. This is all in addition to the application metrics they collect. See for more information on test layers.

For more details on the metrics collected by HTTP server tests, see the HTTP Server section of .

The diagram below shows network agent-to-server tests, audio and video testing from Enterprise Agents. If you are not using , the audio and video tests can be disabled and a single network-to-agent Transport Relay test used instead. Cloud Agents are used for external testing but do not use the DSCP values, so there is just a single test.

The diagram below shows DNS trace testing from Cloud Agents. While the DNS server test described earlier monitors your DNS resolvers, the DNS trace test monitors the public DNS infrastructure and Microsoft Teams authoritative nameservers. See for information on why this test type is important.

Multiple permissions are required to view and deploy test templates. For the complete list, see the of the Test Templates article.

Navigate to the page.

Click the dropdown ()next to the Add New Test button.

If your organization uses the dedicated tests for Audio and Video (noted by 1 and 2 in the below image) have the associated DSCP settings configured and will be assigned to your deployed Enterprise Agents. These tests will provide visibility into your internal network and show if there are QoS related issues like DSCP being changed between hops. In this case you can toggle off the MS Teams - MS Teams TR - Internal test (as shown by 3 in the image below) since it does not have any DSCP settings associated with it. Conversely, if you are not using QoS then toggle off the Audio and Video tests (1 and 2) and only use the MS Teams - MS Teams TR - Internal test (3).

After clicking the Review button, the dialog moves forward to Step 3 of 3 - Review template and displays a summary of the tests, labels, and dashboards included in the deployment. Review the summary. There may be warnings () if labels or dashboards already exist from other templates being deployed previously. This is just a warning indicating the existing labels will be updated so the Microsoft Teams tests will show up in other service related dashboards. Click Deploy Now to deploy the monitoring suite The dialog updates to show the template is being generated and the tests, labels, and dashboards are being built, as shown in the image below.

All of the widgets in these dashboards allow you to drill down into the individual tests for complete details. Click on the widget, in this example Latency, to open the drilldown dialog, then select the test or tests to view, and click Open in Views. See for more information.

To learn more about modifying dashboards or adding additional data sources like Endpoint Agent metrics or Internet Insights, network or application outages, be sure to review the and the guides. The next sections cover how to set up tests using Endpoint Agents for an end user perspective followed by the Internet Insights section covering the catalogs for seeing when large scale Microsoft outages occur. These are not included in the default dashboard but can be easily added based on your requirements.

Navigate to the tab.

If required, edit the information for both tests under the Global Settings section. To learn more about configuring synthetic tests, see the article.

Navigate to the tab.

To learn more about real-user tests, see the article.

Go to screen and click the Packages tab

Go to screen and click the Packages tab

To learn more about Internet Insights, see the article and the of the documentation.

Naming and Navigation Menu changes - Summary List
getting-started guides
three types of ThousandEyes agent
Cloud and Enterprise Agents
Endpoint Agents
role-based access control
Usage-Based Billing
connectivity principles
Quality of service
ThousandEyes Learning Center
Monitoring Microsoft 365
Microsoft Graph
Microsoft datacenters
Traffic shaping
anycast
What is Azure DNS?
Azure Status
Microsoft Teams call flows
Proxy servers for Teams and Skype for Business Online
Media Quality and Network Connectivity Performance in Microsoft Teams
Network Assessment Tool
Teams Network Assessment Tool (July 2021 update)
Installing
Proxy servers for Teams and Skype for Business Online
Azure cloud agents
Test Type Layering
What Do Your Results Mean?
QoS for Microsoft Teams
DNS Trace Test
Prerequisites section
Network & App Synthetics > Test Settings
QoS with Microsoft Teams
Troubleshooting with Dashboard Drill Down
Getting Started with Dashboards
Customizing Your Dashboard
Endpoint Experience > Test Settings > Synthetic Tests
Configuration Options for Synthetic Tests
Endpoint Experience > Test Settings > Real User Tests
Real User Tests
Internet Insights > Catalog Settings
Internet Insights > Catalog Settings
Getting Started with Internet Insights
Internet Insights section
Microsoft Teams Meeting and Call Flow for Internal Users One-on-One
Microsoft Teams Meeting and Call Flow for Users Who Cannot Connect Directly
Excluding Tests from the Template Deployment
Using the Microsoft Teams Test Template