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
    • 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
  • Intel NUC
  • Hardware Requirements
  • Intel NUC 13th Generation
  • Intel NUC 12th Generation
  • Intel NUC 11th Generation
  • Intel NUC 10th Generation
  • Intel NUC 8th Generation - OBSOLETE
  • Intel NUC 6th and 7th Generations - OBSOLETE
  • Intel NUC 5th Generation - OBSOLETE
  • Installation Environment Requirements
  • Downloading the Installer
  • Writing the ISO Image to a USB Disk
  • Intel NUC BIOS
  • Installing Physical Appliance Software
  • Configuring the Enterprise Agent
  • Troubleshooting
  1. Product Documentation
  2. Global Vantage Points
  3. Enterprise Agents
  4. Installing
  5. Appliances

Installing a Physical Appliance

PreviousCustom Virtual AppliancesNextInstalling an Enterprise Agent on a Raspberry Pi Device

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 .

For customers requiring a turnkey solution, the ThousandEyes can be installed on off-the-shelf hardware such as

  • Intel NUC

  • Raspberry Pi

    For Raspberry Pi-specific instructions, see .

The combination provides a convenient form-factor that is easily shipped to branch offices, partner sites, and other environments, where provisioning only requires power and a network connection. A downloadable ISO image is used to install Linux Ubuntu LTS, the ThousandEyes Enterprise Agent, and management software onto the hardware.

Intel NUC

This article details the hardware requirements and process required to install the ThousandEyes Enterprise Agent on an Intel NUC.

Hardware Requirements

Intel NUC 13th Generation

Subsystem
Manufacturer
Component
Validated Models

NUC

Intel

NUC i7 NUC i5 NUC i3

RNUC13ANHI70000

Part Numbers
Memory
Disk

NUC13*

For detailed specifications and compatibility matrices for Intel- and manufacturer-validated compatible components, see the links below:

  • RNUC13ANHI70000: /

Intel NUC 12th Generation

Subsystem
Manufacturer
Component
Validated Models

NUC

Intel

NUC i7 NUC i5 NUC i3

NUC12WSHi5

Part Numbers
Memory
Disk

NUC12*

For detailed specifications and compatibility matrices for Intel- and manufacturer-validated compatible components, see the links below:

Intel NUC 11th Generation

Subsystem
Manufacturer
Component
Part Numbers

NUC

Intel

NUC i7 NUC i5 NUC i3

NUC11TNHi3, NUC11TNHi5, NUC11TNHi7, NUC11TNHv5, NUC11TNHv7, NUC11TNKi3, NUC11TNKi5, NUC11TNKi7, NUC11TNKv5, NUC11TNKv7

Part Numbers
Memory
Disk

NUC11*

For detailed specifications and compatibility matrices for Intel- and manufacturer-validated compatible components, see the links below:

Intel NUC 10th Generation

Subsystem
Manufacturer
Component
Part Numbers

NUC

Intel

NUC i7 NUC i5 NUC i3

NUC10i7FNH, NUC10i7FNK, NUC10i5FNH, NUC10i5FNK, NUC10i3FNH, NUC10i3FNK, BXNUC10i5FNH1, BXNUC10i3FNH1, BXNUC10i7FNH1

Part Numbers
Memory
Disk

NUC10i*

BXNUC10i*

Crucial: 4GB DDR4-2400 SODIMM 1.2V CT4G4SFS824A

Transcend SSD370S SSD

Specifications and compatibility matrices for Intel- and manufacturer-validated compatible components:

Intel NUC 8th Generation - OBSOLETE

NOTICE: Intel NUC 8th generation systems are only supported for existing deployments.

Subsystem
Manufacturer
Component
Part Numbers

NUC

Intel

NUC i7 NUC i5 NUC i3

NUC8I7BEH, NUC8I5BEH, NUC8I5BEK, NUC8I3BEH, NUC8I3BEK

Memory
Disk

Specifications and compatibility matrices for Intel- and manufacturer-validated compatible components:

Intel NUC 6th and 7th Generations - OBSOLETE

NOTICE: Intel NUC systems of 6th and 7th generations are only supported for existing deployments.

Manufacturer
Component
Part Number

Intel

NUC i3 NUC i5 NUC i7

NUC6I3SYH,NUC6I3SYK,NUC7I3BNH,NUC7I3BNK NUC6i5SYH,NUC6i5SYK,NUC7I5BNH,NUC7I5BNK NUC6I7SYH,NUC7I7BNH

Crucial

4GB DDR4 2400 MT/S (PC4-19200) SODIMM

CT4G4SFS824A

Transcend

64GB SATA III 6 Gb/s M.2 SSD

MTS800

Intel NUC 5th Generation - OBSOLETE

