Page History

Adding SNMP Agent Monitors

Load Test can retrieve data based on the provided OID(s) from the SNMP agents of versions 1 and 2c.

To add an SNMP agent monitor:

1. Right-click the Monitors node in the Load Test tab and choose New Monitors. A New Monitors dialog opens.
2. Select SNMP from the New Monitors dialog, then click Finish. A configuration panel for the new monitor will open in the right panel.
3. Type the SNMP agent’s host name in the Host field.
4. Type the SNMP agent’s community in the Community field.
5. Enter a parameter by clicking New. The New Parameter dialog opens.
   
6. Complete the New Parameter dialog as follows:
   • Parameter Type: Choose OID or Composite.
   • Parameter: Depending on the Parameter Type selected, the Parameter options will vary according to the following:
     • OID: Enter the Object ID that identifies a specific parameter within the SNMP agent community. (Only available if OID is selected as the Parameter Type.)
     • Composite: Choose Processor, Memory, Network, or TCP to collect corresponding data.
     • Counters: Depending on the selected Composite parameter, displays CPU Utilization (%), Memory Utilization (%), and Network Utilization (%); these counters are calculated by querying a set of OIDs.
       If TCP is selected as the Composite parameter, you must select a counter from the Counters box.
     • Parameter Explanation: Displays an explanation for the Composite parameter selected.
   • Graph Title: Enter a title for the graph that will correspond to the Monitor you are adding. This title will display in Load Test Progress graphs, and in Detailed Report graphs.
   • Apply operation: Select to apply simple operations to values returned by an SNMP agent. Use "*" for "multiply", "/" for "divide", and "%" for "percentage of". For example, if the agent returns the value of the allocated memory in bytes but you want to see it in KB, you would apply a "/ 1024" operation by selecting "/" from the menu and entering "1024" in the adjacent text field. You could then add "Memory in kilobytes" into the Graph Title field.
7. Repeat the above step until the Parameters table shows all parameters you want this SNMP agent to monitor.
8. Verify the new monitor by right-clicking the related node in the Load Tests tree’s Monitors > SNMP branch.

Adding Windows Performance Monitors

To add a Windows performance monitor (functionality which is only available if you have a Windows installation of Load Test):

1. Right-click the Load Test tab’s Monitors node, then choose New Monitors. A New Monitors dialog opens.
2. Select Windows from the New Monitors dialog, then click Finish.
3. Type the perfmon’s host name in the Host field.
4. Enter a parameter by clicking New. The Add performance counter dialog opens.
   
5. Complete the New Parameter dialog as follows:
   • Select the performance counter and instance of the parameter you want to monitor. An explanation of the parameter you select displays in the Parameter Explanation box.
   • In the Graph Title field, enter a title for the graph that will correspond to the Monitor you are adding. This title will display in Load Test Progress graphs, and in Detailed Report graphs.
   • In the Apply Operation sub-panel, select an operation and a value to be applied to the monitor data if needed. For example, by selecting the / (divide) operation and entering 1024 in the operation value field, you could convert the original monitor value from Bytes to KBytes.
6. Repeat the above step until the Parameters table shows all parameters you want this perfmon to monitor.
7. Verify the new monitor by right-clicking the related node in the Load Tests tree’s Monitors > Windows branch.

Adding WebSphere Monitors

Before adding a WebSphere monitor, go to the Security > Global security section of the WebSphere Administrative console and ensure that Enable administrative security is not enabled.

To add a WebSphere monitor:

1. Right-click the Load Test tab’s Monitors node, then choose New Monitors. A New Monitors dialog opens.
2. Select WebSphere from the New Monitors dialog, then click Finish.
3. In the Project Configuration panel, click Configure. A Configure WebSphere Agent dialog opens.
   
4. Enter the Host name, change the Port number if necessary, then click Next.
5. In the Configure WebSphere Agent panel, enter or browse to the appropriate Path of the WebSphere installation. For example: C:\IBM\WebSphere.
6. Click Next. The Configure WebSphere Agent dialog displays a table of the required Jar files for the server and indicates whether or not the appropriate Jar files were found.
   
7. In the Configure WebSphere Agent dialog, click Finish. The Add Parameter dialog opens.
   
8. Select a Parameter from the left GUI panel of the Add Parameter dialog. The Name, Description, and Value for each instance of the parameter you want to monitor displays in the right GUI panel of the Add Parameter dialog.
9. In Select column from the right GUI panel, check the parameter instances that you want to monitor, then click OK. The parameters you choose will display in Load Test Progress graphs, and in Detailed Report graphs.

Adding WildFly Monitors

Load Test WildFly monitor supports WildFly application server version 27 and higher.

To add a WildFly monitor:

