02 - Launch a functional journey analysis - Testbench

update 28 aug 2024

User journey

Instead of benchmark test, functional journey tests allow to measure a personalized user journey. For this purpose, it needs a script to describe the actions required to reproduce the journey.

A script language was designed to define the user journey to measure: GDSL for Greenspector Domain-specific language. By convention, files written in GDSL use .testgb extension.

To execute a first measure, we will use an example: sample.testgb. Please download it in your working directory.

############################################################################################
# Getting started with GDSL : a first analysis of www.gouvernement.fr                      #
############################################################################################

# Preparation #
applicationKill,com.android.chrome
browserPrepareAndOpenForReference
pause,${PAUSEAFTERLOAD}

# Blank tab reference #
measureStart,PAUSE_referenceBrowser
pause,${PAUSEDURATION}
measureStop

browserGoToUrl,https://www.gouvernement.fr/

# Loading step #
assertNotExistsText,accept all
measureStart,CHRGT_home
pressEnter
waitUntilText,accept all
pause,${PAUSEAFTERLOAD}
measureStop

# Pause step #
measureStart,PAUSE_home
pause,${PAUSEDURATION}
measureStop

This script visits the French government website and measures:

Reference empty tab
Homepage loading
Homepage idle

Initialization

The Greenspector CLI allows to launch measures on the Greenspector testbench. CLI means command-line interface: the Greenspector CLI is a command-line tool to be run in a terminal.

Windows:

gspt init ^
--greenspectorApi "https://core-saas-prod.greenspector.com/api" \
--privateToken [MYTOKEN]

Linux - MacOS:

gspt init \
--greenspectorApi "https://core-saas-prod.greenspector.com/api" \
--privateToken [MYTOKEN]

Regardless of your OS, please replace [MYTOKEN] with a personal token.

It can be found in core-saas-prod.greenspector.com:

Click on the account name in the upper right
Choose Preferences

Private token in Greenspector Core Saas

Verify Network

To verify that Greenspector testbench is reachable, simply ping it with the following command:

The following message should be received. If not, please contact support.

Application creation

All measurement iterations of Greenspector Studio are stored in core-saas-prod.greenspector.com in an application. We will create one to launch our first test.

In Applications menu, choose Add an application

Fill Name, Version of app in the pop-up. Description field is optional.

After validation, the new app should appear in the applications list:

Project configuration

We will now link Greenspector CLI with our new application:

Please replace [APPNAME] and [VERSION] with the information used in the previous section.

Test will be launched on a real device from our testbench. The model which will run the test has to be specified. Type the following command:

Enter the choice number:

For this simple test, simply use the most available device: the number 3 with Samsung - Galaxy S9 with android 10.

Launch measure

The following command will finally launch a first test:

Follow test progress

Regarding the testbench availability and iteration number, tests may take time, from 5 minutes to 3 hours. An email is sent as soon as the test finish.

If after 3 hours, you still haven’t received an email or any results, please restart or support contact.