NOTICE: Intel NUC systems of 5th generation are are only supported for existing deployments.

Manufacturer
Component
Part Number

Intel

NUC i3 NUC i5 NUC i7

NUC5I3RYK, NUC5I3RYH NUC5i5RYK, NUC5i5RYH NUC5I7RYK

Crucial

4GB DDR3 PC3-12800 SODIMM

CT51264BF160B

Transcend

64GB SATA III 6 Gb/s M.2 SSD

MTS800

Installation Environment Requirements

The following are required:

  • Wired network connection: The device has to be connected to a network. Wireless connection are not supported.

    Note: When the NUC is powered off and it is connected to an operational Ethernet switch, the LED on lower right of the RJ-45 port on the NUC will be lit. This indicates that a Link signal from the switch is active.

  • DHCP service: A DHCP service for the device to obtain an IP address.

  • DNS service: DHCP service must provide DNS server information to the device.

The Troubleshooting section below lists common issues and their resolution.

Downloading the Installer

Download the installer that fits the requirement:

  • Generic Appliance. There are no pre-configurations.

  • Custom Appliance. Includes Enterprise Agent pre-configurations.

Generic Appliance

On the ThousandEyes platform, go to Network & App Synthetics > Agent Settings, select Enterprise Agents (top line), click Add New Enterprise Agent button. Select Package Type Appliance. On Physical Appliance Installer click Download - ISO.

Custom Appliance

On the ThousandEyes platform, go to Cloud & Enterprise Agents> Agent Settings, select Enterprise Agents (top line), click Add New Enterprise Agent. Select Package Type Custom Appliance. Provide the following information:

  • Appliance Name. Name of the appliance on the ThousandEyes systems and the Linux host name.

  • Appliance Type, select Physical.

  • If required, select Add Proxy and specify the Proxy Host and Proxy Port.

  • Web Server. If the appliance is to be used for Page Load or Transaction test, select On.

  • SSH Keys. The SSH Public key of the SSH client to be used to access the appliance, for terminal session.

Writing the ISO Image to a USB Disk

The ISO image can be copied to a USB disk (flash drive) and used as a bootable media on the Intel NUC. The following sections describe the process of creating the bootable USB disk on Mac OS X and Windows.

Mac OS X / Linux Instructions

  1. Insert a USB disk that is at least 1GB in size, into a USB port on the Mac. The disk’s content will be overwritten.

  2. Open a terminal window.

  3. Type diskutil list (OS X) or fdisk -l (Linux) and identify the physical disk you’re interested in imaging. It should be /dev/diskN (OS X) or /dev/sdN (Linux). In the example below, I have a 1GB USB disk in my Mac's USB port:

    dave@schadenfreude ~/Downloads> diskutil list
    /dev/disk0 (internal, physical):
       #:                       TYPE NAME                    SIZE       IDENTIFIER
       0:      GUID_partition_scheme                        *500.3 GB   disk0
       1:                        EFI EFI                     209.7 MB   disk0s1
       2:          Apple_CoreStorage Macintosh HD            499.4 GB   disk0s2
       3:                 Apple_Boot Recovery HD             650.0 MB   disk0s3
    /dev/disk1 (internal, virtual):
       #:                       TYPE NAME                    SIZE       IDENTIFIER
       0:                  Apple_HFS Macintosh HD           +499.1 GB   disk1
                                     Logical Volume on disk0s2
                                     DCA39E1F-1CB4-4386-8E67-0AD63B4A069D
                                     Unencrypted
    /dev/disk2 (external, physical):
       #:                       TYPE NAME                    SIZE       IDENTIFIER
       0:     FDisk_partition_scheme                        *1.0 GB     disk2
       1:             Windows_FAT_32 UBUNTU-SERV             1.0 GB     disk2s1
  4. Run diskutil unmountDisk /dev/diskN (OS X) or umount /dev/sdN (Linux) to unmount the device (replace N with the actual disk number from the output above):

    dave@schadenfreude ~/Downloads> diskutil unmountDisk /dev/disk2
    Unmount of all volumes on disk2 was successful
  5. Next, write the image to disk. Run sudo dd if=<path_to_downloaded_iso> of=/dev/diskN, wait until it completes:

    dave@schadenfreude ~/Downloads> sudo dd if=thousandeyes-pa-1.9.100.iso of=/dev/disk2
    1175552+0 records in
    1175552+0 records out
    601882624 bytes transferred in 267.718384 secs (2248193 bytes/sec)

Windows Instructions

