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
  • Enterprise Agent Settings Screens
  • Finding a Supported Agent
  • Enabling Flow Forwarding
  • Viewing Your Forwarders
  • Device Layer Screens
  • Traffic Insights Settings Screens
  • Traffic Monitors Screen
  • Allow-Listing Your Flow Device
  • Managing Your Traffic Monitors
  • Forwarders Screen
  • Subnet Tagging Screen
  • Traffic Insights Views Screens
  • Views Landing Screen
  • Views Table
  • Alerts and Dashboards with Traffic Insights
  1. Product Documentation
  2. Traffic Insights

Traffic Insights Views and Settings

PreviousTraffic Insights Configuration GuideNextTraffic Insights FPS Monitoring

Last updated 5 hours ago

This section describes the screens in the ThousandEyes user interface that are used for various configuration steps and for viewing results. For information about the FPS (flow record per second) monitoring screen, see Traffic Insights FPS Monitoring.

Enterprise Agent Settings Screens

The following screens correspond to Step 1: Enable an Enterprise Agent of the Configuration Guide.

Finding a Supported Agent

Traffic Insights supports two kinds of Enterprise Agents as flow forwarders: those hosted on a virtual appliance, or the Cisco Application-Hosted Framework (CAF). See Flow Forwarder Requirements for more information and other Enterprise Agent requirements.

To check whether any of your existing Enterprise Agents are on a supported device, you can simply add a filter from the Enterprise Agent Settings screen.

  1. Go to Network & App Synthetics > Agent Settings.

  2. Select the Enterprise Agents screen.

  3. On the Agents tab, open the Add a Filter dropdown.

  4. Select Installation Type.

  5. In the subsequent filter dropdown, select Virtual Appliance and/or Cisco Application Hosting.

    • The list of agents automatically updates in line with the filters selected and the total appears to the right of the search field.

Though you may have Enterprise Agents on supported devices, you must still check that the supported devices meet all other compatibility requirements for Traffic Insights in order for flow forwarding to work. See Flow Forwarder Requirements.

If no existing Enterprise Agents are on supported devices, click Add New Enterprise Agent on the top right of the screen and follow the prompts within the relevant article in the Enterprise Agent Installing section.

Once you have identified or installed an Enterprise Agent on a supported device that meets Traffic Insights compatibility requirements, you can enable it for flow forwarding.

Enabling Flow Forwarding

The above Enterprise Agent settings screen corresponds to step 1.2 Enable Flow Forwarding on the Enterprise Agent of the Configuration Guide.

Turning on the Enterprise Agent’s flow forwarding capabilities is a necessary step to enable the agent to receive flow data from your flow exporter (traffic monitor) and forward this data to ThousandEyes.

  1. Go to Network & App Synthetics > Agent Settings.

  2. Click the Enterprise Agents screen.

  3. Select the agent you want to designate as a flow forwarder from the list to open the edit panel.

  4. Select the Advanced Settings tab.

  5. Scroll down to Agent Modules.

    1. The Traffic Insights status of this agent shows as either Enabled or Disabled.

  6. If it’s Disabled, click the Enable button and confirm.

  7. Click Save Changes.

Viewing Your Forwarders

Now that you have forwarding enabled for Traffic Insights, you can keep track of the Enterprise Agents you use for forwarding via another Enterprise Agent filter. Follow steps 1-4 in Finding a Supported Agent but select Traffic Insights as the filter. Then select Enabled. All devices enabled for Traffic Insights are displayed.

Alternatively, view them on the Traffic Insights Forwarders screen. See Forwarders Screen below.

Device Layer Screens

Step 2: Configure SNMP Device Discovery of the Configuration Guide requires you to discover and monitor the devices you will use as traffic monitors via SNMP. You can find instructions and relevant screens for this step in the Device Layer articles.

Traffic Insights Settings Screens

The Thousandeyes Traffic Insights screens cover allow-listing, forwarder enablement, and subnet tagging.

Traffic Monitors Screen

In Step 3: Configure Network Flow Data of the Configuration Guide, you set up network flows to transit through the devices you just discovered and monitored in step 2, and on to the forwarders you designated in step 1.

The following Traffic Insights Settings screens illustrate how to allow-list your new traffic monitors and configure the two optional settings: subnet tagging and external flow collecting.

Allow-Listing Your Flow Device

