OpenText Performance Engineering for Developers scripts
This topic describes how to use OpenText Performance Engineering for Developers scripts in performance tests. DevWeb scripts are created using the DevWeb protocol.
DevWeb tests overview
DevWeb tests consist of one or more DevWeb scripts. The DevWeb script type focuses on communication at the HTTP transport level and over WebSocket.
You create DevWeb scripts in OpenText Performance Engineering for Developers or in OpenText VuGen. For details, see the OpenText Performance Engineering for Developers Help Center and the VuGen Help Center.
By including DevWeb scripts in your performance tests, you can run DevWeb tests side-by-side with any other tests, giving you a single entry point for running your performance tests.
Measurements can be viewed in online and offline graphs and in other analysis tools, using the data points from these tests.
Add DevWeb scripts to performance tests
This task describes how to add DevWeb scripts to performance tests.
Before you begin creating a DevWeb performance test, make sure that you have done the following:
-
Create scripts in OpenText Performance Engineering for Developers or OpenText VuGen and save them locally. The scripts must be in a compressed zip file. Otherwise they cannot be uploaded to OpenText Enterprise Performance Engineering.
-
In Windows Explorer, highlight all the scripts, right-click and, from the context menu, select Send to > Compressed (zipped) folder.
-
If you have 7-zip, you can compress files directly from command line as described below (where script files are under the "2020_features" folder, and the output zip is "3.zip"):
C:\Program Files\7-Zip>7z.exe a C:\Users\John\Downloads\2020_features\3.zip C:\Users\John\Downloads\2020_features\*
Note: The file path inside a script folder must not exceed 260 characters.
We recommend that you delete any old or unnecessary files from the scripts folder to avoid them being uploaded.
Prepare the performance test
-
Upload DevWeb scripts to OpenText Enterprise Performance Engineering
For details, see Upload a script.
Note: When uploading DevWeb scripts to OpenText Enterprise Performance Engineering, make sure that the scripts include all the relevant files, such as parameters and additional JavaScript in the runtime files.
After uploading the script, it is added to the test management tree. You can view and edit most scripts directly from within the user interface. For details, see Edit a script.
-
(Optional) Edit the script parameters
After you have uploaded a DevWeb script, you can edit its parameters. For details, see Edit script parameters.
-
Create a DevWeb test, and add one or more DevWeb scripts. For details, see Tests.
-
(Optional) Configure runtime settings
Before you run a performance test, you can view and configure the behavior of the Vuser scripts in the test using runtime settings. For details, see Configure runtime settings.
For details about the DevWeb-specific runtime settings, see the OpenText Performance Engineering for Developers Help Center.
-
Run the test
Data points from DevWeb tests are displayed in Web resources graphs in the user interface.
For details, see Web resource monitor graphs.
DevWeb script snapshots
Snapshots contain the data generated by the traffic between the client and the server, and are captured when a script is replayed. DevWeb script snapshots display all HAR data associated with a specific web request step in the script.
You can configure snapshot settings for each Vuser group that has a DevWeb script assigned to it. By default, DevWeb scripts are set to take snapshots only for errors that occurred during the replay of a script.
Change snapshot settings for a Vuser group
-
In the banner, click the module name or the arrow and select Test Management > Tests & Scripts.
-
In the test management tree, select the performance test and click Edit Test.
-
In the Groups and Workload view, for each Vuser group that has a DevWeb script assigned to it, select the Vuser group for the DevWeb script that you want to change, and click the Runtime Settings button
.
-
In the runtime settings tree, go to the General > Settings > Replay section.
-
In the Create snapshot during replay option, select an option:
-
On error. Creates snapshots only for errors that occurred during the replay of a script (the default setting).
-
Always. Always create snapshots during replay.
-
Never. Deactivates the snapshot feature.
-
View snapshots
DevWeb script snapshots display all HAR data associated with a specific web request step in the script.
To view script snapshots:
-
During a performance test run, open a test that is running with a DevWeb script, and click Vusers Details. The Vusers dialog box opens. For details, see View Vuser details.
-
Click the Snapshot button
in the Vuser dialog box to download a zip file with the HAR files.
-
Extract the files and open the HAR files in a text editor or HAR file viewer of your choice.
Known issues for DevWeb scripts
-
Rendezvous points are only displayed for scripts created in OpenText VuGen; they are not displayed for DevWeb scripts created in OpenText Performance Engineering for Developers.
-
When creating a new test with a DevWeb script using a REST API and you provide runtime setting values, the script's runtime settings for the group are used instead of those provided in the body of the REST API request. For details, see Runtime Settings XML in the REST API.
See also: