ThousandEyes is a network intelligence SaaS platform that allows users to run a variety of tests using global vantage points to monitor DNS resolution, browser response characteristics, detailed aspects of network pathing and connectivity, the status of network routing, and VoIP streaming connection quality.
This article provides an entry exercise for new users to get up and running with ThousandEyes, and to create their first test.
This exercise requires a ThousandEyes account with basic test creation permissions. If you have a user account, but do not have the required permissions, you can reach out to your ThousandEyes admin user for assistance. If you don't have a user account, or if you are unable to add test creation permissions to your existing account, you can create a trial account here: Sign up for a ThousandEyes Trial.
The default landing page in the ThousandEyes application is the Views page. If you are a new user, the app opens an onboarding wizard to walk you through the first steps. The wizard offers a smooth path to getting started with ThousandEyes. Choose a template to start monitoring one of the applications you use.
When the wizard finishes and you see Setup completed successfully, the UI is now populated with the results of your setup.
- 1.Click through the steps of the page tour.Explore the key elements of the Views screen:
- Test selector
- Path visualization
- 2.On the Dashboards screen, click the selector and choose Service Health Dashboard TEMPLATE.
- 3.On the Alert Rules screen, check out the default
- 4.On the Test Settings screen, you'll see the results of the tests that the wizard configured for you.
The left-hand panel provides links to the key locations in the application:
- Internet Insights is our collective intelligence product, that provides visibility into core Internet infrastructure and traces the impact of macro scale Internet events to individual users and enterprise networks at their edge devices.
- Dashboards is the default landing page for the ThousandEyes application. Use widgets to build out custom dashboards to show you exactly what you want to see, to ensure you have visibility into key infrastructure areas.
For assistance, use the question mark icon on the top navigation bar to access the help menu:
The help menu includes optimized links to the product documentation, develop reference material for API support, and page tours, as well as links to contact or chat with the ThousandEyes Customer Support team.
ThousandEyes provides several different test types that can be used for monitoring different parts of your network:
Each test type produces a set of results and views based on the layers of data it interacts with. For example, an HTTP server test also includes network and routing data and views. The layers that a test type will interact with are referred to as test nests, and can be seen in the image below:
For this example, an HTTP server test is the best test to configure. Follow the steps below to create the test:
- 1.In the left hand navigation panel, go to Cloud and Enterprise Agents > Test Settings, and click Add New Test.
- 2.By default, the Layer field is set to Web, and the Test Type is set to HTTP Server. This exercise will use both these settings, so leave them as is.
- 1.Optional: Name the test. The test name should allow for easy identification / searching, and be unique where possible.
- 1.Optional: Provide a test description.This field is best used for a summary description to allow other users to quickly differentiate between similar tests.
- 3.Add vantage points.ThousandEyes vantage points are lightweight Linux-based software agents that allow users to run a variety of layered monitoring tests. These vantage points can be divided into three types:
In this exercise, we will use Cloud Agents, as they provide the least friction to getting tests up and running. Open the Agents drop-down menu to select the vantage points to use for this test.Vantage points are grouped by region, and can be searched for using the search bar, or filtered by the built-in labels on the right hand side. For this exercise, we will use the following vantage points:
- Cloud Agents are globally distributed vantage points deployed on servers maintained by ThousandEyes that all customers can use.
- Enterprise Agents are vantage points deployed locally by customers in data centers, branch offices etc.
- Endpoint Agents are vantage points deployed on end-user workstations.
- Cape Town, South Africa (Africa)
- Seoul, South Korea (Asia)
- Munich, Germany (Europe)
- Louisville, Kentucky (North America)
- Brisbane, Australia (Oceania)
- Rio de Janeiro, Brazil (South America)
- 4.For this test, we will leave the remaining settings as the default:
- The Interval drop-down menu sets the cadence for how often the test should run.
- The Alerts drop-down menu allows you to configure when the test should trigger notifications to users.
- The Advanced Settings tab provides additional configuration options for the test.
- 5.The configured test should now look something like this:To check that the test is configured correctly, you can click Run Once to run an instant test.Instant tests can be run to validate configuration or to troubleshoot issues immediately, rather than waiting for the next round of the scheduled test. The test will open in a new tab in the browser.
- 6.If you ran an instant test, close the tab and return to the test creation tab.
- 7.Click Create New Test to save the test configuration.
Now that the test is created, we can start reviewing the results as they come in.
You can navigate to the test results via one of two ways:
- From the Test Settings page, click the stack icon () beside the test type for the relevant test.
- In the left-hand navigation panel, navigate to Cloud and Enterprise Agents -> Views. Open the Current Test drop-down box in the top corner, and select the created test from the list.
The Views page provides a detailed look at a singular test, and all of the available data within it. In the top left, a drop-down menu displays the current test. In this example, only one test has been configured, so the current test will be the one configured above. When more tests have been configured, this drop-down can be used to navigate between the tests.
Beneath the drop-down menu is the main panel. On the left hand side, the various test views are listed, grouped by the appropriate layer. For this example test, the HTTP Server view is displayed, while the Network Overview, Path Visualization, and BGP Route Visualization views are also available:
- The Path Visualization view allows you to visualize the path trace data between vantage points and target locations to identify problem areas in both the private and public network infrastructure. For more information, see Using the Path Visualization View.
- The BGP Route Visualization view allows you to visualize how data is being routed across the internet, and troubleshoot issues that may be preventing packets from getting to their desired destination. See Using the BGP Route Visualization View.
On the right-hand side, the panel shows the primary view: the timeline. The timeline shows all the data collected over each test round, and updates as new test rounds complete. Sections of the timeline can be highlighted to focus on specific moments in time, allowing for deeper dives into the data to identify issues.
Beneath the main panel, the secondary panel shows additional data about the tests run by each of the agents assigned to the test, broken into a series of tabs. The HTTP Server view has two tabs in the secondary panel:
- The Map tab displays the global position of each of the vantage points used for the test.
- The Table tab provides a more detailed collection of information about each of the agents.
Both the main panel and the secondary panel will update based on data selected in the other panel. For example, selecting the Munich, Germany agent on the map will update the timeline to only show data from that agent. The agent will remain selected when navigating to the Table tab, and will be highlighted in the table, until the user clicks away from, or changes, the selection.
Now that you have a working test, and are getting a feel for navigating the product, you can start diving into the more advanced options available. In order to operationalize ThousandEyes within your environment, we recommend the following:
- Set up alerts based on your monitoring needs. Alerts can be fine-tuned based on the metrics that are important to your environment, and notifications can be sent directly through email, webhook, PagerDuty, Slack, and AppDynamics. For more information, see How Alerts Work.
- Set up reports and dashboards to display the information you need the most. Our reporting platform aggregates metrics across tests, agents, users, locations, and more, to proactively monitor your service, or to do root cause analysis of issues after they occur. For more information, see Dashboards and Reports.