The following instructions are based on Rufus, an open-source application for creating bootable USB flash drives.

  1. Start Rufus.

  2. Connect a USB drive that is at least 1GB in size. The disk’s content will be overwritten. If there is only one USB drive on the Windows system, Rufus automatically selects it and it will be displayed under Device. Otherwise, use the down-arrow to select the desired USB drive.

  1. Click SELECT and browse to select the downloaded ISO image. In the above screen shot, the filename of the selected image is "thousandeyes-pa-0.162.iso."

  2. The screenshot above shows the default settings; they can be left as is. Note that the Cluster size default will vary depending on the size of the USB drive. Leave it to the selected default size.

  3. Click START.

  1. On the next screen, select Write DD Image mode and click OK. DD Image Mode is the recommended format.

  1. Click OK to start the boot disk creation.

  2. When the process completes, remove the USB drive.

Intel NUC BIOS

The following are intended to be a check list of configurations required for the ThousandEyes application. You should consult the appropriate Intel documentation for the applicable procedures.

  • Check that the display (monitor) used with the NUC are compatible. Check on the Intel documentation. To verify, power up the NUC with the monitor connected, if the Intel splash screen can be seen, the monitor is compatible.

  • On the NUC, check that the BIOS version is current. If not the most current, upgrade to the latest version.

  • The appliance is intended to the an always-on device. Verify that the following are set in the BIOS:

    • UEFI Boot Support should be disabled.

    • After Power Failure setting should be set to Last State or Power On.

Installing Physical Appliance Software

  1. Verify that the installation environment requirements are satisfied.

  2. Insert the bootable USB disk in one of the USB slots on the NUC.

  3. Power up the NUC.

  4. Tap the F10 key (on the keyboard) to force the BIOS to enter the "Boot" menu.

  5. On the boot device menu, use the arrow keys to select the USB drive and press Enter.

If USB is not shown as an option, power off the NUC, unplug the USB drive, plug it back in and power up the NUC.

Note: The BIOS will recognize the USB drive as a bootable device even if the USB flash drive is blank (nothing in it). If the BIOS does not recognize the USB drive as a valid bootable device, when there is a USB flash drive inserted, check that the BIOS version is current. If not current upgrade to the latest version.

  1. On booting from the USB drive, the installation process will start automatically. No user intervention is required, The initial phase will progress fairly quickly, a progress bar will narrate the progress. The final phase is shown by the "Finishing the installation" screen, "Running preseed," the progress bar will show "14%." The installation process are downloading the required software packages. This screen may remain in this state for about 15 minutes, depending on the speed of the network interface and the delays to the download server. Do not power off the NUC. Leave it until it automatically powers off.

  2. On completing the installation, the NUC will automatically power off.

  3. Remove the installation USB.

    If you don't remove it once the installation is complete, the NUC attempts to boot again, restarting the installation process.

Configuring the Enterprise Agent

  1. Power on the NUC. After the unit boots, the "ThousandEyes Virtual Appliance" screen (shown below) will be displayed. The IP address displayed depends on the network environment of the NUC. Note the provided username and password.

  1. Using a browser, access the provided URL (IP address), and log in using the provided username and password.

  1. The user will be taken to the Appliance Access screen to change the default password.

  1. Skip this step if the installation is a Custom Appliance, as the Account Group Token is included in the image.

For a Generic Appliance installation, the Account Group Token is obtained on the ISO download screen on the ThousandEyes portal, by clicking "Show Account Group Token for Installation."

On the Agent screen, copy the Account Group Token to the field provided.

  1. Verify on the Status screen that all diagnostics are green. Follow up and correct any faults shown on the Status screen.

  1. If network related parameters were changed, for example disabling IP V6 support, reboot the Agent, through the GUI and verify that all the diagnostics are green.

  1. The Enterprise Agent should now appear in the Cloud & Enterprise Agents> Agent Settings> Enterprise Agents page of the ThousandEyes portal.

Troubleshooting

USB Drive Not Recognized as a Bootable Device

A USB drive is plugged in, tapping F10 at power-up, on the "Boot" BIOS screen, USB drive is not recognized as a bootable device.

Resolution: Disable UEFI boot support. Check that the BIOS version is current. If not current, upgrade to the latest version.

Malformed IP Address

Ubuntu installation fails with a "blue screen" showing "Malformed IP Address."

Resolution: Verify that the Ethernet connection to the NUC has a link signal. Verify that the Link LED on the RJ-45 port is lit. Verify that there is a DHCP server on the network (broadcast domain) that the NUC is connected to.

No Root File System Defined

Ubuntu installation fails with "No Root File System Defined" message. This situation can occur if USB devices are attached to the NUC via a USB hub.

Resolution: Do not use USB hub to connect keyboard and USB flash drive to the NUC.

"thousandeyes-va login:" Prompt Is Shown on the Screen

