Eclipse is a very popular Java development environment.
Targetted to Eclipse 3.1 and JMeter 2.1 trunk version. JMeter isn't designed to be edited and build from Eclipse IDE (JMeter uses Ant build file and complex path/jar structure with optional dependencies), so some work has to be done before we get wheels running.
NOTE: This page is very out of date
It's useful to have JMeter Eclipse project in hand, since you need to do debugging and possible bug fixing in JMeter itself.
2. Set up jmeter-trunk project
public static void initializeLogging(Properties properties) { if (logManager == null) { logManager = new LoggingManager(); } setFormat(properties); setPriority(properties.getProperty(LOG_PRIORITY, "INFO")); // Direct to system out isWriterSystemOut = true; isTargetSystemOut = true; WriterTarget wt = new WriterTarget(new OutputStreamWriter(System.out), getFormat()); Hierarchy.getDefaultHierarchy().setDefaultLogTarget(wt); setLoggingLevels(properties); // if (logManager == null) { // logManager = new LoggingManager(); // } // // setFormat(properties); // // // Set the top-level defaults // setTarget(makeWriter(properties.getProperty(LOG_FILE, "jmeter.log"), LOG_FILE)); // setPriority(properties.getProperty(LOG_PRIORITY, "INFO")); // // setLoggingLevels(properties); // // now set the individual categories (if any) // // setConfig(properties);// Further configuration } |
This Eclipse project will build your custom components and launch JMeter with a configuration which will find them classes propeply.
# JMeter uses case sensitive string matching to test these paths against absolute class path. # This is very bad since paths must be *exactly* here as they appear in Java classpath. # Hopefully this will be fixed in the future versions. Note Windows needs to escape \ character as \\. search_paths=C:\\icecom\\jmeter-2.2\\bin;. # File that holds a record of name changes for backward compatibility issues upgrade_properties=upgrade.properties # Should JMeter automatically load additional JMeter properties? # File name to look for (comment to disable) user.properties=user.properties # Should JMeter automatically load additional system properties? # File name to look for (comment to disable) system.properties=system.properties log_level.jorphan=WARN log_level.jmeter.testbeans=WARN log_level.jmeter.gui=WARN log_level.jmeter.engine.util=WARN log_level.jmeter.threads.util=WARN log_level.fi.xxx=TRACE # Widen default log output for Eclipse console log_format=%-6.6{priority} (%-10.10{thread}) [%-25.25{category}] %{message} . |
log4j.rootLogger=debug, stdout log4j.appender.stdout=org.apache.log4j.ConsoleAppender log4j.appender.stdout.layout=org.apache.log4j.PatternLayout # Pattern to output the caller's file name and line number. log4j.appender.stdout.layout.ConversionPattern=%5p [%t] (%F:%L) - %m%n |
2. Setting up a JMeter launcher
JMeter 2.x uses its internal TestBean-framework for adding new components. For more information, see Tutorial - Making a JMeter TestBean, this PDF and JMeter source code
For each component you need
An element class which interits from \[TestElement, ConfigurationElement, XXXElement\] and implements [TestBean] interface. [TestBean] interface marks classes which JMeter plug-in class loader loads automatically. \\ |
2. Each TestBean class needs BeanInfoSupport class whichs describes the properties of the element class. This class name must be MyTestElement + BeanInfo, e.g. MyTestElementBeanInfo, or the class loader doesn't find it.
3. Properties file which gives out user interface strings for properties. The name of the file must be MyTestElement + Resources.properties, e.g. MyTestElementResources.properties.
JMeter framework doesn't report about missing files, so be careful with the filenames.
Here are some examples with some dummy non-working implemenation details.
Java source fi/xxx/jmeter/sip/core/SIPReceiver
package fi.xxx.jmeter.sip.core; import org.apache.jmeter.samplers.AbstractSampler; import org.apache.jmeter.samplers.Entry; import org.apache.jmeter.samplers.SampleResult; import org.apache.jmeter.testbeans.TestBean; public class SIPReceiver extends AbstractSampler implements TestBean { public SampleResult sample(Entry e) { return null; } } |
Java source fi/xxx/jmeter/sip/core/SIPReceiverBeanInfo
package fi.xxx.jmeter.sip.core; import java.beans.PropertyDescriptor; import org.apache.jmeter.config.CSVDataSet; import org.apache.jmeter.testbeans.BeanInfoSupport; public class SIPReceiverBeanInfo extends BeanInfoSupport { public SIPReceiverBeanInfo() { super(SIPReceiver.class); createPropertyGroup("sip_receiver", new String[] { "filename", "variableNames", "delimiter" }); PropertyDescriptor p = property("filename"); p.setValue(NOT_UNDEFINED, Boolean.TRUE); p.setValue(DEFAULT, ""); p.setValue(NOT_EXPRESSION, Boolean.TRUE); p = property("variableNames"); p.setValue(NOT_UNDEFINED, Boolean.TRUE); p.setValue(DEFAULT, ""); p.setValue(NOT_EXPRESSION, Boolean.TRUE); p = property("delimiter"); p.setValue(NOT_UNDEFINED, Boolean.TRUE); p.setValue(DEFAULT, ","); p.setValue(NOT_EXPRESSION, Boolean.TRUE); } } |
Properties file fi/xxx/jmeter/sip/core/SIPreceiverResources.properties
displayName=SIP Receiver sip_receiver.displayName=Configure SIP receiver filename.displayName=Filename filename.shortDescription=Name of the file (within your supporting file directory) that holds cvs data variableNames.displayName=Variable Names (comma-delimited) variableNames.shortDescription=List your variable names in order to match the order of columns in your csv data. Separate by commas. delimiter.displayName=Delimiter (use '\\t' for tab) delimiter.shortDescription=Enter the delimiter ('\\t' for tab) |
When developing your test component, you need to modify your source code often. This leads to restarting the JMeter. JMeter launch tooks a while, killing your productivity.
If you are not developing UI related functionality, create a test plan, save it, and start JMeter from command line without GUI. Put following to your program arguments:
--nongui --testfile C:\zzz\SIPPerformanceStresser\bin\siptest.jmx
I wasted 4 hours trying to get Jorphan (Jmeter component) logging to work. Jorphan overrides log4j normal configuration mechanism, but does it badly, making usage of custom log4j settings impossible. Specifically initializeLogging always overrides previous settings with its own default settings.
2. Even after placing a correct logging file through jmeter.properties settings you get this
org.apache.avalon.framework.configuration.ConfigurationException: No log targets configured for the root logger. at org.apache.avalon.excalibur.logger.LogKitLoggerManager.setupLoggers(LogKitLoggerManager.java:531) at org.apache.avalon.excalibur.logger.LogKitLoggerManager.configure(LogKitLoggerManager.java:407) at org.apache.jorphan.logging.LoggingManager.setConfig(LoggingManager.java:148) at org.apache.jorphan.logging.LoggingManager.initializeLogging(LoggingManager.java:114) at org.apache.jmeter.util.JMeterUtils.getProperties(JMeterUtils.java:133) at org.apache.jmeter.JMeter.initializeProperties(JMeter.java:327) at org.apache.jmeter.JMeter.start(JMeter.java:242) at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source) at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source) at java.lang.reflect.Method.invoke(Unknown Source) at org.apache.jmeter.NewDriver.main(NewDriver.java:161) |
My head was already hurting so badly that I didn't want to debug the problem further. JMeter logging code could have some clean-up work.
If you get an NullPointerException about NOT_UNDEFINED property when creating your element in GUI, the BeanInfo class of your component has a wrong filename.
If widget labels are not read from resouces file, your the properties file of your component has a wrong filename