This appendix provides examples for creating various types of monitors. In these examples, monitored systems are configured while configuring the monitors. You could configure the monitored systems in advance using the System Manager by selecting Systems from the Manage menu. The examples also use the Oracle Load Testing Server system as the data collector in all examples. You could configure remote data collectors to use either during configuration or in advance using the System Manager.
This example explains how to create a Windows metric profile monitor.
Select Configurations from the ServerStats menu.
Click New.
Enter a name and description for the profile and click Save.
Click New in the Monitors section.
Expand the Metric Profiles node.
Expand the Systems node and select Windows.
Click Next.
Select the system you want to monitor or click Add to add it.
Enter the name of the system and it's host name or IP address.
If the system does not have a data collector running on it, enter the domain name, username, and password for logging on to the monitored system.
Click Test to see whether Oracle Load Testing can access the system.
Click OK.
Click OK.
Click Next.
The Add Monitor: Step 3 dialog box lists components that have been previously discovered or that were manually entered in the Systems Manager.
Click Discover. The Discovery setup dialog box is displayed showing any previously configured data.
Make any changes and click OK. Oracle Load Testing goes through the discovery process to find the components available on this system. The Discovery Status dialog box is displayed.
Click OK when the message Discovery Done is displayed.
Select the components that you want to monitor and click Next.
Deselect any metrics that you do not want to use.
Click Test to verify that the results returned are the correct data values for the statistics and that no errors are returned.
Click Stop then click Close.
Click Finish. The Configurations dialog box is displayed.
Click New to add additional monitors.
Click Close to exit the Configurations dialog box.
This example explains how to create a Virtual Agent for Solaris metric profile monitor.
Note:
Plink must be installed in the datacollector\bin directory on the machine on which you are running the Data Collector. This is only required if you intend to use the SSH connection method.Select Configurations from the ServerStats menu.
Click New.
Enter a name and description for the profile and click Save.
Click New in the Monitors section.
Expand the Metric Profiles node.
Expand the Systems node and select Virtual Agent - Solaris.
Click Next.
Select the system you want to monitor or click Add to add it.
Enter the name of the system and it's host name or IP address.
If you are using telnet or Localhost, enter the remote username and password for logging on to the system.
Enter the command prompt. For the root user, the default is #. For other users that have not configured a custom prompt, the default is $.
Click Test to see whether Oracle Load Testing can access the system.
Click OK.
Click OK.
Click Next.
Click Discover. The Discovery Setup dialog box is displayed.
Click OK. Oracle Load Testing goes through the discovery process to find the components that are available on this system. The Discovery Status dialog box is displayed.
Click OK when Discovery Done is displayed.
Select the components that you want to monitor and click Next.
Deselect any metrics that you do not want to use.
Click Test to verify that the results returned are the correct data values for the statistics and that no errors are returned.
Click Stop then click Close.
Click Finish. The Configurations dialog box is displayed.
Click New to add additional monitors.
Click Close to exit the Configurations dialog box.
This example explains how to create a Virtual Agent for Linux metric profile monitor.
Note:
Plink must be installed in the datacollector\bin directory on the machine on which you are running the Data Collector. This is only required if you intend to use the SSH connection method.Select Configurations from the ServerStats menu.
Click New.
Enter a name and description for the profile and click Save.
Click New in the Monitors section.
Expand the Metric Profiles node.
Expand the Systems node and select Virtual Agent - Linux.
Click Next.
Select the system you want to monitor or click Add to add it.
Enter the name of the system and it's host name or IP address.
If you are using telmet or Localhost, enter the remote username and password for logging on to the system.
Enter the command prompt. For the root user, the default is #. For other users that have not configured a custom prompt, the default is $.
Click Test to see whether Oracle Load Testing can access the system.
Click OK.
Click OK.
Click Next.
Click Discover. The Discovery Setup Dialog Box is displayed.
Click OK. Oracle Load Testing goes through the discovery process to find the components that are available on this system. The Discovery Status dialog box is displayed.
Click OK when Discovery Done is displayed.
Select the components that you want to monitor and click Next.
Deselect any metrics that you do not want to use.
Click Test to verify that the results returned are the correct data values for the statistics and that no errors are returned.
Click Stop then click Close.
Click Finish. The Configurations dialog box is displayed.
Click New to add additional monitors.
Click Close to exit the Configurations dialog box.
This example explains how to create a Virtual Agent for AIX metric profile monitor.
Note:
Plink must be installed in the datacollector\bin directory on the machine on which you are running the Data Collector. This is only required if you intend to use the SSH connection method.Select Configurations from the ServerStats menu.
Click New.
Enter a name and description for the profile and click Save.
Click New in the Monitors section.
Expand the Metric Profiles node.
Expand the Systems node and select Virtual Agent - AIX 4.3.
Click Next.
Select the system you want to monitor or click Add to add it.
Enter the name of the system and it's host name or IP address.
Enter the remote username and password for logging on to the system.
Enter the command prompt. For the root user, the default is #. For other users that have not configured a custom prompt, the default is $.
Click Test to see whether Oracle Load Testing can access the system.
Click OK.
Click OK.
Click Next.
Click Discover. The Discovery Setup Dialog Box is displayed.
Click OK. Oracle Load Testing goes through the discovery process to find the components that are available on this system. The Discovery Status dialog box is displayed.
Click OK when Discovery Done is displayed.
Select the components you want to monitor and click Next.
Deselect any metrics that you do not want to use.
Click Test to verify that the results returned are the correct data values for the statistics and that no errors are returned.
Click Stop then click Close.
Click Finish. The Configurations dialog box is displayed.
Click New to add additional monitors.
Click Close to exit the Configurations dialog box.
This example explains how to create a Perfmon data source.
Select Tools from the ServerStats menu.
Click New.
Enter a name and description for the profile and click Save.
Click New in the Monitors section.
Expand the Data Sources node and select Perfmon (Windows Performance Monitor).
Click Next.
Select the system you want to monitor or click Add to add it.
Enter the name of the system and it's host name or IP address.
If the system you are monitoring does not have a data collector running on it, enter the domain name, username, and password for logging on to the system.
Click Test to see whether Oracle Load Testing can access the system.
Click OK.
Click OK.
Click Next. Oracle Load Testing goes through the discovery process to find the metrics available on this system.
Select the performance object you want to monitor.
Select the counters you want to monitor and click Add.
Click Test to verify that the results returned are the correct data values for the statistics and that no errors are returned.
Click Stop then click Close.
Click Finish. The Configurations dialog box is displayed.
Click New to add additional monitors.
Click Close to exit the Configurations dialog box.
This example explains how to create an Oracle Database metric profile.
Select Configurations from the ServerStats menu.
Click New.
Enter a name and description for the profile and click Save.
Click New in the Monitors section.
Expand the Metric Profiles node.
Expand the Databases node and select Oracle.
Click Next.
Select the system you want to monitor or click Add to add it.
Enter the name of the system and it's host name or IP address.
Select the type of driver you are using. The connect string is automatically generated for all types except custom.
Specify the host name.
Specify the SQL server named instance that you want to use. If nothing is specified, Oracle Load Testing uses the default instance as set up on your server. Refer to your database administrator for details.
Change the default port if necessary.
For the Inet Sprinta driver for SQL Server, provide the database name. For the Oracle Thin JDBC driver, provide the database or server ID.
Enter the remote username and password for logging on to the system.
Click Test to see whether Oracle Load Testing can access the system.
Click OK.
Click OK.
Click Next.
The Add Monitor: Step 3 dialog box lists components that have been previously discovered or that were manually entered in the Systems Manager.
Click Discover. The Discovery setup dialog box is displayed showing any previously configured data.
Make any changes and click OK. Oracle Load Testing goes through the discovery process to find the metrics available on this system. The Discovery Status dialog box is displayed.
Click OK when the message Discovery Done is displayed.
The Add Monitor Step 3 dialog box is displayed showing the discovered components.
Select the components that you want to monitor and click Next.
Deselect any metrics that you do not want to use.
Click Test to verify that the results returned are the correct data values for the statistics and that no errors are returned.
Click Stop then click Close.
Click Finish. The Configurations dialog box is displayed.
Click New to add additional monitors.
Click Close to exit the Configurations dialog box.
This example explains how to create an Oracle Enterprise Manager metric profile. To monitor an Enterprise Manager instance, you need to specify the base URL of the Enterprise manager instance as a monitored system.
To specify the URL of Enterprise Manger instance to monitor:
Select Systems from the Manage menu.
Select Monitored Systems and click New on the toolbar.
Enter a name and description for the Enterprise Manager system.
Expand the Data Sources node and select Enterprise Manager.
Enter the URL of the Enterprise Manager instance. For example:
https://em.us.oracle.com:1234/em/
The URL must refer to an Enterprise Manager instance version 11gR1 or later with all of the appropriate diagnostic packs installed. Refer to the Enterprise Manager documentation set for information on configuring the Enterprise Manager instance.
Click OK. The Oracle Load Testing ServerStats validates system availability.
Click Close to close the Systems Manager.
To configure the Enterprise Manager data source:
Select Configurations from the ServerStats menu.
Click New.
Enter a name and description for the profile and click Save.
Click New in the Monitors section.
Expand the Data Sources node and select Enterprise Manager.
Click Next.
Select the system you want to monitor (the Monitored System that specifies the base URL of the Enterprise Manager instance) or click Add to add a new system.
Click Next.
Select the Metric Type. See Section 1.8.1.3, "Adding Enterprise Manager Metrics" for additional information about prerequisites and descriptions of the parameters.
For Weblogic JVM and Weblogic Domain Metrics, enter the Target, Method Name, Request Name, and select the Thread State.
For Oracle Database Metrics, enter the Target to point to as a specific database instance.
Click Finish. The Configurations dialog box is displayed.
Click New to add additional monitors.
Click Close to exit the Configurations dialog box.
This example explains how to create a WebServer IIS metric profile.
Select Configurations from the ServerStats menu.
Click New.
Enter a name and description for the profile and click Save.
Click New in the Monitors section.
Expand the Metric Profiles node.
Expand the WebServers node and select Microsoft IIS.
Click Next.
Select the system you want to monitor or click Add to add it.
Enter the name of the system and it's host name or IP address.
Enter the remote username and password for logging on to the system.
Click Test to see whether Oracle Load Testing can access the system.
Click OK.
Click OK.
Click Next. Oracle Load Testing goes through the discovery process to find the metrics available on this system.
Deselect any metrics that you do not want to use.
Click Test to verify that the results returned are the correct data values for the statistics and that no errors are returned.
Click Stop then click Close.
Click Finish. The Configurations dialog box is displayed.
Click New to add additional monitors.
Click Close to exit the Configuration dialog box.
This example explains how to create a URL monitor for Apache Web Server.
Apache provides performance data via the Apache Server status web page. You can create a URL monitor that requests this page and parses data from it using a regular expression. The following examples shows sample data as returned from Apache:
Current Time: Monday, 08-May-2006 14:55:26 PDT Restart Time: Tuesday, 02-May-2006 10:24:02 PDT Parent Server Generation: 9 Server uptime: 6 days 4 hours 31 minutes 24 seconds Total accesses: 29000810 - Total Traffic: 693.7 GB CPU Usage: u209.367 s369.148 cu0 cs0 - .108% CPU load 54.2 requests/sec - 1.3 MB/second - 25.1 kB/request 105 requests currently being processed, 151 idle workers KKC_K_KKCK______K_K____K_______CKK_C_KKC__K__C_C____K__K__KKK_K_ KKKK________CK______K_____K____KK_K__K_K____K_K_KK___KKW___KKK__ K_C_KK__K___K_KK_WKKK___WK_C_KK_KWK___K__KCK____K__K_WK_CC____K_ ................................................................
This example shows how to retrieve requests/per second as found in row seven in the above example. You can view sample data using the URL:
http://www.apache.org/server-status?refreshed=N
Select Configurations from the ServerStats menu.
Click New.
Enter a name and description for the profile and click Save.
Click New in the Monitors section.
Expand the Data Sources node.
Select URL.
Click Next.
Click Next. Oracle Load Testing displays the Add Monitor: Step 3 dialog box.
Select Specify in the URL usage field and enter:
http://www.apache.org/server-status?refreshed=N
in the URL field.
Select Result of Perl Expression as the metric type.
Enter /([0-9]+\.[0-9]) requests\/sec/ in the Perl Expression field.
Click Test to verify that the results returned are the correct data values for the statistics and that no errors are returned.
Click Stop then click Close.
Click Finish. The Configurations dialog box is displayed.
Click New to add additional monitors.
Click Close to exist the Configurations dialog box.
This example explains how to create a JMX data source.
This example can be used for retrieving metrics from application servers offering performance counters via JMX. For example, WebLogic, WebSphere, and other supported servers.
A data collector can only monitor one type of JMX monitor at a time. To monitor more than one type of JMX monitor at the same time, you must use a separate data collector for each. All JMX monitors require some set up. Following are the broad steps followed by the specific procedures:
WebLogic 9.0
Copy configuration jar files to the data collector machines
WebSphere 6.0, 5.1, 5.0
Copy configuration jar files to the data collector machines
Update the properties file
WebSphere 6.1, 7.0
Copy configuration jar files to the data collector machines
Copy keystore/trust store files
The following are the default values for the monitored system:
Port: 8880 (default)
Username: admin (check with the JMX system administrator for changes to the username)
Password: password (check with the JMX system administrator for changes to the password)
Trust Store File: C:\keys\DummyClientTrustFile.jks
Trust Store Password: WebAS
Key Store File: C:\keys\DummyClientKeyFile.jks
Key Store Password: WebAS
WebLogic 8.0, 8.1
Copy configuration jar files to the data collector machines
Create jar files
For WebLogic 8.1, update the properties file
Before these server types can be used, the JMX agent needs one or more specific configuration jar files to be copied from the JMX server installation to the <installdir>\DataCollector\classes directory on all machines that will be used as data collectors for sampling from that server. The default <installdir> is C:\OracleATS. The file(s) can be obtained from your application server installation and copied to the appropriate directory as listed in the following table.
Note:
Versions prior to 9.20 included the version number in the directory names for the Jar files. If you are upgrading from a previous version of Oracle Application Testing Suite and have JMX monitors configured, you will need to move the Jar files to the directories specified below. If the Jar files are in the previous version locations, you may receive an error message similar to the following message:Error loading websphereXX JMX classes--check classpath setting in data collectors OSDC.properties.| Application Name | Files to Copy | Default Directory |
|---|---|---|
| Redhat JBoss 4.x | jbossall-client.jar | <installdir>\DataCollector\classes\jboss |
| Redhat JBoss 5.x | jbossall-client.jar | <installdir>\DataCollector\classes\jboss |
| Oracle WebLogic 9.0 | weblogic.jar, webservices.jar | <installdir>\DataCollector\classes\weblogic |
| Oracle WebLogic 9.1 | weblogic.jar, webservices.jar | <installdir>\DataCollector\classes\weblogic |
| Oracle WebLogic 10.x | weblogic.jar, webservices.jar | <installdir>\DataCollector\classes\weblogic |
| IBM WebSphere 6.0 | admin.jar, bootstrap.jar, bsf.jar, classloader.jar, client.jar, commons-el.jar, configmanager.jar, db2j.jar, deployutils.jar, emf.jar, ffdc.jar, filetransfer.jar, ibmcertpathprovider.jar, ibmjceprovider.jar, ibmjsse.jar, idl.jar, iwsorb.jar, j2ee.jar, jacl.jar, js.jar, jspcore.jar, jspruntime.jar, jsptranslation.jar, jspvisitor.jar, mail-impl.jar, mail.jar, management.jar, pluginconfig.jar, ras.jar, runtime.jar, runtimefw.jar, sas.jar, security.jar, soap.jar, tcljava.jar, uddi4j.jar, utils.jar, validationmgr.jar, wasjmx.jar, wasproduct.jar, wccm_base.jar, webcontainer.jar, webservices.jar, wjmxapp.jar, wlmserver.jar, workspace.jar, wsdl4j.jar, wsexception.jar, wsprofile.jar, wssec.jar | <installdir>\DataCollector\classes\weblsphere |
| IBM WebSphere 6.1, 7.0 | Both versions java\jre\lib\*.jar java\jre\lib\ext\*.jar
WebSphere 6.1 runtimes\com.ibm.ws.admin.client_6.1.0.jar plugins\com.ibm.ws.security.crypto_6.1.0.jar WebSphere 7.0 runtimes\com.ibm.ws.admin.client_7.0.0.jar plugins\com.ibm.ws.security.crypto.jar Trust Files DummyClientKeyFile.jks DummyClientTrustFile.jks |
<installdir>\DataCollector\classes\weblsphere |
To create the monitor:
Select Configurations from the ServerStats menu.
Click New.
Enter a name and description for the profile and click Save.
Click New in the Monitors section.
Expand the Data Sources node.
Select JMX.
Click Next.
Select the system you want to monitor or click Add to add it.
Enter the name of the system and it's host name or IP address.
Select the server type.
Enter the username and password if needed.
Enter Trust Store and Key Store File information if needed.
Click Test to see whether Oracle Load Testing can access the system.
Click OK.
Click OK.
Click Next. Oracle Load Testing goes through the discovery process to find the metrics available on this system.
Select the counters that you want to use and click Add.
Click Test to verify that the results returned are the correct data values for the statistics and that no errors are returned.
Click Stop then click Close.
Click Finish. The Configurations dialog box is displayed.
Click New to add additional monitors.
Click Close to exit the Configurations dialog box.
This example explains how to create a JMX metric profile.
This example can be used for applying the JMX-based application servers. Default profiles are included, however, you can create additional profiles after creating JMX metrics as described in the "Adding JMX Metrics" section of Chapter 1.
Select Configurations from the ServerStats menu.
Click New.
Enter a name and description for the profile and click Save.
Click New in the Monitors section.
Expand the Metric Profiles node.
Expand the Application Servers node and select the profile.
Click Next.
Select the system you want to monitor or click Add to add it.
Enter the name of the system and it's host name or IP address.
Click Test to see whether Oracle Load Testing can access the system.
Click OK.
Click OK.
Click Next. Oracle Load Testing goes through the discovery process to find the metrics available on this system.
Deselect any metrics that you do not want to use.
Click Test to verify that the results returned are the correct data values for the statistics and that no errors are returned.
Click Close.
Click Finish. The Configurations dialog box is displayed.
Click New to add additional monitors.
Click Close to exit the Configurations dialog box.
This example explains how to create a WebLogic Server metric profile.
SNMP must be enabled on the system you are monitoring. Also, be sure that the MIB data you plan on collecting is supported by the SNMP daemon on the monitored machine. Refer to your system administrator for more information.
Select Configurations from the ServerStats menu.
Click New.
Enter a name and description for the profile and click Save.
Click New in the Monitors section.
Expand the Metric Profiles node.
Expand the Application Servers node and select BEA WebLogic Server 5.x.
Click Next.
Select the system you want to monitor or click Add to add it.
Enter the name of the system and it's host name or IP address.
Click Test to see whether Oracle Load Testing can access the system.
Click OK.
Click OK.
Click Next. Oracle Load Testing goes through the discovery process to find the metrics available on this system.
Deselect any metrics that you do not want to use.
Click Test to verify that the results returned are the correct data values for the statistics and that no errors are returned.
Click Stop then click Close.
Click Finish. The Configurations dialog box is displayed.
Click New to add additional monitors.
Click Close to exit the Configurations dialog box.