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
  • Primary Section
  • Views List
  • Snapshot Selector
  • Test Selector
  • Global Filters
  • Timeline
  • Timeline Selector
  • Secondary Section
  • BSSID Table
  • Endpoint Table
  • Map
  • Network Topology
  • Overview
  • Pages
  • Path Visualization
  • Sessions
  • Table
  • Additional Information
  • User Experience Score
  1. Product Documentation
  2. Endpoint Experience
  3. Viewing Data

Endpoint Views Reference

PreviousEndpoint Agent ViewsNextTroubleshooting

Last updated 4 months ago

This article provides summary details about each of the available sections of the Endpoint Agent views.

Primary Section

The primary section is the top part of all Endpoint views, and is largely consistent across all of them.

The sections below detail the key pieces of this part of the view.

Views List

Available for the all views.

The Views List allows you to select between each of the Endpoint views:

  • Dynamic Tests

    • Network

  • Scheduled Tests

    • HTTP Server

    • Network

  • Real User Tests

    • Visited Pages

    • Network

  • Local Networks

    • Network Access

    • Wireless

Snapshot Selector

Available for the all views.

The Snapshot Selector is a drop-down menu of all saved Endpoint Agent snapshots. Snapshots can be searched for by name in the search bar, or by scrolling down the list and selecting the desired snapshot. Selecting a snapshot updates all of the views to focus on the data stored in the snapshot.

Test Selector

Available for the Scheduled Tests > HTTP Server, Scheduled Tests > Network, and Dynamic Tests > Network views.

The Test Selector is a drop-down menu of all available tests (including disabled tests). Users can see the current selected test, hide disabled tests, and search for other configured tests. The tests are broken up by type.

Global Filters

Available for the all views.

The Global Filters are a set of drop-down menus that allow users to drill down into the data presented in the corresponding view. These filters allow users to configure which agents they see data from, as well as specify details including which destinations, gateways, and VPN vendors to focus on.

Filter
Type of Filter
Description

Location

Agents

The geolocation of the Endpoint Agent, broken down into Country -> State -> City.

Connection

Agents

The type of network connection.

Network

Agents

The specific network the agent is connected to.

ASN

Agents

The autonomous system number (ASN) associated with the agent.

Monitored Network

Agents

The specific monitored network the agent is connected to.

Agent

Agents

Filter by a specific agent.

Agent Type

Agents

Filter by agent type (Endpoint Agent or Endpoint Agent Pulse).

User

Agents

Filter by session user.

Platform

Agents

Filter by Windows or Mac Endpoint Agents.

Label

Agents

Filter by Endpoint Agent label.

Metrics

Agents

This option allows users to configure the filter on any or all the agents with multiple metrics. Users can filter by Latency, Loss, Jitter, VPN Loss, and VPN Latency.

Domain

Destinations

The configured destination domain.

Visited Site

Destinations

Filter by the site visited in the session.

IP Address

Destinations

The destination IP address.

Gateway

Network

Filter by the network gateway IP address.

Proxy Address

Network

The proxy address used.

SSID

Network

Filter by the network's SSID.

BSSID

Network

Filter by the MAC address or BSSID.

DNS Server

Network

Filter by the DNS IP address.

Errors

Session

Filter sessions by error type.

VPN Vendor

VPN

Filter by supported VPN vendor.

VPN Gateway Address

VPN

Filter by the VPN's gateway IP address.

VPN Client Address

VPN

The VPN client's IP address.

VPN Client Network

VPN

The VPN client's network.

Timeline

Available for the all views.

The Timeline is the primary focus of all Endpoint views. It shows test data from the last 30 days, or the length of time the test has been enabled (whichever is the lesser value).

The data shown on the timeline can be manipulated in a number of ways:

  • By selecting the time range shortcuts (24h, 7d, 14d) in the top left corner of the timeline (to the left of the Metric Selector).

  • By clicking within the timeline to select a particular round of data.

  • By highlighting a range within the timeline.

  • By using the Time Range Selector, described below.

Selecting a round or a time range will result in all views and tabs being updated to focus on that selection. This allows users to drill down into the data to focus on specific moments and issues in order to determine the cause of events.

Timeline Selector

Available for the all views.

The Timeline Selector allows users to customize the window the Timeline focuses on, by moving the highlighted section to the desired date, and increasing/reducing the size of the highlighted time range as necessary.

This area of focus can be between 24 hours and 14 days long. In the example image above, the range is between June 19th and June 25th, with the selected round occurring on June 22nd.