The above allow-list screen corresponds to 3.4 Allow-List the Flow Device in ThousandEyes of the Configuration Guide.

  1. Go to Traffic Insights > Settings.

    • The Traffic Monitors tab shows your network devices (traffic monitors) that have been successfully configured to export network flows.

  2. Allow-list your monitors in one of three ways:

    • To allow-list all monitors, click Allow All in the warning box at the top of the screen.

    • To allow-list a selection, check the boxes next to the monitors you want to allow and click Allow at the bottom of the screen.

    • To allow-list an individual monitor, click the ellipsis on an agent’s row, and select Allow.

Managing Your Traffic Monitors

Once allow-listed, view and manage your traffic monitors on the Traffic Monitors screen.

Columns:

  • Network Device IP: Identifies the network device that is acting as a traffic monitor and is already sending flow data to an Enterprise Agent.

  • Network Device Name: Optional field, if a device name was configured on the device itself and SNMP device discovery has been completed. See Device Layer Screens for more information.

  • Enterprise Agent: Enterprise Agent name as configured in ThousandEyes Agent Settings.

  • Site: Optional user-defined site name where this traffic monitor is located. Open each monitor's edit panel on the Traffic Monitor screen to edit.

  • Geo Location: Optional country and region where this traffic monitor is located. Defaults to the location of the forwarder the monitor exports to. Open each monitor's edit panel on the Traffic Monitor screen to edit.

  • Status: Either Allowed or Not Allowed.

  • Last Active (UTC): Date and time that this traffic monitor sent flow data to ThousandEyes.

  • FPS (Peak): Flow records per second sent from the traffic monitor that might be forwarded to ThousandEyes platform if allowed. Shows average and peak values.

  • Unsupported FPS (Peak): Flow records per second sent from the traffic monitor and discarded due to unsupported format. Shows average and peak values.

Forwarders Screen

The Forwarders screen lists the Enterprise Agents you have enabled for flow forwarding. You can find instructions on how to install and enable Enterprise Agents at Enterprise Agents Settings Screens. Below, we explain how to view and manage your forwarders.

The Forwarders screen shows traffic flowing through each Enterprise Agent in the time frame chosen.

Columns:

  • Agent Name: The ThousandEyes Enterprise Agent name.

  • Listening Ports: TCP and UDP listening ports, editable on the Edit screen.

  • External Collector: Optional; enable on the Edit screen.

  • UDP Ingress: Kbps and packets per second.

  • TCP Ingress: Kbps and packets per second.

  • Dropped Events: Number of dropped packet(s).

  • Egress: Kbps.

  • External Collector Mirrored: Kbps.

  • FPS (Peak): Flow records per second received by the agent and forwarded to ThousandEyes platform. Shows average and peak values.

  • Unsupported FPS (Peak): Flow records per second received by the agent and discarded due to unsupported format. Shows average and peak values.

External Flow Collector Screens

If you already collect flow data into a collector, you can add an external flow collector to the ThousandEyes flow process via the External Collector Management panel and Edit panel of the Forwarders screen. These screens correspond to Configure External Flow Collectors in the Configuration Guide. You can also edit the listening ports for your forwarders via this screen.

External Collector Management Panel

  1. Go to Traffic Insights > Settings.

  2. Select the Forwarders screen.

  3. Click External Collector Management in the top right.

  4. In the panel, click + Add New External Collector.

  5. Enter the collector's name, IP address and port.

  6. Click Save.

Edit Forwarder Panel

  1. Go to Traffic Insights > Settings.

  2. Select the Forwarders screen.

  3. On your chosen forwarder, click the ellipsis and select Edit.

  4. In the edit panel, change the TCP or UDP listening ports, and/or

  5. Enable an external collector by sliding the toggle to Enabled.

  6. Select the external collector from the subsequent dropdown.

  7. Click Save.

Subnet Tagging Screen

The Subnet Tags screen corresponds to Create Subnet Tags in the Configuration Guide.

Subnet tagging is a way of labeling IP address ranges within ThousandEyes, in order to filter by subnets or tags in the Traffic Insights data view. One way to use this is to identify network traffic flows that are associated with IP address ranges assigned to certain user groups or departments.

For example, you can use a subnet tag of “Engineering”. Meanwhile, application recognition on your network might classify a traffic conversation as “AWS”. Then through the Traffic Insights view, you'd be able to see when a big surge of AWS traffic starts coming from Engineering.

