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:
In the ThousandEyes platform, go to Test Settings.
Click Add New Test.
Select the Transaction test type.
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.
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
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.
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.
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.
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.
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.
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.
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.
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:
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.