1. Right-click the Load Test tab’s Monitors node, then choose New Monitors. A New Monitors dialog opens.
2. Select WildFly from the New Monitors dialog, then click Finish.
3. In the Project Configuration panel, click Configure. A Configure WildFly Agent wizard dialog opens.
   
   
4. Enter the Host and Port for your WildFly server.
5. If your WildFly server is configured to accept anonymous connections, you can leave the User and Password fields blank. If a login is required, enter the credentials in the User and Password fields.
6. Click Next.
   
   
7. Enter the path to your WildFly application server installation directory. Click Next.
   

   Note

   In order to connect to the WildFly application server, the Load Test WildFly monitor needs to load the jboss-cli-client.jar file from the WildFly installation directory. If your Load Test and WildFly installations are on different hosts, copy the jboss-cli-client.jar from the WildFly server installation to your Load Test machine and enter that directory. The wizard will look for the jboss-cli-client.jar directly under the path you specified (in case you copied the jboss-cli-client.jar from a remote installation) or under the bin\client directory if the path you specified is the actual WildFly installation.

   
8. Verify the required jar archives were found and click Finish. A progress dialog opens followed by the Add Parameter dialog.
   
   
9. Choose a parameter from the left panel. The Name, Description, and Value for each instance of the parameter you want to monitor will appear in the right panel.
10. In the right panel, enable the parameter instances that you want to monitor, then click OK.
11. The parameters you selected will be added to the Parameters table of the WildFly monitor configuration view. Double-click on a parameter to modify its Title. The Title is the name under which the parameter graph will appear in the Load Test progress view and the report. You can apply an operation to each parameter, if needed. For instance, you can multiply the SystemCpuLoad parameter by 100 to convert this value to percent.
    
    
12. Click the Properties icon in the upper-right corner of the monitor panel to see monitor properties. The User and Password values are editable (press ENTER after editing to apply your changes).
    
    

Adding Tomcat Monitors

set "JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=7744 -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.authenticate=false"

To add a Tomcat monitor:

1. Right-click the Load Test tab’s Monitors node, then choose New Monitors. A New Monitors dialog opens.
2. Select Tomcat from the New Monitors dialog, then click Finish.
3. In the Project Configuration panel, click Configure. A Configure Tomcat Agent dialog opens.
   Image RemovedImage Added
4. In the Configure Tomcat Agent dialog, enter the host name and change the port number, if necessary, then click Finish. The Add Parameter dialog opens.
   
5. Select a Parameter from the left GUI panel of the Add Parameter dialog. The Name, Description, and Value for each instance of the parameter you want to monitor displays in the right GUI panel of the Add Parameter dialog.
6. In Select column from the right GUI panel, check the parameter instances that you want to monitor, then click OK. The parameters you choose will display in Load Test Progress graphs, and in Detailed Report graphs.

Adding rstat Monitors

To add an rstat monitor:

1. Right-click the Load Test tab’s Monitors node, then choose New Monitors. A New Monitors dialog opens.
2. Select rstat from the New Monitors dialog, then click Finish.

Adding Remote JVM Monitors

To add a remote JVM Monitor:

1. Right-click the Load Tests tab and choose Monitors node, then choose New Monitors. A New Monitors dialog opens.
2. Select Remote JVM from the New Monitors dialog, then click Finish.
3. In the Project Configuration panel, click Configure. A Configure Remote JVM Agent dialog opens.
   
4. In the Configure Remote JVM Agent dialog, enter host name and change port number, if necessary, then click the Finish. The Add Parameter dialog opens.
   
5. Select a Parameter from the left GUI panel of the Add Parameter dialog. The Name, Description, and Value for each instance of the parameter you want to monitor displays in the right GUI panel of the Add Parameter dialog.
6. In Select column from the right GUI panel, check the parameter instances that you want to monitor, then click OK. The parameters you choose will display in Load Test Progress graphs and in Detailed Report graphs.

Adding Custom Monitors

Custom monitors can be implemented by JavaScript or Jython scripts, or by Java class methods. This is especially useful if you would like to collect data from sources that are not listed above.

To add a custom monitor:

1. Right-click the Load Test tab’s Monitors node, then choose New Monitors. A New Monitors dialog opens.
2. Select Custom from the New Monitors dialog, then click Finish.
3. Enter a name for the Custom monitor in the Name field.
4. Click New. An Add Channel dialog opens.
   
5. Enter a name for the channel in the Channel ID field. The name you entered for the Custom Monitor, together with the Channel ID, will comprise the title of the monitor. This title will display in Load Test Progress graphs, and in Detailed Report graphs.
6. (Optional) Enter a short description of the channel in the Description field.
7. Select a language from the Language menu.
8. Specify the script by doing one of the following:
   • Enable File and click Browse to select the appropriate file.
   • Enable Text and enter the script in the text field.
9. Specify the method you want invoked from the Method menu.
10. Click OK. The new custom channel is added to the Channels table in the right GUI panel.