Columns:

  • Subnet Name: A unique name provided for this subnet using + Create Subnets. Note that the name is not the same as the subnet tags, which are re-usable.

  • Subnet: The IP address range associated with this subnet for example 192.168.110.0/24.

  • Type: Subnet type is either Client or Server.

  • Tags: One or more tags assigned to this subnet.

  • Created By: The ThousandEyes user who created this subnet.

  • Created On: Date this subnet was created.

  • Modified By: ThousandEyes user who last modified this subnet.

  • Modified On: Date this subnet was last modified.

Creating Subnets

Subnet tagging configuration in Traffic Insights requires prior configuration of your IP subnets on your network. Within Traffic Insights, you can choose whether those subnets are identified by client or by server.

In case of client subnet tagging, the tag will be assigned if the client’s IP matches the IP range specified for the subnet tag, and in case of a server subnet tagging, the tag will be assigned in case that the server’s IP matches the subnet.

  • Client subnet tagging allows you to mark/tag your clients or the originating source.

  • Server subnet tagging enables you to mark the resources or targets used in your network.

Fields required for creating a subnet tag are:

  • Subnet Name: Enter a descriptive name such as “Engineering” or “guest wi-fi”.

  • Subnets: Enter one or more IP addresses or address ranges. Both IPv4 and IPv6 addressing is supported. For example, 1.1.1.1/12 or 2620:0:860:2::/64.

  • Type: Choose either Client or Server as the subnet type.

  • Choose Tags: Use + Add Tags to create new tags and associate them with this subnet. To choose one or more existing tags, click in the text box to see a pop-up searchable list with check boxes.

Managing Tags

Tags Management lists and tracks your subnet tags (labels). Each tag shows the number of subnets associated. Use the Edit subnet ellipsis on the Subnet Tagging Screen to add or remove tags from that subnet.

Traffic Insights Views Screens

Views Landing Screen

This screen is a rollup of your total network traffic by app across your entire enterprise network.

The default screen shows a stacked chart of a selection of your applications across a 24-hour period, with a new sampling point every 10 minutes. The table shows what happened in your selected time point for throughput (total, downstream, or upstream) or connections.

Filters

The Traffic Insights Views landing screen includes the following filters:

  • Traffic Monitor Locations: Refers to the location of the network devices that are sending NetFlow to a ThousandEyes Enterprise Agent. This shows the location of the forwarder it exports to by default, but you can change the location settings (country and region) by opening the edit panel for each monitor on the Traffic Monitor screen.

  • Forwarding Agents: Refers to the name of the Enterprise Agent that receives network flow data.

  • Device: Refers to the device name or IP address of the network device where your traffic monitor is hosted.

  • Interface: Refers to the interface type if it has been discovered with SNMP, otherwise it is blank. For example, “GigabitEthernet0/1/0”.

Metrics

The selected metric displays on the timeline. Throughput is displayed as bps (bits per second), Kbps (kilobits per second), Mbps (megabits per second), etc. depending on the calculated traffic rate.

  • Total Throughput: Represents the total volume of traffic.

  • Downstream Throughput: Represents the volume of downstream (server to client) traffic.

  • Upstream Throughput: Represents the volume of upstream (client to server) traffic.

  • Connections per second: Connections per second (CPS).

Timeline

The Traffic Insights view timeline works similarly to other ThousandEyes data views.

  • Use the top swimlane control to show a detailed timeline in the chart beneath up to the past 30 days.

  • Detail shows traffic flow data down to 10-minute increments.

Views Table

Below the timeline and filter areas is a detail table that changes depending on the Group By selection. Note that the data in the table is only within the 10-minute window immediately behind the pointer in the timeline. If you change the time range to 7 days, or 30 days, the table data will not change.

“Group By” Options

For the detail table below the stacked chart, a drop-down offers the following Group By options:

  • Applications: Shows volume of traffic and connections per application.

  • Conversations: Refers to a data exchange between two endpoints, occurring over one or more network connections, for example applications that use multiple channels for communication.

  • Application Path: Shows application traffic to/from tagged subnets, passing through a particular network device and interface.

  • Custom: Lets you choose what to show in the table from local (client) and remote (server) networks.

The Views screen defaults to group by applications. Note that when you choose to group by any other option, the view changes from a stacked chart to a bar chart, showing upstream and downstream simultaneously. You can view these screens in the following “Group By” sections.

Group By Applications

