ThousandEyes Recorder
The ThousandEyes Recorder is a desktop application used to develop scripts for transaction tests. The Recorder includes both a Chromium web browser for recording browser-based user journeys in web applications, and an integrated development environment (IDE) for creating, validating, and enhancing the scripts generated from a recording.


To download the ThousandEyes Recorder:
  1. 1.
    In the ThousandEyes platform, go to Test Settings.
  2. 2.
    Click Add New Test.
  3. 3.
    Select the Transaction test type.
  4. 4.
    At the bottom of the new test's settings, select Install ThousandEyes Recorder on your machine to download the ThousandEyes Recorder installer for your operating system.
  5. 5.
    Follow the normal installation process for your computer's operating system. For example, the macOS version of the ThousandEyes Recorder downloads as a disk image (.dmg) file. Double-click the downloaded file. A macOS installation dialog opens. In that dialog, drag the application icon into your Applications folder.

Using the Recorder for the First Time

The first time you run the ThousandEyes Recorder, you are prompted to log in to your ThousandEyes user account. After you log in, the ThousandEyes Recorder verifies that your ThousandEyes user has the necessary permissions in your login account group to work with transaction tests. The following permissions are required:
  • Create web transaction tests
  • Edit tests
If your ThousandEyes user does not have the required permissions in your login account group, you can switch to another account group using the dropdown selector in the top-right of the window.
For more information on roles and permissions, see the Roles and Permission Table.

Recorder IDE Interface

1. Main Menu: Open a saved script from a local file, start a new script (optionally from a template), or save a script locally.
2. Recording and Playback Menu: Start recording a new transaction in the browser, or play back the current transaction script.
3. Command Palette: Insert code for sleep, markers, screenshots, and credentials.
4. Test Settings Menu: Configure ThousandEyes test settings, such as Target URL, Test Timeout, User Agent, Window Size, and more.
5. User Menu: Switch account groups or log out.
6. Export to ThousandEyes: Export the current test, including test settings, transaction script, and credentials, to the ThousandEyes platform.
7. Script Editor: Transaction tests execute custom scripts written in JavaScript, to emulate user interaction with web page elements. You can use the script editor to adjust the script directly. The IDE supports syntax highlighting and autosuggest/autocompletion.
8. Screenshots: This panel displays screenshots captured during playback. To enlarge a screenshot, click its thumbnail.
9. Console: Console output is shown here, including calls to console.log(...), and errors (if any) with stack traces.

Recording a Transaction

To record a transaction, click the Record button in the Recording and Playback menu.
The ThousandEyes Recorder prompts you for the initial target URL, and allows you to select the browser's window size.
When you click Start Recording, a Chromium browser window opens. As you interact with the pages in the browser, such as clicking links or typing text into input fields, the IDE records your actions to automatically generate the JavaScript code for the transaction script.
After you have completed the user journey in the Chromium browser, switch back to the Recorder IDE and click Stop.
The script in the script editor updates to reflect the recorded transaction.

Playing Back a Transaction

After recording a transaction, or opening an existing transaction script, you can run the script locally by clicking Play to validate it runs successfully.
When you play back a transaction script, the Chromium browser launches and executes the script. Any captured screenshots are shown in the Screenshots panel, and any errors are shown in the Console. While the transaction is playing, you can pause and resume the playback, or stop it completely.

Test Settings and Exporting

To change the transaction test's basic and advanced settings, use the Test Settings menu.
While some settings do not apply within the ThousandEyes Recorder, you may configure them here, then export the test to the ThousandEyes platform. The following settings apply only when exported to the ThousandEyes platform:
  • Test Name
  • Interval
  • Agents
  • Alerts
For more information on test settings, see Working with Test Settings.
After you have recorded a transaction, played it back to validate it works, and configured your test settings, you can export the test to the ThousandEyes platform by clicking Export to ThousandEyes. After the test has been exported, you can click View Test to open the test in the ThousandEyes platform.


The ThousandEyes Recorder syncs with credentials in the Credentials Repository, allowing you to reference stored credentials in your script without knowing their secret value. To use a credential from the credentials repository in a transaction script, first click the credentials button in the Command palette and then click the credential you would like to use.
When you record a transaction, any inputs into password-type fields are automatically converted to a local credential. You can sync local credentials to the credentials repository by clicking the synchronize icon in the credentials dialog box.
Last modified 1mo ago