What Is BrowserBot?
Last updated
Last updated
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 Naming and Navigation Menu changes - Summary List.
ThousandEyes Virtual Appliances are shipped with both the Enterprise Agent and BrowserBot components enabled. When installing the ThousandEyes Enterprise Agent as a Linux package on a supported operating system, you have the option to install BrowserBot, by passing the -b flag to the installation script.
The BrowserBot is a component of the agent code that manages page load and transaction tests. This is accomplished through running an instance of the Chromium browser.
On the other hand, HTTP Server tests are using a custom version of cURL library under the hood and therefore do not need the BrowserBot installed.
Yes. To install the BrowserBot component on an existing Enterprise Agent that does not already have it installed, simply re-run the installation script, including your ThousandEyes Account Group token, and the -b flag:
This will install the BrowserBot and all required dependencies. The BrowserBot version information will now appear in the Enterprise Agent's General Info panel in the Network & App Synthetics > Agent Settings page, as per the image below:
When you install the BrowserBot package on an agent, it requires additional memory. Consult the Enterprise Agent hardware requirements for full details.
If you are deploying your Enterprise Agent with a Linux distribution, it is important to note that Browserbot is not compatible with Podman v5.0.0 or higher. The table below highlights the compatible Podman versions for different Browserbot versions.
BrowserBot v3.6.0 or higher
Podman v4.9.4
BrowserBot v3.5.0 or lower
Podman v4.4.4
There are two methods of determining the Chromium version used:
Pick any Page Load or Transaction test that has headers collection enabled. Open the results view, select one of the agents, switch to the Waterfall tab and click on one of the entries' Headers link:
Once there, open the Request Headers tab and search for the user-agent (or User-Agent if HTTP protocol version 1.1 was used) header:
Notice the browser version specified in the specified request header.
Once you have connected to the agent's SSH console, a simple command suggests the version of Chromium browser used under the hood. For connecting to the SSH console of appliances, we have guides available for Windows and OS X / Linux workstation operating systems.
For Ubuntu-based operating systems (including ThousandEyes Virtual Appliances), use the following command:
For RHEL/CentOS/Oracle Linux systems, use the following:
The commands above will return the name of the package installed and by naming convention that is the version of the browser installed. In the example above, the browser version is 68.0.3440.83 - the -1 suffix is not part of the browser version information - it is a package release number.
The following resources provide further information about related subjects:
What Is an Enterprise Agent? describes what a customer-deployable ThousandEyes network vantage point is.
The Enterprise Agent Hardware Requirements article contains all information about computing resource requirements for running Enterprise Agents.
How to Set Up the Virtual Appliance provides a step-by-step guide for deploying ThousandEyes agents as virtual appliances.
Enterprise Agent Deployment Using the Linux Package Method deals with Enterprise Agent installations directly onto a supported operating system.
