Troubleshoot load issues

This topic describes how to troubleshoot TruClient load issues.

TruClient load overview

TruClient technology provides you with the ability to quickly and easily record complex business processes. However, since TruClient records at the user level and requires a browser for replay, the more complex an application's client logic, the more CPU and memory it requires to run a Vuser.

As a result, the TruClient footprint can be significantly larger than the footprints of other Vuser protocols used to run a similar business process.

Back to top

Calculate the number of load generators

Use the following method to determine the required number of load generators:

  1. Record a TruClient script.  

  2. Replay a single Vuser in Controller and check the average CPU and the peak memory consumption of the mdrv.exe process and all its descendant processes by adding a counter for % Processor Time and Private Bytes.

  3. Based on your load generator hardware and the CPU and memory consumption of a single Vuser, calculate the number of Vusers per machine.

    Example: In this example, each of the load generators has 8 core processors and 8GB of memory. A single Vuser in this example consumes 80MB of peak memory and 10% CPU on average for the specific business process.

    From a CPU perspective, if you limit the CPU consumption up to 70% utilization, you can have 7 Vusers per core processor (70% / 10%). If the load generator has a total of 8 cores processors, 8 * 7 Vusers per processor equals 56 Vusers per load generator.

    From a memory perspective, the load generator machine has 8GB memory, of which 7GB is available for the Vusers, so approximately 87 Vusers per load generator machine (7GB / 80MB).

    Therefore, to meet both the CPU and memory capacity limits, you use the lower number of Vusers and calculate that for this business process, you can run approximately 56 Vusers per load generator.

Back to top

Configure runtime settings to improve load

To improve the ability to run more Vusers, in VuGen, select Replay > Runtime Settings > General > Replay, and check the Replay using recorded duration for steps option.

Back to top

Measure the load generator performance

Use the following monitors to ensure that the load generator is not being overutilized.

Note: Overutilization of the load generator can cause inaccurate transaction response time.

Monitor Threshold
Processor\% Processor Time80%
Memory\Available Mbytes Less than 10 percent of the total physical RAM
System\Context Switches/secLess than 8K context switches/sec per core

If you do not see standard performance issues, GDI resource consumption may limit the number of Vusers you can run. As the number of Vusers increases, the GDI resources needed to display the application in a browser can reach the limit supported by the Windows Operating system per session.

You can better utilize the load generator hardware resources by connecting to the same load generator using different windows sessions. For more details, see Terminal Services Overview in VuGen in the LoadRunner Professional Help.

Back to top

Manage TruClient scalability

Use the following tips to manage TruClient scalability:

  • To support a larger number of Vusers, use high performance hardware and use more load generators.

  • Increase the ramp up time between Vusers.

    For example, minimally set the ramp up to 2 Vusers every 30 seconds.

  • Configure Controller to not initialize Vusers before they run. This will reduce the demand on the CPU and I/O during ramp up.
  • If CPU is a bottleneck, consider doing one of the following:

    • Add a longer pacing time between iterations.
    • Add wait steps of a second or two.
  • If memory is a bottleneck, run fewer Vusers.

  • If the bottleneck is not CPU or memory, it is most likely the GDI resources. Consider using LoadRunner Professional/LoadRunner Enterprise integration with Terminal Services and split Vusers among different terminal sessions.

Note: The TruClient Browser and the Chromium browser footprint is larger than for IE (or for TruClient Firefox in previous versions). Therefore, you can run fewer Vusers with the same hardware.

Back to top