Skip to content

The Virtual Users Page

design-menu

The Virtual users page lets you list and create Virtual Users. It is the landing page of each project, but also accessible through a click on the left Virtual users menu.

Virtual users

A Virtual User (shortened VU) represents a user journey through your application. It lets you simulate a real user behavior.

Design

For each VU, the list displays:

  • Name,
  • Type of VU (JMeter, WebDriver or Test Fragments),
  • Description or if empty, the contents of the VU,
  • Tags of this VU,
  • Last modified date.

Virtual Users list actions

Edit VU

Several actions are available when you place your mouse over a Virtual User in the list:

Action Description
Edit Metadata Change the VU name, description and tags.
Download OctoPerf JMX Download the JMeter JMX file corresponding to this VU. Preserve OctoPerf compatibility. Keep all actions in order to reimport this JMX into another OctoPerf project. You might not be able to open it in JMeter anymore.
Download JMeter JMX Download the JMeter JMX file corresponding to this VU. Preserve JMeter compatibility. Remove all actions specific to OctoPerf in order for this JMX to work in JMeter at all cost.
Download Playwright Script files Download Playwright script files corresponding to this VU.
Duplicate Virtual User Duplicate your VU.
Copy Virtual User Copy this VU to another project. See dedicated section below.
Delete Virtual User Remove a VU. This operation cannot be reverted so proceed with caution.

Info

The search functions are detailed in this section of the navigation page.

Create Virtual User

Create VU

To create a new virtual user simply click on the Create virtual user button. You are then prompted with several options:

  • Use Sample

    This option will create a sample virtual user that tests against our demo application.

    Demo application

  • Manual creation

    Using this option you can create a virtual user from a simple website or API URL.

    Reference

  • HAR Record

    Use this option to import an HAR generated in your favorite browser/proxy.

    Reference

  • JMeter Project (JMX)

    Import an existing JMeter project.

    Reference

  • Postman Collection

    Import an existing Postman Collection.

    Reference

  • Playwright Project

    Import a Playwright script and execute a headless browser.

    Reference

  • Fragments

    Fragments VU are a special kind of virtual user that cannot be executed. Their actions are meant to be shared using Link Actions.

    Reference

Edit Virtual User

Edit VU

This screen allows you to rename your VU or change tags and description.

Info

The description can contain markdown/HTML, it can be configured with our code editor.

Copy Virtual User

This action allows you to create an exact copy of your virtual user in another project.

copy-vu

The transfer is completed once you click on the project name in the list of projects.

Because a virtual user can be related to some Files, conflicts with the remote project may happen. For example when a required file already exists in the target project. These conflicts can be handled through the copy options:

copy-vu-files

Action Description
Required We will try to assess which files are required for this VU to properly function. Note that files referenced in script actions or other dependencies may be difficult to locate.
All In case the Required option did not copy the files you expected, it is possible to ask for a complete copy of all files.
Skip This option will handle conflicts with identical file names in the target project by skipping the copy.
Overwrite This option will handle conflicts with identical file names in the target project by overwriting the destination files.

Warning

The default settings are made to be less intrusive since we will only try to copy required file with no overwrite in the remote project. Be careful because other options can lead to breaking changes in the remote project.

Remove Virtual User

Remove VU

The following procedure explains how to remove a virtual user and all of its content:

  1. Go on the design page,
  2. Place your mouse over the VU you want to remove,
  3. Click on the Delete button that appears on the far right,
  4. Click on Confirm to confirm the deletion.

Warning

Deleting a VU cannot be reverted, proceed with caution. Linked elements like variables and servers will not be removed since they could be used by other VUs.