Secondary Section

The sections below provide summary details of each of the dynamic tabs available for the various Endpoint views.

BSSID Table

Available for the Local Networks > Wireless view.

Metric
Description

BSSID

The base station ID (BSSID) or MAC address of the wireless access point serving the Endpoint Agent.

SSID

The service set identifier (SSID) of the wireless access point serving the Endpoint Agent.

Location

The location of the Endpoint Agent.

Number of Endpoints

The number of Endpoint Agents being served by the same wireless access point, determined by the number of agents with the same BSSID.

Phy Mode

Describes which IEEE 802.11 specification standard is being used for the wireless connection, related to coverage range and speed optimization.

Channel

The channel used for the wireless connection with the access point serving the Endpoint Agent.

Throughput

The throughput for wireless interfaces is the transmission rate expressed in Mbps.

Retransmission Rate (%)

The wireless transmission rate for Endpoint Agent experiences.

Signal Quality (%)

The signal quality of the wireless connection, displayed as a percentage. A value of 0% implies an actual received signal strength indicator (RSSI) signal strength of -100 dBm. A value of 100% implies an actual RSSI signal strength of -50 dBm.

Roaming Events

The number of times the wireless access point serving the Endpoint Agent changes, measured by the number of times the BSSID of the connected network changes.

Channel Swap Events

The number of times the wireless channel changed for the connected access point.

Endpoint Table

Available for the Local Networks > Wireless view.

Metric
Description

Agent

Endpoint Agent performing measurements.

Location

The location of the Endpoint Agent.

SSID

The service set identifier (SSID) of the wireless access point serving the Endpoint Agent.

BSSID

The base station ID (BSSID) or MAC address of the wireless access point serving the Endpoint Agent.

Roaming Events

The number of times the wireless access point serving the Endpoint Agent changes, measured by the number of times the BSSID of the connected network changes.

Phy Mode

Describes which IEEE 802.11 specification standard is being used for the wireless connection, related to coverage range and speed optimization.

Channel

The channel used for the wireless connection with the access point serving the Endpoint Agent.

Channel Swap Events

The number of times the wireless channel changed for the connected access point.

Transmit Rate (Mbps)

The Endpoint Agent host's transmission rate.

Signal Quality (%)

The signal quality of the wireless connection, displayed as a percentage. A value of 0% implies an actual received signal strength indicator (RSSI) signal strength of -100 dBm. A value of 100% implies an actual RSSI signal strength of -50 dBm.

Throughput

The throughput measured by the Endpoint Agent.

Retransmission Rate (%)

The wireless transmission rate for Endpoint Agent experiences.

Map

Available for the Scheduled Tests > HTTP Server, Scheduled Tests > Network, Dynamic Tests > Network, and Real User Tests > Network views.

The Map tab has two parts. On the left, the metrics for the selected round are shown. On the right, the geolocation of the Endpoint Agents is presented in a map view. The map is zoomable using the plus/minus icons on the right of the map, or by scrolling using a mouse.

The map shows metrics for the round currently selected on the Timeline. To navigate between rounds, select the left and right arrow buttons at the top right of the view, or click Latest to return to the most recent round of data.

Hovering your mouse cursor over one of the locations on the map will show a pop-up list of the agents at that location, and basic metric details. Clicking the Show only this agent link will focus the entire view (including the Timeline) on that agent in the selected round.

Network Topology

Available for the Local Networks > Network Access view.

The Network Topology tab displays how Endpoint Agents are connected to their gateways, proxies, DNS servers, and VPN terminators.

Overview

Available for the Real User Tests > Visited Pages view.

The Overview tab provides the average user experience score for the specified round of data, along with error, alert, and page speed data.

Pages

Available for the Real User Tests > Visited Pages view.

The Pages tab provides a tabulated view of all the visited sites for the specified round of data.

Click a visited site to access the same detailed view shown above.

The Page Details panel provides a more in-depth view of the details provided in the Pages tab. This panel is further divided into two sections:

  • Primary section

  • Secondary section

The primary section provides a graphical view of the network path towards the target site. In addition, it also provides the following Page Load details:

  • Response Time: Also known as time-to-first-byte, this is the time from the beginning of the request (before DNS request) until the client receives the first byte of the response from the web server.

  • Content Time: The time it takes (once the main request has started) for the browser to fully load the HTML and build the DOM tree. External resources like pictures and stylesheets might not be fully loaded now. The Content Time is calculated using the following formula: [Timestamp when the DOM finished building] - [Timestamp when the main request started]

  • Page Load Time: This maps to the load event triggered when the web page is fully loaded and initialized. Generally, the page load time is higher than the content time. The Page Load Time is calculated using the following formula: [Timestamp when the page, including the resources it refers to, is completely loaded and initialized] - [Timestamp when the main request started]

The secondary section provides additional agent and connection information broken into dynamic tabs based on the available data:

  • Computer Info: Provides information about the operating system, platform, OS version, browser details, network configuration (IP address, DNS servers), manufacturer, model, and memory information.

  • Wireless Info: Provides information on the Endpoint Agent's wireless connection, including signal quality, noise (only for macOS devices), and transmission rate.

  • Path Trace: A complete hop-by-hop path, with delay measured from the host machine running the Endpoint Agent to the targeted domain at each hop. The path trace is obtained using ICMP. Gateway and proxy nodes along the path are also shown.

  • Redirects: A list of all redirect URLs encountered along the path, and the time each took.

  • Waterfall: Provides detailed information about each object on the selected page, including object name, response code, domain, size, and the time taken to load the object.

Path Visualization

Available for the Scheduled Tests > Network, Dynamic Tests > Network, and Real User tests > Network views.

The Path Visualization tab provides a graphical view of the network path, hop-by-hop, towards the target site.

Grouping

The Grouping dropdown can be used to configure the grouping of agents in visualization:

* Agents: Group agents based on
  * Network: Aggregate paths based on agent network.
  * ASN: Aggregate paths based on each combination of an agents's autonomous system number (ASN).
  * Private Network: Aggregate paths based on each combination of an agent's network.
  * Location: Aggregate paths based on each combination of an agent's geographical location.
  * Country: Aggregate paths corresponding to a country.
  * Agent: Individual path for each agent is visualized.
* Interfaces: Group interfaces by
  * IP Address: Aggregate paths based on an interface IP addresses.
  * Network: Aggregate paths based on interface network.
  * Network & Location: Aggregate paths based on each combination of an interface's network and geographical location.
  * Location: Aggregate paths based on geographic location of interfaces.
  * ASN: Aggregate paths based on each combination of the interface's autonomous system number (ASN).

Sessions

Available for the Real User Tests > Visited Pages view.

The Sessions tab provides a tabulated view of all user sessions for the specified round of data. All pages visited within the session are grouped in this view.

To view detailed information about a user session, select the row in the table to open the panel.

The Session Details panel provides a more in-depth view of the details provided in the Sessions tab. This panel is further divided in two sections:

  • Primary section

  • Secondary section

The primary section provides a graphical view of the network path towards the target site. In addition, it also provides the following Page Load details:

  • Response Time: Also known as time-to-first-byte, this is the time from the beginning of the request (before DNS request) until the client receives the first byte of the response from the web server.

  • Content Time: The time it takes (once the main request has started) for the browser to fully load the HTML and build the DOM tree. External resources like pictures and stylesheets might not be fully loaded at this time. The Content Time is calculated using the following formula: [Timestamp when the DOM finished building] - [Timestamp when the main request started]

  • Page Load Time: This maps to the load event triggered when the web page is fully loaded and initialized. Generally, the page load time is higher than the content time. The Page Load Time is calculated using the following formula: [Timestamp when the page, including the resources it refers to, is completely loaded and initialized] - [Timestamp when the main request started]

The secondary section provides additional agent and connection information broken into dynamic tabs based on the available data:

  • Computer Info: Provides information about the operating system, platform, OS version, browser details, network configuration (IP address, DNS servers), manufacturer, model, and memory information.

  • Wireless Info: Provides infromation on the Endpoint Agent's wireless connection, including signal quality, noise, and transmission rate.

  • Path Trace: A complete hop-by-hop path, with delay measured at each hop from the host machine running the Endpoint Agent to the targeted domain. The path trace is obtained using ICMP. Gateway and proxy nodes along the path are also shown.

  • VPN: VPN details (if present), including hardware type, server/interface IP addresses, and DNS servers.

  • Redirects: A list of all redirect URLs encountered along the path, and the time each took.

  • Waterfall: Provides detailed infromation about each object on the selected page, including object name, response code, domain, size, and the time taken to load the object.

Table

Available for the Scheduled Tests > HTTP Server, Scheduled Tests > Network, Dynamic Tests > Network, Real User Tests > Network, and Local Networks > Network Access views.

