Skip to content

Latest commit

 

History

History
69 lines (44 loc) · 2.59 KB

DEBUG.md

File metadata and controls

69 lines (44 loc) · 2.59 KB

Enable Citrix debug log

To enable the maximum level of debugging, a debugging setting must be incorporated in the log4j2 configuration file.

In the log4j2.xml file inside the JMeter bin folder, insert the following line inside the <Loggers> clause.

<Logger name = "com.blazemeter.jmeter.citrix" level = "debug" />

Alternatively it can be activated when starting JMeter indicating the log level by argument

jmeter -Lcom.blazemeter.jmeter.citrix=DEBUG

Enable thread trace on JMeter log files

In the JMeter default log configuration, it's not possible to associate each line to which virtual user generate that line. To achieve this, the thread identifier must be incorporated into the log pattern.

In the log4j2.xml file inside the JMeter bin folder. Locate and update the text inside the <pattern> tag incorporating the thread name %t and thread identifier %tid between the values %d and %p.

Example:

<File name="jmeter-log" fileName="${sys:jmeter.logfile:-jmeter.log}" append="false">
      <PatternLayout>
        <pattern>%d [%t id:%tid] %p %c{1.}: %m%n</pattern>
      </PatternLayout>
    </File>
    <GuiLogEvent name="gui-log-event">
      <PatternLayout>
        <pattern>%d [%t id:%tid] %p %c{1.}: %m%n</pattern>
      </PatternLayout>
    </GuiLogEvent>
    ...

Enable Write results to file on View Results Tree listener

The View Results Tree listener by default records all operations and show it on the graphic interface. To share the results for debugging using a JMeter Text Log (JTL) file, you must previously enable to write JTL file and set the maximum possible verbosity to ensure all data needed inside the file.

To enable JTL file saving, in the filename field provide the name of the xml file where the log information will be stored.

To ensure maximum verbosity, make sure that the configuration section contains all activated options. Go to Configure and check them all.

The default Citrix Plugin template provides a View Results Tree listener for the main playback thread group as well as one inside Citrix Recorder. If your test project does not have a View Results Tree listener, you can add one in order to allow saving a JTL file for debugging purpose.

Save JMeter console output in a log file

There are JMeter-level operations that emit debug information outside of the log4j2 logging system. In order to capture this output, the JMeter output must be redirected to a log file.

To be able to do it, you must run JMeter from command line incorporating at the end the redirection to a file

Example:

jmeter >jmeter-console.log 2>&1