An application refers to a grouping or class of applications as defined in your enterprise network using application recognition or by inference of the application's public IP.

  • Application: Application identified for this traffic.

  • Total Throughput: Displayed based on the calculated traffic rate and percent of total throughput against all applications.

  • Downstream Throughput: Traffic from server to client.

  • Upstream Throughput: Traffic from client to server.

  • CPS (connections per second): Counts the rate of new TCP sessions initiated by a TCP initiation packet. If an initiation packet is not detected (for example, you are using a Meraki device or an SD-WAN solution for which this field is not included) or if the protocol is UDP, the counter is not available.

Group By Conversations

A conversation refers to the data exchange between two endpoints over one or more connections.

  • Client: Client IP address.

  • Server: Server IP address or hostname, if available.

  • Server Port: Port on which server connection was established for this client connection.

  • Server Location: Location of the server.

  • Protocol: TCP or UDP.

  • Device: Device name of the router or switch that is configured to act as the traffic monitor for Traffic Insights. This is the network device that is sending network flow traffic data to the Enterprise Agent that has been enabled as a forwarder.

  • Client Interface: Interface that the traffic monitor is collecting traffic data from.

  • Server Interface: Interface that the traffic monitor is sending traffic data to.

  • Application: If your enterprise network is configured to perform application recognition, the Application column shows which application this traffic is associated with. The application types correspond to the application recognition that you have previously configured. Additionally, if the application data isn't included in the flow record Traffic Insights attempts to infer the application based on its public IP.

  • CPS (connections per second): Counts the rate of new TCP sessions initiated by a TCP initiation packet. If an initiation packet is not detected (for example, you are using a Meraki device or an SD-WAN solution for which this field is not included) or if the protocol is UDP, the counter is not available.

  • Total Throughput: Displayed based on the calculated traffic rate and percent of upstream and downstream throughput generated by a conversation.

  • Throughput Trend: A spark line or mini-graph showing the last 30 minutes.

  • ... (ellipsis): Allows you to group existing table by application.

Group By Application Path

Application Path refers to application traffic to/from tagged subnets, passing through a particular network device and interface.

  • Client Subnet Tags: Lists all the tags that you’ve created to identify your subnets as described in Subnet Tagging Screen. The subnets themselves also need to be identified in ThousandEyes as client or server.

  • Server Subnet Tags: See above.

  • Device: Name of network device that hosts the traffic monitor.

  • Client Interface: Interface that the traffic monitor is collecting traffic data from.

  • Server Interface: Interface that the traffic monitor is sending traffic data to.

  • Application: Application identified for this traffic.

  • Clients: Number of clients.

  • Servers: Number of servers.

  • Total Throughput: Displayed based on the calculated rate of traffic and percent of total throughput against all applications.

  • CPS (connections per second): Counts the rate of new TCP sessions initiated by a TCP initiation packet. If an initiation packet is not detected (for example, you are using a Meraki device or an SD-WAN solution for which this field is not included) or if the protocol is UDP, the counter is not available.

  • ... (ellipsis): Allows you to group existing table by application.

Group By Custom Columns

Local Network

  • Client: Client IP address.

  • Device: Network device name where traffic monitor is hosted.

  • Application: Application traffic type.

  • Subnet Tag: Shows user-defined tags for client subnet.

Remote Network

  • Server: Server IP address.

  • Location: Show city and country where server is located.

  • Application: Application traffic type.

  • Subnet Tag: Shows user-defined tags for server subnet.

Alerts and Dashboards with Traffic Insights

You can configure alerts and dashboards for Traffic Insights using the same alert and dashboard components as for other ThousandEyes features.

To view which alerts metrics are specific to Traffic Insights, see Traffic Insights Alerts.

For information on getting started quickly with a dashboard for Traffic Insights, see Using the Dashboard Templates.

If you want to add Traffic Insights widgets to an existing dashboard, see Dashboard Widgets, which lists which widgets are available for Traffic Insights in its Widget Configuration Summary Table.

Add a Filter dropdown menu
Installation Type filter selections
Enterprise Agent Settings screen
Allow-listing options
Allow all traffic monitors
Allow some traffic monitors
Allow one traffic monitor
Traffic Monitors screen
Forwarders screen
External Collector Management panel
Edit forwarder panel
Subnet Tagging screen
Create Subnets panel
Tags Management panel
Views landing screen
Group By Applications screen
Group By Conversations screen
Group By Application Path screen