The Table tab provides a breakdown of the metrics collected for the selected time interval.

Metric
Description

Agent

Endpoint Agent performing measurements.

Date

The time and date when the agent performed the last measurement.

Connection

The type of connection (for example, wireless, ethernet, and so on) on which the agent is deployed.

SSID

The service set identifier (SSID) of the wireless access point serving the Endpoint Agent.

Channel

The channel used for the wireless connection with the access point serving the Endpoint Agent.

Phy Mode

Describes which IEEE 802.11 specification standard is being used for the wireless connection, related to coverage range and speed optimization.

Packet Loss (%)

End-to-end packet loss. The percentage of packets lost is calculated by subtracting the number of reply packets the agent receives from the target (responses) from the number of packets sent by the agent, then dividing by the number of packets sent, then multiplying by 100.

Latency

The average of the round-trip packet time. Round-trip packet time is the time from which a packet is sent by the agent to the time the agent receives a reply.

Jitter

The mean deviation of latency. The mean deviation represents how far, on average, all measurements are from the mean of the data.

Error Details

The detailed explanation for the error in connection.

TCP Connect

Indicates if the agent was able to successfully establish the TCP connection.

Grouping within the Table

Available for the Dynamic Tests > Network view.

As a single Dynamic Test can target multiple different destinations (IP addresses) within the same test (for example, Webex), you can group the data in the table tab by Agent or by Agent and IP addresses to make it easier to identify the specific destinations affected by an incident.

Additional Information

User Experience Score

The experience score rates a user's experience when loading a particular page. The score is calculated based on the time to load the DOM of a page, which is then mapped to a score based on our data set of load times. A score of 100 is the top score, 0 is the lowest score. An average experience is in the range of 44 to 89. Average (mean) experience scores can be displayed by Endpoint Agent, or by domain of pages visited.

The ThousandEyes experience score is based on formulas and values that are not all visible in the product. Generally speaking, the score depends on a correlation function of page availability and content speed. While direct validation from the platform view is not fully realizable from the endpoint display, some quantities are shown in the platform view. A detailed break down is shown below.

Experience Score

The experience score (ES) is determined by the following formula:

ES = max( 0, PAS - (100 - SS) )

  • The max function is to ensure that the experience score (ES) is always limited between 0 and 100.

  • The above formula allows future adding (or subtracting to be more accurate) impedances to the metric based on other factors (other than speed).

  • The experience score is defined per page.

  • PAS = Page availability score.

  • SS = Speed score.

Page Availability Score

The page availability score (PAS) is a binary score indicating the presence of one of the following errors during page load:

  • The server did not respond in time.

  • A browser error prevented the page from loading.

  • The server responded with an error (HTTP response code 4xx or 5xx).

  • The server responded successfully (HTTP response code 200) but there was a browser error (e.g., loading an error page instead of the expected one).

  • Page load is successful otherwise.

If an error occurs, PAS = 0. Otherwise, PAS = 100.

This is irrespective of the speed of the page (the speed score). It also does not consider component errors, at least for now.

Speed Score

The speed score is determined by the formula below:

SS = min( 0, 1 - ( ( Content Time + Redirect Time - X ) / Y ) ) )

  • Content Time: Displayed in ms on the left side of the endpoint view.

  • Redirect Time: Displayed in ms on the left side of the endpoint view. If it is 0 it is not shown.

  • X and Y are based on the OnContentLoad time thresholds which are not visible in the display based on a linear correlation coefficient:

    Very Fast

    : OnContentLoad <= 1s

    → SS = 100

    → SS = 100

    Fast

    : 1s < OnContentLoad <= 2s

    → 89 <= SS < 100

    Average

    : 2s < OnContentLoad <= 6s

    → SS = 100-100*(CT-1)/(10-1)

    → 44 <= SS < 89

    Slow

    : 6s < OnContentLoad <= 10s

    → 0 < SS < 44

    Very Slow

    : 10s < OnContentLoad

    → SS = 0

    → SS = 0

For more information on snapshots, see .

For more information on how the user experience score is calculated, see below.

For more information on the path visualization, see .

Endpoint Agent Test Snapshots
Path Visualization
User Experience Score
Primary Section
Views List
Snapshot Selector
Test Selector
Global Filters
Timeline
Timeline Selector
HTTP server test map view
Network Test Map Tab with Highlighted Agent
Network Topology
Overview Tab
Pages Tab
Page Details
Path Visualization
Sessions Tab
Session Details
Table
Group By