The expected blue "ThousandEyes Virtual Appliance" management screen is not displayed. Instead, a black screen with "thousandeyes-va login:" prompt is shown.

This is a symptom of an unsuccessful installation. The agent is missing the te-pa package which, in addition to the web admin interface, provides the physical console functionality.

Resolution: Components of the Virtual Agent are missing. Most likely caused by the lack of non-proxied and unrestricted access to the internet during the appliance installation. Reinstall the appliance in an environment that satisfies the requirements listed in the installation environment requirements.

Keyboard Not Working

When the installation completes, keypresses are not recognized.

Resolution: Most likely incomplete installation. Reinstall the appliance in an environment that satisfies the requirements listed in the installation environment requirements.

Do You Need Further Assistance?

Any memory configuration supported by the NUC.* A minimum of 2GB, as specified in .

Any single SSD or NVMe disk supported by the NUC*. A minimum of 20GB as specified in .

Any memory configuration supported by the NUC.* A minimum of 2GB, as specified in .

Any single SSD or NVMe disk supported by the NUC*. A minimum of 20GB as specified in .

NUC12WSHi5: /

Any memory configuration supported by the NUC.* A minimum of 2GB, as specified in .

Any single SSD or NVMe disk supported by the NUC*. A minimum of 20GB as specified in .

NUC11TNHi3: /

NUC11TNHi5: /

NUC11TNHi7: /

NUC11TNHv5: /

NUC11TNHv7: /

NUC11TNKi3: /

NUC11TNKi5: /

NUC11TNKi7: /

NUC11TNKv5: /

NUC11TNKv7: /

Any memory configuration supported by the NUC.* A minimum of 2GB, as specified in .

Any single SSD or NVMe disk supported by the NUC*. A minimum of 20GB as specified in .

NUC10i7FNH: ;

NUC10i7FNK: ;

NUC10i5FNH: ;

NUC10i5FNK: ;

NUC10i3FNH: ;

NUC10i3FNK: ;

Any memory configuration supported by the NUC.* A minimum of 2GB, as specified in .

Any single SSD or NVMe disk supported by the NUC*. A minimum of 20GB as specified in .

NUC8I7BEH: ;

NUC8I5BEH: ;

NUC8I5BEK: ;

NUC8I3BEH: ;

NUC8I3BEK: ;

Memory:

Disk: M.2 NVMe and M.2 SSD

Non-proxied and unrestricted access to the Internet: The installation process downloads several software packages from online resources. Consult for the list of online locations.

Note that the custom download will include the required for the Agent to register itself to the ThousandEyes system. Click Generate. It may take take between 15 and 30 minutes to generate the image. An email will be generated once the image is ready to be downloaded.

A copy of Rufus can be obtained from .

Intel documentation can be found .

BIOS update files for the Intel NUC can be found .

See for a comprehensive set of instructions. The following are the minimum required to enable the Physical Agent to communicate with the ThousandEyes platform.

For information on the other parameters, see .

For further assistance, contact .

Naming and Navigation Menu changes - Summary List
Enterprise Agent
this article
Specifications
Compatibility Matrix
Specifications
Compatibility Matrix
Specification
Configuration matrix
Specification
Configuration Matrix
Specification
Configuration matrix
Specification
Configuration matrix
Specification
Configuration matrix
Specification
Configuration matrix
Specification
Configuration matrix
Specification
Configuration matrix
Specification
Configuration matrix
Specification
Configuration matrix
Specification
Component compatibility matrix
Specification
Component compatibility matrix
Specification
Component compatibility matrix
Specification
Component compatibility matrix
Specification
Component compatibility matrix
Specification
Component compatibility matrix
Specification
Component compatibility matrix
Specification
Component compatibility matrix
Specification
Component compatibility matrix
Specification
Component compatibility matrix
Specification
Component compatibility matrix
Vengeance® Series 16GB (2x8GB) DDR4 SODIMM 2400MHz CL16 Memory Kit CMSX16GX4M2A2400C16
Samsung 970 EVO 250GB (MZ-V7S250B/AM)
Transcend 64GB SATA III 6 Gb/s MTS800
Enterprise Agent Firewall Requirements
Account Group Token
here
here
here
How to Set Up the Virtual Appliance
How to Set Up the Virtual Appliance
the ThousandEyes Customer Engineering team
Enterprise Agent Hardware Requirements
Enterprise Agent Hardware Requirements
Enterprise Agent Hardware Requirements
Enterprise Agent Hardware Requirements
Enterprise Agent Hardware Requirements
Enterprise Agent Hardware Requirements
Enterprise Agent Hardware Requirements
Enterprise Agent Hardware Requirements
Enterprise Agent Hardware Requirements
Enterprise Agent Hardware Requirements