The LoadRunner Request Tagging tool for DESK is a command line tool that automatically adds the relevant HTTP headers to requests generated by LoadRunner's Virtual User Generator (Web - HTTP/HTML project types). See DESK and load testing tools integration for more details on load testing integration with DESK.
The LoadRunner Request Tagging tool inserts a short method addDESKHeaderTest
in your globals.h
or globals.js
file that populates the x-desk-test
header. It also parses your .c
or .js
files and automatically adds a call to this method before one of the key LoadRunner
methods is called. Both C and JavaScript scripting languages are supported.
Key LoadRunner methods
The addDESKHeaderTest
method is called before the following methods: web_url
, web_link
, web_image
, web_submit_form
, web_submit_data
, web_custom_request
, web_browser
, web_button
, web_check_box
, web_edit_field
, web_elementweb_file
, web_image_link
, web_image_submit
, web_list
, web_map_area
, web_radio_group
, web_reg_dialog
, web_static_image
, web_table
, web_text_area
and web_text_link
.
Modify LoadRunner scripts for DESK
-
Record a LoadRunner Virtual User Generator (VUGEN) script and adapt it as needed. Refer to LoadRunner documentation for details.
-
Download the latest release of the LoadRunner Request Tagging tool for DESK
-
Patch or unpatch the LoadRunner scripts.
The LoadRunner Request Tagging tool uses the following syntax:
java -jar Dt-LoadRunner-request-tagging.jar <mode> <path parameter> <optional parameters>
Parameters
mode |
insert : Adds the DESK HTTP header to the selected LoadRunner scripts.
delete : Removes all modifications made previously by the LoadRunner Request Tagging tool.
|
path parameter |
Pick either -path or -body and -header
-path <filepath> : Use for scanning all directories and subdirectories for script files and inserting/deleting scripts into them.
-body <files> -header <files> : Use to specify if header or body files should be processed. The file separator between files is & .
|
optional parameters |
-LSN <value> : Sets the load script name to a value passed after -LSN . If skipped, the script name will be taken from the *.usr file
-c : Sets C as the scripting language (the default)
-js : Sets JavaScript as the scripting language
-help : Prints usage.
|
Examples
java -jar Dt-LoadRunner-request-tagging.jar insert -path C:\LoadRunnerScripts\EasyTravelBookingProcess
java -jar Dt-LoadRunner-request-tagging.jar delete -path C:\LoadRunnerScripts\EasyTravelBookingProcess
java -jar Dt-LoadRunner-request-tagging.jar insert -header C:\LoadRunnerScripts\EasyTravelBookingProcess\globals.h
-body C:\LoadRunnerScripts\EasyTravelBookingProcess\action.c&C:\LoadRunnerScripts\EasyTravelBookingProcess\action2.c&C:\LoadRunnerScripts\EasyTravelBookingProcess\action3.c
java -jar Dt-LoadRunner-request-tagging.jar insert -LSN "EasyTravelBookingProcessVersion2" -path C:\LoadRunnerScripts\EasyTravelBookingProcess
java -jar Dt-LoadRunner-request-tagging.jar insert -js -path C:\LoadRunnerScripts\EasyTravelBookingProcess
- Verify that the method
addDESKHeaderTest
has been added to your script
The header x-desk-test
is populated by the LoadRunner Request Tagging tool with the key/value pair listed below. These values can be captured by DESK by defining request attributes. Not all key/value pairs need to be configured; only configure the one you're interested in for targeted analysis of your load tests.
x-desk-test header key/value pairs
Key |
Description |
Value |
TSN |
Test Step Name is a logical test step within your load testing script. |
The name of the transaction defined in the LoadRunner script. In case of nested transactions, the transaction names are concatenated. |
LSN |
Load Script Name - Name of the load testing script. |
Either the name of the *.usr file or the value of the optional parameter -LSN |
LTN |
The Load Test Name uniquely identifies a test execution. |
Value of the DESKLTN runtime attribute configured in LoadRunner |
VU |
Virtual User ID of the unique user who sent the request. |
Example: 1, 2, 3, ... |
PC |
Page Context provides information about the document that is loaded in the currently processed page. |
Contains the value of the first parameter passed to following functions: web_url , web_link , web_image , web_submit_form , web_submit_data , web_custom_request . |
SI |
Source ID identifies the product that triggered the request. |
LoadRunner (fixed value) |
Here is an example of how to configure the request attribute for the test step name (TSN
):
-
In DESK, configure the extraction rules for the custom HTTP Headers via Settings > Server-side service monitoring > Request attributes.
-
Select HTTP request header as the Request attribute source and enter the name of your custom HTTP header in the Parameter name field. Extraction of the test step name TSN
from the x-desk-test
can be configured as seen below.
- Run your load test from LoadRunner. The requests and PurePaths will be tagged in DESK with the configured request attributes for targeted diagnostics and analysis.
There are different ways to analyze the data. Your approach should be based on the type of performance analysis you want to do (for example, crashes, resource and performance hotspots, or scalability issues). The request attributes set for the load test will help you filter the data. In this example, they are used to analyze the response time of the test step search journey paris:
Further reading